跳到主要内容

电商 spu 信息更新


前置条件

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


请求地址​

https://api.e.qq.com/v1.3/spu_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
data_set_idintegerYDataNexus数据集id
skusarrayY商品SKU列表 数组最大长度 50
external_spu_idstringY您为商品SPU分配的唯一ID。 色码款商品必填。 字段长度最小 1 字节，长度最大 128 字节
external_sku_idarrayY您为商品SKU分配的唯一ID。 一般而言，是您在商品库为该商品SKU分配的id。 字段长度最小 1 字节，长度最大 128 字节
brand_namestring品牌名称。字段长度最小 1 字节，长度最大 64 字节
media_infoobject商品图片及视频信息，最大长度 10
primary_imgsobject主图图片信息列表 数组最大长度 10
img_urlstring商品主图地址；图片320*320以上，1张，正方形图片可正常打开 字段长度最小 1 字节，长度最大 2048 字节
imgsarray商品轮播图信息列表 数组最大长度 10
img_urlstring商品轮播图地址；图片320*320以上，10张，正方形图片可正常打开 字段长度最小 1 字节，长度最大 2048 字节
img_url_white_backgroundstring商品白底图地址；图片320*320以上，1张，正方形，图片可正常打开，仅产品本身、无logo、无水印、无文字、无拼接、无阴影、无模特、无衣架、无产品品牌等，每张图片中只呈现一个主体，不行呈现多个相同主体，字段长度最小 1 字节，长度最大 2048 字节
detail_imgsarray详情页图片信息列表 数组最大长度 50
img_urlstring商品详情图片地址，50张，图片可正常打开，字段长度最小 1 字节，长度最大 2048 字节
rich_text_urlstring商品富文本地址，最大长度50，url可正常打开，字段长度最小 1 字节，长度最大 2048 字节
category_infoarray类目信息，数组
category_typeinteger类目类型，1：前台类目；2：后台类目
category_level_1_idstring一级类目id
category_level_1_namestring一级类目名称
category_level_2_idstring二级类目id
category_level_2_namestring二级类目名称
category_level_3_idstring三级类目id
category_level_3_namestring三级类目名称
category_level_4_idstring四级类目id
category_level_4_namestring四级类目名称
desc_infoobject商品描述信息
product_name_chinesestring商品sku名称，字段长度最小 1 字节，长度最大 100 字节
product_propsobject商品属性
prop_infoarray商品属性信息，数组
prop_namestring属性名称，字段长度最小 1 字节，长度最大 64 字节
value_namestring属性值名称，字段长度最小 1 字节，长度最大 64 字节节
delivery_infoobject配送信息
free_typeinteger包邮条件，1：无条件；2：商品金额
freight_amountinteger发货时效，1:24 小时内发货；2:48 小时内发货；3：大于 48 小时发货
target_urlobject商品目标页信息
url_miniprogramstring微信小程序落地页 url，当落地页为微信小程序时必填 字段长度最小 1 字节，长度最大 100 字节
miniprogram_appidstring微信小程序 appid，当落地页为微信小程序时必填 字段长度最小 1 字节，长度最大 100 字节
miniprogram_usernamestring小程序原始ID，登录小程序管理后台-设置-基本设置-帐号信息中，gh_xx，当落地页为微信小程序时必填字段长度最小 1 字节，长度最大 100 字节
url_h5stringh5落地页url 字段长度最小 1 字节，长度最大 100 字节
service_infoobject商品售后信息
service_typearray售后服务类型：1：无售后服务；2：支持退换货；3：7天无理由退货 3:15天无理由退货 4:退货退货包运费 5:先用后付 6:坏损包退 7:假一赔三 8:运费险 9:全国联保 10:只换不修
certification_infoarray资质信息
certification_idstring资质id
certification_imgsarray资质图片信息
img_urlstring资质图片地址
company_namefloat公司名称
legal_person_namefloat法人名称
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": {}
}



该内容是否有帮助？