跳到主要内容

电商 sku 信息更新


前置条件

获得 数据源，并在 资产分发 打开该数据源ID 的指定应用场景的分发开关。


请求地址​

https://api.e.qq.com/v1.3/sku_info/update


所属权限​

数据上报（User Actions）


请求方法​

POST


请求参数​

参数名描述
access_token密钥信息，可在 DataNexus 的 数据源 - 【查看密钥】获取
timestamp当前的时间戳，单位为秒，允许客户端请求最大时间误差为 300 秒。MarketingAPI 所使用的时间戳，若无特殊说明，均为秒级时间戳签名算法。MarketingAPI 所使用的时区为 GMT+8，例如当时间戳为 1494840119 时，表示 2017-05-15 17:21:59
nonce随机字串标识，不超过 32 个字符，由调用方自行生成，需保证全局唯一性

请求体类型​

application/json


请求体参数​

阅读说明：Y - 必填；C - 条件选填（conditional），请关注“描述”信息；空 - 非必填

名称类型必填描述
account_idintegerY推广帐号 id或 DataNexus 账号 id
user_action_set_idintegerYDataNexus数据源id
skusarrayY商品SKU列表 数组最大长度 50
external_sku_idstringY您为商品SKU分配的唯一ID。 一般而言，是您在商品库为该商品SKU分配的id。 字段长度最小 1 字节，长度最大 128 字节
external_spu_idstring您为商品SPU分配的唯一ID。 色码款商品必填。 字段长度最小 1 字节，长度最大 128 字节
media_infoobject商品图片及视频信息，最大长度 10
prop_imgsarray商品属性图信息列表 数组最大长度 10
img_urlstring商品属性图地址；图片320*320以上，正方形图片可正常打开 字段长度最小 1 字节，长度最大 2048 字节
sales_infoobject商品销售信息
stock_totalinteger商品总库存量，当product_type=3（小样）时必填
is_availableboolean上架状态；true：上架；false：下架
sku_stock_statusinteger商品的销售状态 1：库存＞0；2：库存≤0（常见为售罄/暂无库存商品在页面底部展示，可标记为状态2）
sales_numinteger展示销量
product_typeinteger商品类型，1：普通商品；2：赠品；3：小样；4：套装商品
tag_infoobject商品的标签信息 数组最大长度 10
custom_tagarray商品的标签信息 数组最大长度 50
tag_namestring标签名称，长度最大 2048 字节
tag_valuestring[]标签值，长度最大 2048 字节
desc_infoobject商品描述信息
product_name_chinesestring商品sku名称，字段长度最小 1 字节，长度最大 100 字节
priceobject商品销售信息
current_pricefloat商品现价，单位元，保留 2 位小数
sku_pricefloat商品原价，单位元，保留 2 位小数
promotion_infoarray活动信息，数组类型
promotion_typeinteger活动类型，枚举：1. 秒杀 2. 预售 3. 限时折扣 4. 限量折扣
promotion_descriptionstring活动描述
start_timestring活动开始时间，unix毫秒级时间戳，为空表示永久
end_timestring活动结束时间，unix毫秒级时间戳，为空表示永久
product_propsobject商品属性
prop_infoarray商品属性信息，数组
prop_namestring属性名称，字段长度最小 1 字节，长度最大 64 字节
value_namestring属性值名称，字段长度最小 1 字节，长度最大 64 字节节
comment_infoobject评论信息
comment_numinteger评论数量
comment_num_typeinteger评论数量口径，1：近 30 天评论数；2：历史累计评论数
positive_comment_ratingfloat商品好评率，2位小数，不带百分号，如 99.99% 填 99.99
is_deletedinteger商家标记商品已删除；0：未删除，1：已删除，为空默认为0

请求示例​

{
  "account_id": 1111111111,
  "user_action_set_id": 1111111111,
  "data_set_id": 1111111111,
  "skus": [
    {
      "external_sku_id": "SKU_123456",
      "external_spu_id": "SPU_123456",
      "sku_barcode": "123456",
      "brand_name": "品牌名",
      "media_info": {
        "primary_imgs": {
          "img_url": "http://abcd.com/1.jpg"
        },
        "imgs": [
          {
            "img_url": "http://abcd.com/1.jpg"
          },
          {
            "img_url": "http://abcd.com/2.jpg"
          }
        ],
        "detail_imgs": [
          {
            "img_url": "http://abcd.com/1.jpg"
          },
          {
            "img_url": "http://abcd.com/2.jpg"
          }
        ],
        "videos": [
          {
            "img_url": "http://abcd.com/1.jpg",
            "video_url": "http://abcd.com/vedio1.mp4"
          },
          {
            "img_url": "http://abcd.com/2.jpg",
            "video_url": "http://abcd.com/vedio2.mp4"
          }
        ]
      },
      "category_info": [
        {
          "category_type": 2,
          "category_level_1_id": "1",
          "category_level_1_name": "一级类目名称",
          "category_level_2_id": "2",
          "category_level_2_name": "二级类目名称",
          "category_level_3_id": "3",
          "category_level_3_name": "三级类目名称"
        }
      ],
      "sales_info": {
        "is_available": true,
        "sales_num": 100
      },
      "desc_info": {
        "product_name_chinese": "商品名称"
      },
      "price": {
        "current_price": 1.2,
        "sku_price": 5.3
      },
      "target_url": {
        "url_miniprogram": "",
        "miniprogram_appid": "",
        "url_miniprogram_qq": "",
        "miniprogram_appid_qq": "",
        "url_h5": ""
      },
      "store_info": {
        "external_store_id": "12",
        "store_name": "店铺名称",
        "store_grade": 4.5
      },
      "coupon_info": [
        {
          "coupon_id": "CD-34422",
          "amount_coupon": 3.4,
          "url_list": "http://abcd.com/ciiewo23",
          "amount_minimum": 6.8,
          "show_start_time": "1607310404000",
          "show_end_time": "1607396804000",
          "start_time": "1607324804000",
          "end_time": "1607497604000",
          "is_best": 1
        }
      ],
      "comment_info": {
        "comment_num": 10000,
        "positive_comment_rating": 99.99
      },
      "third_promotion_info": {
        "commission_rate": 12.25,
        "promote_status": 1
      },
      "tag_info": {
        "custom_tag": [
          {
            "tag_name": "商品规格",
            "tag_value": ["30ml"]
          },
          {
            "tag_name": "营销卖点",
            "tag_value": ["法式浪漫甜美", "鲜活愉悦", "自信清新"]
          },
          {
            "tag_name": "适合肤质",
            "tag_value": ["适合任何肤质"]
          },
          {
            "tag_name": "原产国",
            "tag_value": ["法国"]
          }
        ]
      },
      "is_deleted": 0
    }
  ]
}

应答体结构​

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

应答示例​

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



该内容是否有帮助？