淘宝开放平台

登录
文档中心 > API类目 > 产品中心API

alibaba.global.product.merchant.product.add (品牌商提报-增加标准产品)

提报标准产品，请按照模版查询接口返回的提报模版进行提报。fieldType，name，value为必填字段。（单选填充value值，多选填充values值）。 枚举值请查看对应字段中options信息。是否必填及前置依赖请查询rules字段。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
category_id Number 必须 201274860 类目ID
brand_id Number 必须 3300940 品牌ID
schema_fields String 必须 [{"fieldType":"input","name":"条形码编码","value":6930957827556},{"fieldType":"singleCheck","name":"美容护肤/美体/精油","value":"201274860"},{"fieldType":"singleInput","name":"品牌","value":"66915"},{"fieldType":"singleInput","name":"品名","value":"测试品名"},{"fieldType":"singleCheck","name":"是否彩妆","value":"是"},{"fieldType":"singleInput","name":"色号","value":"20"},{"fieldType":"singleInput","name":"净含量","value":"20g"},{"fieldType":"singleInput","name":"化妆品备案编号/注册证号","value":"测试证号"},{"fieldType":"multiCheck","name":"功效","values":["保湿"]},{"fieldType":"singleCheck","name":"是否防晒","value":"是"},{"fieldType":"singleInput","name":"防晒指数","value":"30++"},{"fieldType":"singleInput","name":"PA值","value":"20"},{"fieldType":"singleInput","name":"产品昵称","value":"测试昵称"},{"fieldType":"singleInput","name":"系列","value":"测试系列"},{"fieldType":"multiInput","name":"产品白底图","values":["测试产品白底图"]},{"fieldType":"singleInput","name":"产品外包装成分表完整特写图","value":"测试特写图"},{"fieldType":"singleInput","name":"产品外包装条码完整特写图","value":"测试特写图"},{"fieldType":"singleInput","name":"标题","value":"测试标题"},{"fieldType":"singleInput","name":"规格","value":"测试规格"},{"fieldType":"singleInput","name":"深","value":"10"},{"fieldType":"singleInput","name":"宽","value":"10"},{"fieldType":"singleInput","name":"高","value":"10"},{"fieldType":"singleInput","name":"重量","value":"10"}] 提交的数据

响应参数

名称 类型 示例值 描述
successful Boolean false 是否成功
error_codes String PARAMS_ERROR 错误编码
model SimpleStandardProductDTO 提报结果
  • └ barcode
  • String
  • 6930957827556
  • 条码
  • └ self_barcode
  • String
  • 无
  • 自编码
  • └ title
  • String
  • 标题名
  • 标题
  • └ brand
  • String
  • 品牌名
  • 品牌名
  • └ category_name
  • String
  • 类目名
  • 类目名
  • properties
  • SimplePropertyModel []
  • 属性对集合
  • └ property_name
  • String
  • 属性名
  • 属性名
  • └ value_names
  • String []
  • 属性值
  • └ product_height
  • String
  • 10
  • 高
  • └ product_width
  • String
  • 10
  • 宽
  • └ product_deep
  • String
  • 10
  • 深
  • └ product_weight
  • String
  • 20g
  • 重量
  • └ product_image
  • String
  • 图片URL
  • 产品白底图
  • └ product_image_front
  • String
  • 图片URL
  • 正面图
  • └ product_image_back
  • String
  • 图片URL
  • 背面图
  • └ product_image_side
  • String
  • 图片URL
  • 侧面图
  • └ additional_image
  • String
  • 额外图片信息json的KV形式，V为图片URL
  • 额外图片
  • └ additional_info
  • String
  • 额外信息JSON的KV形式
  • 额外信息
error_msg String 参数错误，请按规范填写！ 错误信息

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaGlobalProductMerchantProductAddRequest req = new AlibabaGlobalProductMerchantProductAddRequest();
req.setCategoryId(201274860L);
req.setBrandId(3300940L);
req.setSchemaFields("[{\"fieldType\":\"input\",\"name\":\"条形码编码\",\"value\":6930957827556},{\"fieldType\":\"singleCheck\",\"name\":\"美容护肤/美体/精油\",\"value\":\"201274860\"},{\"fieldType\":\"singleInput\",\"name\":\"品牌\",\"value\":\"66915\"},{\"fieldType\":\"singleInput\",\"name\":\"品名\",\"value\":\"测试品名\"},{\"fieldType\":\"singleCheck\",\"name\":\"是否彩妆\",\"value\":\"是\"},{\"fieldType\":\"singleInput\",\"name\":\"色号\",\"value\":\"20\"},{\"fieldType\":\"singleInput\",\"name\":\"净含量\",\"value\":\"20g\"},{\"fieldType\":\"singleInput\",\"name\":\"化妆品备案编号/注册证号\",\"value\":\"测试证号\"},{\"fieldType\":\"multiCheck\",\"name\":\"功效\",\"values\":[\"保湿\"]},{\"fieldType\":\"singleCheck\",\"name\":\"是否防晒\",\"value\":\"是\"},{\"fieldType\":\"singleInput\",\"name\":\"防晒指数\",\"value\":\"30++\"},{\"fieldType\":\"singleInput\",\"name\":\"PA值\",\"value\":\"20\"},{\"fieldType\":\"singleInput\",\"name\":\"产品昵称\",\"value\":\"测试昵称\"},{\"fieldType\":\"singleInput\",\"name\":\"系列\",\"value\":\"测试系列\"},{\"fieldType\":\"multiInput\",\"name\":\"产品白底图\",\"values\":[\"测试产品白底图\"]},{\"fieldType\":\"singleInput\",\"name\":\"产品外包装成分表完整特写图\",\"value\":\"测试特写图\"},{\"fieldType\":\"singleInput\",\"name\":\"产品外包装条码完整特写图\",\"value\":\"测试特写图\"},{\"fieldType\":\"singleInput\",\"name\":\"标题\",\"value\":\"测试标题\"},{\"fieldType\":\"singleInput\",\"name\":\"规格\",\"value\":\"测试规格\"},{\"fieldType\":\"singleInput\",\"name\":\"深\",\"value\":\"10\"},{\"fieldType\":\"singleInput\",\"name\":\"宽\",\"value\":\"10\"},{\"fieldType\":\"singleInput\",\"name\":\"高\",\"value\":\"10\"},{\"fieldType\":\"singleInput\",\"name\":\"重量\",\"value\":\"10\"}]");
AlibabaGlobalProductMerchantProductAddResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_global_product_merchant_product_add_response>
    <successful>false</successful>
    <error_codes>PARAMS_ERROR</error_codes>
    <model>
        <barcode>6930957827556</barcode>
        <self_barcode>无</self_barcode>
        <title>标题名</title>
        <brand>品牌名</brand>
        <category_name>类目名</category_name>
        <properties>
            <simple_property_model>
                <property_name>属性名</property_name>
            </simple_property_model>
        </properties>
        <product_height>10</product_height>
        <product_width>10</product_width>
        <product_deep>10</product_deep>
        <product_weight>20g</product_weight>
        <product_image>图片URL</product_image>
        <product_image_front>图片URL</product_image_front>
        <product_image_back>图片URL</product_image_back>
        <product_image_side>图片URL</product_image_side>
        <additional_image>额外图片信息json的KV形式，V为图片URL</additional_image>
        <additional_info>额外信息JSON的KV形式</additional_info>
    </model>
    <error_msg>参数错误，请按规范填写！</error_msg>
</alibaba_global_product_merchant_product_add_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>

错误码解释

错误码 错误描述 解决方案

API工具

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

如何获得此API

FAQ

我要提问
返回
顶部