dangdang.item.update

修改商品​

  • 此接口用于商家单个商品更新。

    不允许修改“商品标识符”,其他值都允许被修改。支持只修改部分信息,若参数值为空字符串,做删除该属性操作;未提交的参数,则不做该属性的任何修改操作

    支持的数据格式:XML

    HTTP请求方式:POST

    版本:3.0

  • 系统级输入参数:

    请参考系统级输入参数

    应用级输入参数:

    参数名称
    参数类型
    是否必填
    示例值
    参数说明
    gShopID Number 489 店铺ID。
    item_id Number 1012284020 商品ID。
    out_id String xxnn1234 商家商品外部编码。不可以重复。字符串,最多可输入50个字符。
    bar_code String 3123123bar 条形码。数字或者字母,最多可输入40个字符。
    item_name String 这是商品名称 商品名称。最多可输入100个字符。
    item_sub_name String 这是副标题 副标题。最多可输入100个字符。
    item_category_id Number 1805 商品主分类。当当标准商品分类的最底级分类编号。
    item_sub_category_ids Number 18061807 商品从属分类。当当标准商品分类的最底级分类编号。多值用,分隔。
    shop_category_ids String 10231024 店内分类。多值用,分隔。
    stock Number 12 库存。取值范围:0-999999。
    market_price Number 100.11 市场价。以元为单位。取值范围:0-9999999.99。
    sale_price Number 80.99 当当价。以元为单位。取值范围:0-9999999.99。
    purchase_price Price 60 进货价。以元为单位。取值范围:0-9999999.99。
    is_cod Number 1 是否支持COD。取值:1,支持;0,不支持。
    is_shop_vip Number 1 是否支持店铺VIP。取值:1,支持;0,不支持。
    status Number 0 商品状态。取值:0,上架;6,下架。
    postage Number 0 运费模板ID。默认0(店铺运费)。
    volume Number 10 商品体积。单位:立方米。
    weight Number 10 商品重量。单位:千克。
    standard_attribs String 性别:女性,质地:牛皮 商品标准属性。如果商品所属分类的准属性为必填类型,那么属性必须填写。
    column_descs String 10001|4999,10002|5001 栏目化描述。格式:栏目ID|顺序号。多值用,分隔。
    best_partners String 1012284024|1,1012284025|6 最佳拍档。格式:拍档ID|顺序号。多值用,分隔。
    item_descs.editor_recomm String 这是编辑推荐 详情,编辑推荐。字符串,最多可输入10万个字符。
    item_descs.content_recomm String 这是内容推荐 详情,内容推荐。字符串,最多可输入10万个字符。
    item_descs.catalog String 这是目录 详情,目录。字符串,最多可输入10万个字符。
    item_descs.digest String 这是精彩书摘 详情,精彩书摘。字符串,最多可输入10万个字符。
    item_descs.author_intro String 这是作者简介 详情,作者简介。字符串,最多可输入10万个字符。
    item_descs.preface String 这是前言 详情,前言。
    item_descs.media_comment String 这是媒体评论 详情,媒体评论。字符串,最多可输入10万个字符。
    item_descs.illustration String <img src = /> 详情,书摘与插画。字符串,最多可输入10万个字符。
    category_attribs.isbn String 21231123123 类目属性,isbn。字符串,最多可输入25个字符。
    category_attribs.author String [美]埃克尔 类目属性,作者。字符串,最多可输入40个字符。
    category_attribs.editor String 小编 类目属性,编者。字符串,最多可输入20个字符。
    category_attribs.translator String 小译 类目属性,译者。字符串,最多可输入20个字符。
    category_attribs.painter String 小绘 类目属性,绘者。字符串,最多可输入20个字符。
    category_attribs.publisher String 机械工业出版社 类目属性,出版社。字符串,最多可输入50个字符。
    category_attribs.version Number 4 类目属性,版次。大于零的整数。
    category_attribs.print_copy Number 10 类目属性,印次。大于零的整数。
    category_attribs.words_num Number 9996 类目属性,字数。大于零的整数。
    category_attribs.pages_num Number 999 类目属性,页数。大于零的整数。
    category_attribs.copies_num Number 9 类目属性,册数。大于零的整数。
    category_attribs. print_paper String 5.9 类目属性,印张。大于零的小数。
    category_attribs.size String 16开 类目属性,开本。取值:128开;108开;96开;64开;60开;50开;48开;44开;42开;40开;36开;大32开;32开;28开;25开;20开;18开;大16开;16开;12开;10开;8开;6开;4开;3开。
    category_attribs. paper_quality String 胶版纸 类目属性,用纸。取值:胶版纸;轻型纸;纯质纸;铜版纸;凸版纸;宣纸;字典纸;字帖纸

    ;书写纸;艺术纸;画报纸;涂布纸;特种纸


    category_attribs.binding String 平装 类目属性,包装。取值:平装;精装;盒装;袋装;线装;挂图;软精装;组合包装。
    category_attribs.language String 中文(简体) 类目属性,语种。取值:中文(简体);中文(繁体);英语;俄语;法语;西班牙语;日语;韩语;德语;蒙古语;中英双语;其它(含多语)。
    category_attribs.present String 光盘 类目属性,附赠。取值:光盘;磁带;光盘/磁带;其它。
    category_attribs.present_num Number 3 类目属性,附赠数量。大于零的整数。
    category_attribs.cbl_category String 32313123 类目属性,中图法分类号。字符串,最多可输入20个字符。
    category_attribs.original_book_mame String 这是原版书名 类目属性,原版书名。字符串,最多可输入50个字符。
    category_attribs.main_book_name String 这是主书名 类目属性,主书名。字符串,最多可输入50个字符。
    category_attribs.is_suit String 1 类目属性,是否套装。取值:1,是;0,否。
    category_attribs.is_pinyin String 1 类目属性,是否注音。取值:1,是;0,否。
    category_attribs.publish_date Date 39234 类目属性,出版时间。格式:yyyy-mm-dd。
    category_attribs.print_date Date 39600 类目属性,印刷时间。格式:yyyy-mm-dd。
    item_descs.desc String 详情 详情。字符串,最多可输入10万个字符。

  • XML数据格式:

    01 <?xml version="1.0" encoding="GBK" standalone="yes"?>
    02 <response>
    03 <functionId>item-update</functionId>
    04 <result>true</result>
    05 <resultCode>0</resultCode>
    06 <resultMessage>业务处理成功.</resultMessage>
    07 <time>2014-12-30 18:37:34</time>
    08 <item>   
    09     <item_id>1012284020</item_id>
    10     <out_id>outid123</item out id>
    11     <item_name>这是商品名称</item_name>
    12 </item>
    13 </response>

    JSON数据格式:

    01 {
    02     "response": {
    03         "functionId""item-update",
    04         "result"true,
    05         "resultCode": 0,
    06         "resultMessage""业务处理成功.",
    07         "time""2015-01-07 10:52:55",
    08         "item": {
    09             "item_id": 1012284020
    10             "out_id""outid123"
    11             "item_name""这是商品名称",
    12         }
    13     }
    14 }

  • java版

    SdkClient sdkClient=new SdkClient(appKey, appSecret, session, version) ;
    PublicationItemUpdateRequest request=new PublicationItemUpdateRequest();
    PublicationItemAddOrUpdate itemAddOrUpdate=new PublicationItemAddOrUpdate();
    itemAddOrUpdate.setGShopID(1234);

    PublicationItemCategoryAttribs attribs=new PublicationItemCategoryAttribs();
    attribs.setIsbn("12344");

    PublicationItemDesc itemDesc =new PublicationItemDesc();
    itemDesc.setDesc("1234");
    request.setAddOrUpdateReq(itemAddOrUpdate);
    request.setCategoryAttribs(attribs);
    request.setItemDesc(itemDesc);
    PublicationItemAddOrUpdateResponse response=sdkClient.excute(request);
    System.out.println(response.toString());


    php版

    $sdkClient = new DDHttpClient(appKey,appSecret,session)
    $PublicationItemUpdateRequest = new PublicationItemUpdateRequest();
    $PublicationItemUpdateRequest->setItemId("1131211824");
    $PublicationItemUpdateItemDescsDto = new PublicationItemUpdateItemDescsDto();
    $PublicationItemUpdateItemDescsDto->catalog="
    这是目录";
    $PublicationItemUpdateCategoryAttribsDto = new PublicationItemUpdateCategoryAttribsDto();
    $PublicationItemUpdateCategoryAttribsDto->isbn="9787535447340";
    $PublicationItemUpdateRequest->setPublicationItemUpdateCategoryAttribsDto($PublicationItemUpdateCategoryAttribsDto);
    $PublicationItemUpdateRequest->setPublicationItemUpdateItemDescsDto($PublicationItemUpdateItemDescsDto);
    $sdkResponse = $sdkClient->execute($PublicationItemUpdateRequest);