电商 spu 信息添加
请求地址
https://api.e.qq.com/v3.0/spu_info/add
所属权限
数据上报（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_id | integer | Y | 推广帐号 id或 DataNexus 账号 id |
| user_action_set_id | integer | Y | DataNexus数据源id |
| data_set_id | integer | Y | DataNexus数据集id |
| skus | array | Y | 商品SKU列表 数组最大长度 50 |
| external_spu_id | string | Y | 您为商品SPU分配的唯一ID。 色码款商品必填。 字段长度最小 1 字节，长度最大 128 字节 |
| external_sku_id | array | Y | 您为商品SKU分配的唯一ID。 一般而言，是您在商品库为该商品SKU分配的id。 字段长度最小 1 字节，长度最大 128 字节 |
| brand_name | string | 品牌名称。字段长度最小 1 字节，长度最大 64 字节 | |
| media_info | object | Y | 商品图片及视频信息，最大长度 10 |
| primary_imgs | object | Y | 主图图片信息列表 数组最大长度 10 |
| img_url | string | Y | 商品主图地址；图片320*320以上，1张，正方形图片可正常打开 字段长度最小 1 字节，长度最大 2048 字节 |
| imgs | array | Y | 商品轮播图信息列表 数组最大长度 10 |
| img_url | string | Y | 商品轮播图地址；图片320*320以上，10张，正方形图片可正常打开 字段长度最小 1 字节，长度最大 2048 字节 |
| img_url_white_background | string | Y | 商品白底图地址；图片320*320以上，1张，正方形，图片可正常打开，仅产品本身、无logo、无水印、无文字、无拼接、无阴影、无模特、无衣架、无产品品牌等，每张图片中只呈现一个主体，不行呈现多个相同主体，字段长度最小 1 字节，长度最大 2048 字节 |
| detail_imgs | array | 详情页图片信息列表 数组最大长度 50 | |
| img_url | string | 商品详情图片地址，50张，图片可正常打开，字段长度最小 1 字节，长度最大 2048 字节 | |
| rich_text_url | string | 商品富文本地址，最大长度50，url可正常打开，字段长度最小 1 字节，长度最大 2048 字节 | |
| category_info | array | Y | 类目信息，数组 |
| category_type | integer | Y | 类目类型，1：前台类目；2：后台类目 |
| category_level_1_id | string | Y | 一级类目id |
| category_level_1_name | string | Y | 一级类目名称 |
| category_level_2_id | string | Y | 二级类目id |
| category_level_2_name | string | Y | 二级类目名称 |
| category_level_3_id | string | Y | 三级类目id |
| category_level_3_name | string | Y | 三级类目名称 |
| category_level_4_id | string | 四级类目id | |
| category_level_4_name | string | 四级类目名称 | |
| desc_info | object | Y | 商品描述信息 |
| product_name_chinese | string | Y | 商品sku名称，字段长度最小 1 字节，长度最大 100 字节 |
| product_props | object | 商品属性 | |
| prop_info | array | 商品属性信息，数组 | |
| prop_name | string | 属性名称，字段长度最小 1 字节，长度最大 64 字节 | |
| value_name | string | 属性值名称，字段长度最小 1 字节，长度最大 64 字节节 | |
| delivery_info | object | 配送信息 | |
| free_type | integer | 包邮条件，1：无条件；2：商品金额 | |
| freight_amount | integer | 发货时效，1:24 小时内发货；2:48 小时内发货；3：大于 48 小时发货 | |
| target_url | object | 商品目标页信息 | |
| url_miniprogram | string | C | 微信小程序落地页 url，当落地页为微信小程序时必填 字段长度最小 1 字节，长度最大 100 字节 |
| miniprogram_appid | string | C | 微信小程序 appid，当落地页为微信小程序时必填 字段长度最小 1 字节，长度最大 100 字节 |
| miniprogram_username | string | C | 小程序原始ID，登录小程序管理后台-设置-基本设置-帐号信息中，gh_xx，当落地页为微信小程序时必填字段长度最小 1 字节，长度最大 100 字节 |
| url_h5 | string | C | h5落地页url 字段长度最小 1 字节，长度最大 100 字节 |
| service_info | object | 商品售后信息 | |
| service_type | array | 售后服务类型：1：无售后服务；2：支持退换货；3：7天无理由退货 3:15天无理由退货 4:退货退货包运费 5:先用后付 6:坏损包退 7:假一赔三 8:运费险 9:全国联保 10:只换不修 | |
| certification_info | array | 资质信息 | |
| certification_id | string | 资质id | |
| certification_imgs | array | 资质图片信息 | |
| img_url | string | 资质图片地址 | |
| company_name | float | 公司名称 | |
| legal_person_name | float | 法人名称 | |
| is_deleted | integer | 商家标记商品已删除；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
}
]
}
应答体结构
| 名称 | 类型 | 是否一定返回 | 描述 |
|---|---|---|---|
| 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": {}
}
该内容是否有帮助？