商品SKU添加/变更[多店]

前置条件

请在 DataNexus -<数据接入>-<数据源>中新建数据源，参考新建数据源。并在数据源中选择或新建数据集，参考新建数据集。

请求地址

https://api.e.qq.com/v1.1/sku/add

请求方法

POST

请求参数

参数名	描述
access_token	授权令牌，完成 OAuth 2.0 授权后获得，参考开发者账号及环境
timestamp	当前的时间戳，单位为秒，允许客户端请求最大时间误差为 300 秒。MarketingAPI 所使用的时间戳，若无特殊说明，均为秒级时间戳签名算法。MarketingAPI 所使用的时区为 GMT+8，例如当时间戳为 1494840119 时，表示 2017-05-15 17:21:59
nonce	随机字串标识，不超过 32 个字符，由调用方自行生成，需保证全局唯一性

请求体类型

application/json

请求体参数

名称	类型	必填	描述
dataSourceId	string	Y	数据源id（create方法返回的data.dataSource.id）
skus	array	Y	商品SKU列表数组最大长度 50
external_sku_id	string	Y	您为商品 sku 分配的唯一ID。一般而言，是您在商品库为该商品SKU分配的id。字段长度最小 1 字节，长度最大 128 字节
poly_sku_id	string		商品的 sku 聚合id，供推荐、搜索场景使用。字段长度最小 1 字节，长度最大 128 字节
gdt_sku_id	string		腾讯广告商品的 skuid。字段长度最小 1 字节，长度最大 128 字节
external_spu_id	string		您为商品 spu 分配的唯一ID。色码款商品必填。字段长度最小 1 字节，长度最大 128 字节
sku_barcode	string		商品条形码，超市商品必填。字段长度最小 1 字节，长度最大 64 字节
seo_id	string[]		商品可被搜索的编码
brand_name	string		品牌名称。字段长度最小 1 字节，长度最大 64 字节
seller_info	object		商品的卖家信息，供平台类商家填写自己的卖家信息
seller_id	string		商品卖家 id，由平台类商家自己生成
seller_name_chinese	string		平台类商家的子卖家中文名称
seller_name_english	string		平台类商家的子卖家英文名称
img_urls	array	Y	商品图片url列表数组最大长度 10
primary_imgs	array	Y	主图图片信息列表数组最大长度 10
img_url	string	Y	商品主图地址，1张；图片320*320以上，正方形图片可正常打开字段长度最小 1 字节，长度最大 2048 字节
imgs	array	Y	商品轮播图信息列表数组最大长度 10
img_url	string	Y	商品轮播图地址；图片320*320以上，正方形图片可正常打开字段长度最小 1 字节，长度最大 2048 字节
prop_imgs	array		商品属性图信息列表数组最大长度 10
img_url	string		商品属性图地址；图片320*320以上，正方形图片可正常打开字段长度最小 1 字节，长度最大 2048 字节
detail_imgs	array		详情页图片信息列表数组最大长度 50
img_url	string		商品详情图片地址，50张，图片可正常打开，字段长度最小 1 字节，长度最大 2048 字节
rich_text_url	string		商品富文本地址，最大长度50，url可正常打开，字段长度最小 1 字节，长度最大 2048 字节
videos	array		商品视频信息，数组最大长度 10
video_url	string		视频地址；字段长度最小 1 字节，长度最大 2048 字节
img_url	string		视频封面图片地址，1张，字段长度最小 1 字节，长度最大 2048 字节
product_props	object		商品属性
color	object		商品颜色属性
color_rgb	string		颜色RGB编码字段长度最小 1 字节，长度最大 64 字节
color_name	string		颜色名称，如黄色字段长度最小 1 字节，长度最大 64 字节
prop_info	array		商品属性信息，数组
prop_id	integer		属性ID，字段长度最小 1 字节，长度最大 64 字节
prop_name	string		属性名称，字段长度最小 1 字节，长度最大 64 字节
value_id	integer		属性值ID，字段长度最小 1 字节，长度最大 64 字节节
value_name	string		属性值名称，字段长度最小 1 字节，长度最大 64 字节节
category_props	array		类目属性
external_category_id_leaf	string		您为商品分配的叶子类目 id。字段长度最小 1 字节，长度最大 255 字节
category_type	integer		类目类型；1：前端类目； 2：后台类目
sales_props	object	Y	商品销售属性
is_available	boolean	Y	上架状态；true：上架；false：下架
desc_props	object	Y	商品描述属性
product_name_chinese	string	Y	商品中文名字段长度最小 1 字节，长度最大 100 字节
product_name_english	string		商品英文名字段长度最小 1 字节，长度最大 1000 字节
product_desc	string		商品描述，字段长度最小 1 字节，长度最大 1000 字节
seo_desc	string[]		商品SEO词，搜索中的扩展词包
tag_info	object		商品的标签信息数组最大长度 10
custom_tag	array		商品的标签信息数组最大长度 50
tag_name	string		标签名称，长度最大 2048 字节
tag_value	string[]		标签值，长度最大 2048 字节
service_info	object		商品售后信息
service_type	integer		售后服务类型：1：无售后服务；2：支持退换货
comment_info	object		评论信息
comment_num	integer		商品评论数
positive_comment_rating	float		商品好评率，2位小数，不带百分号，如 99.99% 填 99.99
usage_info	array		商品使用情况
inner_appid	integer		商品的特殊应用场景。为空：商品将应用到您在有数数据管理后台绑定的全部场景；11：有数；16：直跳；19：广告CPS；20：搜一搜品牌专区；21：云选联盟；22：商品广告；例如：商家开通了场景16、19，如果不填，则所有商品应用到场景16、19；如果填了16，则改商品仅应用到场景16
external_created_time	string	Y	客户侧的商品创建时间，unix时间戳，字段长度为 13 字节
is_deleted	integer		商家标记商品 sku 信息已删除，0：未删除；1：已删除，为空默认为 0

请求示例

{
  "account_id": 1111111111,
  "data_source_id": 1111111111,
  "data_set_id": 1111111111,
  "skus": [
    {
      "external_sku_id": "681JJ7250200G2402",
      "external_spu_id": "681JJ7250200G24",
      "sku_barcode": "6941078344853",
      "img_urls": [
        {
          "primary_imgs": [
            {
              "img_url": "https://image.xxx.cn/product_images/F7FC91EA33A7B465CE3B918759113446.JPG"
            },
            {
              "img_url": "https://image.xxx.cn/17dbc058bf3040a29bb856986afa7329.JPG"
            }
          ],
          "imgs": [
            {
              "img_url": "https://image.xxx.cn/product_images/F7FC91EA33A7B465CE3B918759113446.JPG"
            },
            {
              "img_url": "https://image.xxx.cn/17dbc058bf3040a29bb856986afa7329.JPG"
            }
          ],
          "detail_imgs": [
            {
              "img_url": "https://image.xxx.cn/product_images/A13C8006A6F114989F26767E57EAD1C4.JPG"
            },
            {
              "img_url": "https://image.xxx.cn/product_images/B14426FBBFE76A90E3114B47B0A80200.JPG"
            },
            {
              "img_url": "https://image.xxx.cn/product_images/ECB0F6435C1AD05D5AC4EF3ADFCE7964.JPG"
            },
            {
              "img_url": "https://image.xxx.cn/product_images/F99624BA21FDEA9D2CBB6D88801CD251.JPG"
            }
          ]
        }
      ],
      "product_props": {
        "color": {
          "color_rgb": "#FFB6C1",
          "color_name": "粉红"
        },
        "is_o2o": false,
        "size": "M"
      },
      "sales_props": {
        "is_available": false
      },
      "desc_props": {
        "product_name_chinese": "纯棉中腰直筒牛仔长裤"
      },
      "external_created_time": "1572395131732",
      "tag_info": {
        "custom_tag": [
          {
            "tag_name": "商品规格",
            "tag_value": ["30ml"]
          },
          {
            "tag_name": "营销卖点",
            "tag_value": ["法式浪漫甜美", "鲜活愉悦", "自信清新"]
          },
          {
            "tag_name": "适合肤质",
            "tag_value": ["适合任何肤质"]
          },
          {
            "tag_name": "原产国",
            "tag_value": ["法国"]
          }
        ]
      }
    }
  ]
}

应答字段

名称	类型	是否一定返回	描述
code	integer	Y	返回码，等于0表示成功，不等于0表示错误，具体见文档附录
message	string	Y	错误描述，code不等于0时，message为错误描述
message_cn	string		中文错误描述，code不等于0时，message_cn为错误情况的中文描述
data	object		资源数据，具体返回内容见各接口定义，只在code等于0时可能返回
errors	object		详细错误信息，只在code不等于0时可能返回

应答示例

{
    "retcode": 0,
    "errmsg": "",
    "data": {}
}

请求地址​

请求方法​

请求参数​

请求体类型​

请求体参数​

请求示例​

应答字段​

应答示例​

请求地址

请求方法

请求参数

请求体类型

请求体参数

请求示例

应答字段

应答示例