商品 SKU 添加/变更（多店版）

开发之前请创建有数数据仓库 （dataSourceId），可将 dataSourceId 理解为数据的集合。创建一个数据仓库后，所有接口传输数据时都可重复使用。

请求地址

域名/data-api/v1/sku/add

请求方法

POST

请求参数

参数名	样例	描述
app_id	abc	分配的app_id
nonce	61794670f155b	随机字符串
sign	sha256	签名算法
timestamp	1569232087	请求时间戳（秒级）
signature	aee30792812d7b09ba7d3aa67c24e16c6a7ea81282ac728ad5966dd1b3eef6d5	签名结果

请求体参数

名称	类型	必填	描述
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 字节
video_props	object		视频类商品属性
genre	string		视频的分类，如爱情，字段长度最小 1 字节，长度最大 64 字节
duration	integer		视频时长，单位秒，字段长度最小 1 字节，长度最大 64 字
director	string		导演姓名，字段长度最小 1 字节，长度最大 64 字
star	string		主演姓名，字段长度最小 1 字节，长度最大 64 字节
release_date	string		上线时间，字段长度最小 1 字节，长度最大 64 字节
rating	float		评分，字段长度最小 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 字节
promotion_info	array		活动信息，数组
promotion_id	string		活动id 字段长度最小 1 字节，长度最大 100 字节
promotion_name	string		活动名称 字段长度最小 1 字节，长度最大 2048 字节
promotion_type	integer		活动类型，1：满减；2：秒杀；3：超市百货；4：品牌促销；5：新人专享；6：大促活动；7：精选推荐；8：每日热榜；9：高佣专区；10；历史低价；11：30天热榜；21：活动会场页
promotion_description	string		促销描述字段长度最大 100 字节
url_list	string		活动地址
start_time	string		活动生效开始时间，unix毫秒级时间戳，为空表示永久
end_time	string		活动生效结束时间，unix毫秒级时间戳，为空表示永久
show_start_time	string		活动展示开始时间，unix毫秒级时间戳，为空表示永久
show_end_time	string		活动展示结束时间，unix毫秒级时间戳，为空表示永久
is_best	integer		是否最优活动，1：是；0：否
service_info	object		商品售后信息
service_type	integer		售后服务类型：1：无售后服务；2：支持退换货；3：7天无理由退货 3:15天无理由退货 4:退货包运费 5:先用后付 6:坏损包退 7:假一赔三 8:运费险 9:全国联保 10:只换不修 11:退货包运费
comment_info	object		评论信息
comment_num	integer		商品评论数
comment_num_type	integer		评论口径，1：近 30 天评论数；2：历史累计评论数
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

请求体类型

application/json

请求示例

{
    "dataSourceId": "105",
    "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": ["法国"]
                    }
                ]
            }
        }
    ]
}

应答字段

名称	类型	描述
retcode	integer	返回码
errmsg	string	错误信息
data	json object	响应内容

应答示例

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