dangdang.items.publiccolumns.set

设置商品公用栏目

  • 功能描述:批量设置商品的公用栏目。

    支持的数据格式:XML

    HTTP请求方式:POST

    版本:2.0

  • 系统级输入参数:

    请参考系统级输入参数

    应用级输入参数:


    变量名称 变量命名 变量类型 是否必填 示例 说明

    多个商品的公用栏目XML文件

    multiItemsPublicColumns

    file

    <input type=file..

    多个商品的公用栏目XML文件,具体内容请

    参考“多个商品的公用栏目XML文件格式说明”


     

    多个商品的公用栏目XML文件格式说明:


    变量名称 变量命名 变量类型 是否必填 示例 说明

    商品标志符

    itemID

    string

    SHOPID_00001

    商品标志符

    公用栏目

    publicColumnsList

    string

    栏目名称A>>1;

    栏目名称B>>5001;

    栏目名称C>>6700

    格式为:“栏目名称A>>显示顺序A;

    栏目名称B>>显示顺序B;

    栏目名称C>>显示顺序C”,以半角分号区隔。


     

    说明:

    1、当重新设置了<PublicColumnList>,将会覆盖之前的设置;

    最多3个栏目,可以少于3个栏目。其中的“栏目名称”必须是已有的公用栏目名称,“显示顺序”请填写0-9999之间的整数,多个栏目的显示顺序不允许重复,“商品说明”的显示顺序默认是5000。

     

  • 多个商品的公用栏目XML文件示例:

    <?xml version="1.0" encoding="GBK"?>

    <request>

     <functionID>dangdang.items.publiccolumns.set</functionID>

     <time>2009-03-20 15:10:50</time>

     <ItemsList>

      <ItemUpadteInfo>

       < itemID>40056780123</ itemID>

    <publicColumnList>栏目名称A>>1;栏目名称B>>5001;栏目名称C>>6700</publicColumnList>

      </ItemUpadteInfo>

      <ItemUpadteInfo>

       ......

      </ItemUpadteInfo>

     </ItemsList>

    </request>

  • 商家接收到的XML文件格式说明:

  • 商家接收到的XML文件实例:

    <?xml version="1.0" encoding="GBK" ?>

    <response>

     <functionID>dangdang.items.publiccolumns.set</functionID>

     <time>2009-05-20 16:39:57</time>

     <ItemsIDList>

      <itemIDInfo>

       <itemID>400306498</itemID>

       <operCode>0</operCode>

       <operation>操作成功</operation>

      </itemIDInfo>

      <itemIDInfo>

      ……

      </itemIDInfo>

     </ItemsIDList>

    </response>


  • java版

    SdkClient sdk= new SdkClient(appKey, appSecret, session, version) ;
    ItemsPublicColumnsSetRequest request=new ItemsPublicColumnsSetRequest();
    request.setMultiItemsPublicColumnsFile(new FileItem(new File(path)));
    ItemsPublicColumnsSetResponse response=sdk.excute(request);
    System.out.println(response.toString());



    php版
    $sdkClient = new DDHttpClient(appKey,appSecret,session)
    $itemsPubliccolumnsSetRequest = new ItemsPubliccolumnsSetRequest();
    $itemsPubliccolumnsSetRequest->setMultiItemsPublicColumns($xmlFile);
    $sdkResponse = $sdkClient->execute($itemsPubliccolumnsSetRequest);