dangdang.items.bestpartners.set

设置商品最佳拍档

  • 功能描述:批量设置商品的最佳拍档。

    支持的数据格式:XML

    HTTP请求方式:POST

    版本:2.0

  • 系统级输入参数:

    请参考系统级输入参数

    应用级输入参数:


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

    多个商品的最佳拍档XML文件

    multiItemsBestPartners

    file

    <input type=file..

    多个商品的最佳拍档XML文件,具体内容请参考

    “多个商品的最佳拍档XML文件格式说明”


     

    多个商品的最佳拍档XML文件格式说明:


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

    企业商品标志符

    outerItemID

    string

    SHOPID_00001

    企业商品标志符

    最佳拍档

    bestPartnerList

    string

    123;456;789

    普通商品、产品都可以设置此项。产品下的分色分码商品不可以设置此项。
    内容格式为:“商品编号1;商品编号2;商品编号3”,以半角分号区隔。


     

    说明:

    1、当重新设置了<bestPartnerList>,将会覆盖之前的拍档商品;

    “拍档商品的商品ID”对应的商品不能是产品下的分色分码商品;

    依照设置时的商品顺序,在单品页中从左到右展示;

    拍档数量不能多于3个。

  • 多个商品的最佳拍档XML文件示例:

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

    <request>

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

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

     <ItemsList>

      <ItemUpadteInfo>

       <outerItemID>40056780123</outerItemID>

    <bestPartnerList>79847693;79847655;79847676</bestPartnerList>

      </ItemUpadteInfo>

      <ItemUpadteInfo>

       ......

      </ItemUpadteInfo>

     </ItemsList>

    </request>

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

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

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

    <response>

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

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

     <ItemsIDList>

      <itemIDInfo>

       <outerItemID>400306498</outerItemID>

       <operCode>0</operCode>

       <operation>操作成功</operation>

      </itemIDInfo>

      <itemIDInfo>

      ……

      </itemIDInfo>

     </ItemsIDList>

    </response>


  • java版

    SdkClient sdkClient= new SdkClient(appKey, appSecret, session, version) ;
    ItemsBestPartnersSetRequest request=new ItemsBestPartnersSetRequest();
    request.setMultiItemsBestPartnersFile(new FileItem(new File(path)));
    ItemsBestPartnersSetResponse result=sdkClient.excute(request);
    System.out.println(result.toString());


    php版
    $sdkClient = new DDHttpClient(appKey,appSecret,session)
    $itemsBestpartnersSetRequest = new ItemsBestpartnersSetRequest();
    $itemsBestpartnersSetRequest->setMultiItemsBestPartners($xmlFile);
    $sdkResponse = $sdkClient->execute($itemsBestpartnersSetRequest);