淘宝开放平台

登录
文档中心 > API类目 > 国际站商品API

国际站商品API

alibaba.icbu.product.update (修改商品)

修改国际站商品，支持询盘商品和在线批发商品，支持英文商品和多语言商品

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
attributes ProductAttribute [] 可选
  • 最大列表长度：100
    		•  商品属性和属性值
    • └ attribute_id
    • Number
    • 可选
    • 123
    • 属性ID
    • └ attribute_name
    • String
    • 可选
    • color
    • 属性名称
    • └ value_id
    • Number
    • 可选
    • 456
    • 属性值ID
    • └ value_name
    • String
    • 可选
    • grey
    • 属性值名称
    • └ sku_custom_image_url
    • String
    • 可选
    • http://g01.s.alicdn.com/kf/HTB1tNhsIFXXXXb2XXXXq6xXFXXX9/200042360/HTB1tNhsIFXXXXb2XXXXq6xXFXXX9.jpg
    • 作为sku属性值时，用图形来展示；必须是alibaba图片中心的图片URL，请使用API alibaba.icbu.photobank.upload 上传图片
    • └ sku_custom_value_name
    • String
    • 可选
    • light grey
    • 作为sku属性值时，自定义属性值名称
    bulk_discount_prices BulkDiscountPrice [] 可选
  • 最大列表长度：20
    		•  根据数量设置的折扣价
    • └ price
    • String
    • 可选
    • 12.34
    • 价格，范围是0.01-9999999.00
    • └ start_quantity
    • Number
    • 可选
    • 100
    • 起始数量，范围是1-99999
    category_id Number 必须 123 类目ID
    description String 可选 Enjoy your sports and music at the same time,very convenient
  • 最大长度：60000
    		•  商品详情描述，可包含图片中心的图片URL
    extra_context Json 可选 补充信息
    group_id Number 可选 456 分组ID
    keywords String [] 必须 ["mp3","player"]
  • 最大列表长度：20
    		•  关键词，不要包含特殊符号（如,;），最多三个
    language String 必须 ENGLISH 语种，参见FAQ 语种枚举值
    main_image MainImage 必须 商品主图
    • └ images
    • String []
    • 必须
    • ["http://g03.s.alicdn.com/kf/HTB1PYE9IpXXXXbsXVXXq6xXFXXXg/200042360/HTB1PYE9IpXXXXbsXVXXq6xXFXXXg.jpg","http://g01.s.alicdn.com/kf/HTB1tNhsIFXXXXb2XXXXq6xXFXXX9/200042360/HTB1tNhsIFXXXXb2XXXXq6xXFXXX9.jpg"]
    • alibaba图片中心的图片URL列表，请使用alibaba.icbu.photobank.upload接口上传图片
    • └ watermark
    • Boolean
    • 可选
    • true
    • 是否打水印，是(true)或否(false)
    • └ watermark_frame
    • String
    • 可选
    • N
    • 水印是否有边框，有边框(Y)或者无边框(N)
    • └ watermark_position
    • String
    • 可选
    • center
    • 水印位置，在中间(center)或者在底部(bottom)
    product_sku ProductSku 可选 商品SKU定义
    • attributes
    • ProductAttribute []
    • 可选
    • 商品属性和属性值
    • └ attribute_id
    • Number
    • 可选
    • 123
    • 属性ID
    • └ sku_custom_image_url
    • String
    • 可选
    • http://g03.s.alicdn.com/kf/HTB1PYE9IpXXXXbsXVXXq6xXFXXXg/200042360/HTB1PYE9IpXXXXbsXVXXq6xXFXXXg.jpg
    • 作为sku属性值时，用图形来显示；必须是alibaba图片中心的图片URL，请使用alibaba.icbu.photobank.upload上传图片
    • └ sku_custom_value_name
    • String
    • 可选
    • light grey
    • 作为sku属性值时，自定义属性值名称
    • └ value_id
    • Number
    • 可选
    • 456
    • 属性值ID，自定义属性值时ID要小于0，并且不能重复
    • └ value_name
    • String
    • 可选
    • grey
    • 属性值名称
    • └ attribute_name
    • String
    • 可选
    • color
    • 属性名称
    • exclude_skus
    • SkuDetail []
    • 可选
    • 单个SKU详细定义
    • attributes
    • ProductAttribute []
    • 可选
    • 商品属性和属性值
    • └ attribute_id
    • Number
    • 可选
    • 123
    • 属性ID
    • └ value_id
    • Number
    • 可选
    • 456
    • 属性值ID，自定义属性值时ID要小于0，并且不能重复
    • └ sku_custom_value_name
    • String
    • 可选
    • light grey
    • 作为sku属性值时，自定义属性值名称
    • └ sku_custom_image_url
    • String
    • 可选
    • http://g01.s.alicdn.com/kf/HTB1tNhsIFXXXXb2XXXXq6xXFXXX9/200042360/HTB1tNhsIFXXXXb2XXXXq6xXFXXX9.jpg
    • 作为sku属性值时，用图形来展示；必须是alibaba图片中心的图片URL，请使用API alibaba.icbu.photobank.upload 上传图片
    • └ value_name
    • String
    • 可选
    • grey
    • 属性值名称
    • └ attribute_name
    • String
    • 可选
    • color
    • 属性名称
    • └ price
    • String
    • 可选
    • 12.34
    • 价格，单位是美元，精确到小数点后两位，范围是0.01-9999999.00
    • special_skus
    • SkuDetail []
    • 可选
    • 单个SKU详细定义
    • attributes
    • ProductAttribute []
    • 可选
    • 商品属性和属性值
    • └ attribute_id
    • Number
    • 可选
    • 123
    • 属性ID
    • └ value_id
    • Number
    • 可选
    • 456
    • 属性值ID，自定义属性值时ID要小于0，并且不能重复
    • └ sku_custom_value_name
    • String
    • 可选
    • light grey
    • 作为sku属性值时，自定义属性值名称
    • └ sku_custom_image_url
    • String
    • 可选
    • http://g01.s.alicdn.com/kf/HTB1tNhsIFXXXXb2XXXXq6xXFXXX9/200042360/HTB1tNhsIFXXXXb2XXXXq6xXFXXX9.jpg
    • 作为sku属性值时，用图形来展示；必须是alibaba图片中心的图片URL，请使用API alibaba.icbu.photobank.upload 上传图片
    • └ value_name
    • String
    • 可选
    • grey
    • 属性值名称
    • └ attribute_name
    • String
    • 可选
    • color
    • 属性名称
    • └ price
    • String
    • 可选
    • 12.34
    • 价格，单位是美元，精确到小数点后两位，范围是0.01-9999999.00
    product_type String 必须 wholesale 商品类型，在线批发商品(wholesale)或者询盘商品(sourcing)
    sourcing_trade SourcingTrade 可选 询盘商品交易信息
    • └ delivery_port
    • String
    • 可选
    • Shanghai
    • 发货港口
    • └ delivery_time
    • String
    • 可选
    • within 3 days
    • 发货期限
    • └ fob_currency
    • String
    • 可选
    • USD
    • FOB价格货币，参见FAQ 货币枚举值
    • └ fob_max_price
    • String
    • 可选
    • 56.78
    • FOB最大价格
    • └ fob_min_price
    • String
    • 可选
    • 12.34
    • FOB最小价格
    • └ fob_unit_type
    • String
    • 可选
    • Piece
    • FOB计量单位，参见FAQ 计量单位枚举值
    • └ min_order_quantity
    • String
    • 可选
    • 3.11
    • 最小起订量
    • └ min_order_unit_type
    • String
    • 可选
    • Piece
    • 最小起订量计量单位，参见FAQ 计量单位枚举值
    • └ payment_methods
    • String []
    • 可选
    • ["T/T","L/C"]
    • 付款方式，参见FAQ 付款方式枚举值
    • └ supply_period_type
    • String
    • 可选
    • Week
    • 供货能力周期，参见FAQ 时间周期枚举值
    • └ supply_quantity
    • String
    • 可选
    • 10000.66
    • 供货能力
    • └ supply_unit_type
    • String
    • 可选
    • Piece
    • 供货能力计量单位，参见FAQ 计量单位枚举值
    • └ packaging_desc
    • String
    • 可选
    • packaging
    • 包装信息
    • deliver_periods
    • DeliverPeriod []
    • 可选
    • 发货周期
    • └ process_period
    • Number
    • 可选
    • 1
    • 预计需要发货时间
    • └ quantity
    • Number
    • 可选
    • 10
    • 数量
    subject String 必须 mp3 player 商品名称，最多128个字符
    wholesale_trade WholesaleTrade 可选 在线批发商品交易信息
    • └ batch_number
    • Number
    • 可选
    • 12
    • 每批数量，当sale_type=batch时生效，范围是1-99999
    • └ handling_time
    • Number
    • 可选
    • 3
    • 备货期，单位是天，范围是1-60
    • └ min_order_quantity
    • Number
    • 可选
    • 100
    • 最小起订量，范围是1-99999
    • └ package_size
    • String
    • 可选
    • 2X3X4
    • 尺寸，单位是厘米，长宽高范围是1-9999999
    • └ price
    • String
    • 可选
    • 12.34
    • 价格，单位是美元，精确到小数点后两位，范围是0.01-9999999.00
    • └ sale_type
    • String
    • 可选
    • batch
    • 销售方式，按件卖(normal)或者按批卖(batch)
    • └ shipping_line_template_id
    • Number
    • 可选
    • 123
    • 运费模板ID
    • └ unit_type
    • String
    • 可选
    • Piece
    • 最小计量单位，参见FAQ 计量单位枚举值
    • └ volume
    • Number
    • 可选
    • 1234
    • 体积，单位是立方厘米，范围是1-9999999
    • └ weight
    • String
    • 可选
    • 123.456
    • 重量，单位是kg，精确到小数点后三位，范围是0.01-9999999.000
    • deliver_periods
    • DeliverPeriod []
    • 可选
    • 发货周期(新版本，建议使用)
    • └ process_period
    • Number
    • 可选
    • 1
    • 预计需要发货时间
    • └ quantity
    • Number
    • 可选
    • 10
    • 数量
    market String 可选 onesite
  • 默认值：main
    		•  发布的市场，支持main/onesite，默认main发到主市场，填onesite发布为商机通产品
    is_smart_edit Boolean 可选 false 智能编辑，不填写使用原来的。注意必须和详情的格式一致
    custom_info CustomInfo 可选 定制信息
    • custom_contents
    • CustomContent []
    • 可选
    • 定制内容
    • └ min_order_quantity
    • Number
    • 可选
    • 10
    • 最小起订量
    • └ custom_type
    • String
    • 可选
    • Logo
    • 定制类型
    product_id String 必须 6edvniewvnewovn 混淆商品ID

    响应参数

    名称 类型 示例值 描述
    product_id String 62wert43twrtw4 加密后的产品ID

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaIcbuProductUpdateRequest req = new AlibabaIcbuProductUpdateRequest();
List<AlibabaIcbuProductUpdateRequest.ProductAttribute> list2 = new ArrayList<AlibabaIcbuProductUpdateRequest.ProductAttribute>();
AlibabaIcbuProductUpdateRequest.ProductAttribute obj3 = new AlibabaIcbuProductUpdateRequest.ProductAttribute();
list2.add(obj3);
obj3.setAttributeId(123L);
obj3.setAttributeName("color");
obj3.setValueId(456L);
obj3.setValueName("grey");
obj3.setSkuCustomImageUrl("http://g01.s.alicdn.com/kf/HTB1tNhsIFXXXXb2XXXXq6xXFXXX9/200042360/HTB1tNhsIFXXXXb2XXXXq6xXFXXX9.jpg");
obj3.setSkuCustomValueName("light grey");
req.setAttributes(list2);
List<AlibabaIcbuProductUpdateRequest.BulkDiscountPrice> list5 = new ArrayList<AlibabaIcbuProductUpdateRequest.BulkDiscountPrice>();
AlibabaIcbuProductUpdateRequest.BulkDiscountPrice obj6 = new AlibabaIcbuProductUpdateRequest.BulkDiscountPrice();
list5.add(obj6);
obj6.setPrice("12.34");
obj6.setStartQuantity(100L);
req.setBulkDiscountPrices(list5);
req.setCategoryId(123L);
req.setDescription("Enjoy your sports and music at the same time,very convenient");
req.setExtraContextString("");
req.setGroupId(456L);
req.setKeywords(""mp3","player"");
req.setLanguage("ENGLISH");
AlibabaIcbuProductUpdateRequest.MainImage obj7 = new AlibabaIcbuProductUpdateRequest.MainImage();
obj7.setImages(""http://g03.s.alicdn.com/kf/HTB1PYE9IpXXXXbsXVXXq6xXFXXXg/200042360/HTB1PYE9IpXXXXbsXVXXq6xXFXXXg.jpg","http://g01.s.alicdn.com/kf/HTB1tNhsIFXXXXb2XXXXq6xXFXXX9/200042360/HTB1tNhsIFXXXXb2XXXXq6xXFXXX9.jpg"");
obj7.setWatermark(true);
obj7.setWatermarkFrame("N");
obj7.setWatermarkPosition("center");
req.setMainImage(obj7);
AlibabaIcbuProductUpdateRequest.ProductSku obj8 = new AlibabaIcbuProductUpdateRequest.ProductSku();
List<AlibabaIcbuProductUpdateRequest.ProductAttribute> list10 = new ArrayList<AlibabaIcbuProductUpdateRequest.ProductAttribute>();
AlibabaIcbuProductUpdateRequest.ProductAttribute obj11 = new AlibabaIcbuProductUpdateRequest.ProductAttribute();
list10.add(obj11);
obj11.setAttributeId(123L);
obj11.setSkuCustomImageUrl("http://g03.s.alicdn.com/kf/HTB1PYE9IpXXXXbsXVXXq6xXFXXXg/200042360/HTB1PYE9IpXXXXbsXVXXq6xXFXXXg.jpg");
obj11.setSkuCustomValueName("light grey");
obj11.setValueId(456L);
obj11.setValueName("grey");
obj11.setAttributeName("color");
obj8.setAttributes(list10);
List<AlibabaIcbuProductUpdateRequest.SkuDetail> list13 = new ArrayList<AlibabaIcbuProductUpdateRequest.SkuDetail>();
AlibabaIcbuProductUpdateRequest.SkuDetail obj14 = new AlibabaIcbuProductUpdateRequest.SkuDetail();
list13.add(obj14);
List<AlibabaIcbuProductUpdateRequest.ProductAttribute> list17 = new ArrayList<AlibabaIcbuProductUpdateRequest.ProductAttribute>();
AlibabaIcbuProductUpdateRequest.ProductAttribute obj18 = new AlibabaIcbuProductUpdateRequest.ProductAttribute();
list17.add(obj18);
obj18.setAttributeId(123L);
obj18.setValueId(456L);
obj18.setSkuCustomValueName("light grey");
obj18.setSkuCustomImageUrl("http://g01.s.alicdn.com/kf/HTB1tNhsIFXXXXb2XXXXq6xXFXXX9/200042360/HTB1tNhsIFXXXXb2XXXXq6xXFXXX9.jpg");
obj18.setValueName("grey");
obj18.setAttributeName("color");
list15.setAttributes(list17);
obj14.setPrice("12.34");
obj8.setExcludeSkus(list13);
List<AlibabaIcbuProductUpdateRequest.SkuDetail> list20 = new ArrayList<AlibabaIcbuProductUpdateRequest.SkuDetail>();
AlibabaIcbuProductUpdateRequest.SkuDetail obj21 = new AlibabaIcbuProductUpdateRequest.SkuDetail();
list20.add(obj21);
List<AlibabaIcbuProductUpdateRequest.ProductAttribute> list24 = new ArrayList<AlibabaIcbuProductUpdateRequest.ProductAttribute>();
AlibabaIcbuProductUpdateRequest.ProductAttribute obj25 = new AlibabaIcbuProductUpdateRequest.ProductAttribute();
list24.add(obj25);
obj25.setAttributeId(123L);
obj25.setValueId(456L);
obj25.setSkuCustomValueName("light grey");
obj25.setSkuCustomImageUrl("http://g01.s.alicdn.com/kf/HTB1tNhsIFXXXXb2XXXXq6xXFXXX9/200042360/HTB1tNhsIFXXXXb2XXXXq6xXFXXX9.jpg");
obj25.setValueName("grey");
obj25.setAttributeName("color");
list22.setAttributes(list24);
obj21.setPrice("12.34");
obj8.setSpecialSkus(list20);
req.setProductSku(obj8);
req.setProductType("wholesale");
AlibabaIcbuProductUpdateRequest.SourcingTrade obj26 = new AlibabaIcbuProductUpdateRequest.SourcingTrade();
obj26.setDeliveryPort("Shanghai");
obj26.setDeliveryTime("within 3 days");
obj26.setFobCurrency("USD");
obj26.setFobMaxPrice("56.78");
obj26.setFobMinPrice("12.34");
obj26.setFobUnitType("Piece");
obj26.setMinOrderQuantity("3.11");
obj26.setMinOrderUnitType("Piece");
obj26.setPaymentMethods(""T/T","L/C"");
obj26.setSupplyPeriodType("Week");
obj26.setSupplyQuantity("10000.66");
obj26.setSupplyUnitType("Piece");
obj26.setPackagingDesc("packaging");
List<AlibabaIcbuProductUpdateRequest.DeliverPeriod> list28 = new ArrayList<AlibabaIcbuProductUpdateRequest.DeliverPeriod>();
AlibabaIcbuProductUpdateRequest.DeliverPeriod obj29 = new AlibabaIcbuProductUpdateRequest.DeliverPeriod();
list28.add(obj29);
obj29.setProcessPeriod(1L);
obj29.setQuantity(10L);
obj26.setDeliverPeriods(list28);
req.setSourcingTrade(obj26);
req.setSubject("mp3 player");
AlibabaIcbuProductUpdateRequest.WholesaleTrade obj30 = new AlibabaIcbuProductUpdateRequest.WholesaleTrade();
obj30.setBatchNumber(12L);
obj30.setHandlingTime(3L);
obj30.setMinOrderQuantity(100L);
obj30.setPackageSize("2X3X4");
obj30.setPrice("12.34");
obj30.setSaleType("batch");
obj30.setShippingLineTemplateId(123L);
obj30.setUnitType("Piece");
obj30.setVolume(1234L);
obj30.setWeight("123.456");
List<AlibabaIcbuProductUpdateRequest.DeliverPeriod> list32 = new ArrayList<AlibabaIcbuProductUpdateRequest.DeliverPeriod>();
AlibabaIcbuProductUpdateRequest.DeliverPeriod obj33 = new AlibabaIcbuProductUpdateRequest.DeliverPeriod();
list32.add(obj33);
obj33.setProcessPeriod(1L);
obj33.setQuantity(10L);
obj30.setDeliverPeriods(list32);
req.setWholesaleTrade(obj30);
req.setMarket("onesite");
req.setIsSmartEdit(false);
AlibabaIcbuProductUpdateRequest.CustomInfo obj34 = new AlibabaIcbuProductUpdateRequest.CustomInfo();
List<AlibabaIcbuProductUpdateRequest.CustomContent> list36 = new ArrayList<AlibabaIcbuProductUpdateRequest.CustomContent>();
AlibabaIcbuProductUpdateRequest.CustomContent obj37 = new AlibabaIcbuProductUpdateRequest.CustomContent();
list36.add(obj37);
obj37.setMinOrderQuantity(10L);
obj37.setCustomType("Logo");
obj34.setCustomContents(list36);
req.setCustomInfo(obj34);
req.setProductId("6edvniewvnewovn");
AlibabaIcbuProductUpdateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <alibaba_icbu_product_update_response>
    <product_id>62wert43twrtw4</product_id>
</alibaba_icbu_product_update_response>

    异常示例

    • XML示例
    • JSON示例
    <error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

    错误码解释

    错误码 错误描述 解决方案
    isp.product.not.exist 商品不存在 请检查商品ID
    isp.product.cannot.update 商品不能修改 商品处于一些状态（如审核中）时，不能编辑

    API工具

    API测试工具 错误码查询工具 SDK下载

    如何获得此API

    FAQ

    我要提问
    返回
    顶部