添加商品SKU

请求地址

product_skus/add

请求方法

POST

请求参数

名称	类型	描述
account_id 必填	integer	推广帐号 id ，有操作权限的帐号 id，包括代理商和广告主帐号id
data_warehouse_id 必填	integer	数据仓库ID
skus 必填	struct[]	商品SKU列表数组最大长度 50
external_sku_id 必填	string	您为商品SKU分配的唯一ID。一般而言，是您在商品库为该商品SKU分配的id。字段长度最小 1 字节，长度最大 128 字节
external_spu_id	string	您为商品SPU分配的唯一ID。一般而言，是您在商品库为该商品SPU分配的id。字段长度最小 1 字节，长度最大 128 字节
sku_barcode	string	商品条形码字段长度最小 1 字节，长度最大 64 字节
img_urls	struct[]	商品图片url列表数组最大长度 10
imgs	struct[]	图片信息列表数组最大长度 10
img_url	string	商品图片地址图片300*300以上图片可正常打开字段长度最小 1 字节，长度最大 2048 字节
width	integer	图片宽度，大于300px
height	integer	图片长度，大于300px
img_desc	string	图片描述字段长度最小 1 字节，长度最大 100 字节
primary_imgs 必填	struct[]	主图图片信息列表数组最大长度 10
img_url 必填	string	商品主图地址图片300*300以上，1张，正方形图片可正常打开字段长度最小 1 字节，长度最大 2048 字节
width	integer	图片宽度，大于300px
height	integer	图片长度，大于300px
img_desc	string	图片描述字段长度最小 1 字节，长度最大 100 字节
detail_imgs	struct[]	详情页图片信息列表数组最大长度 10
img_url	string	商品详情图片地址，图片300*300以上图片可正常打开字段长度最小 1 字节，长度最大 2048 字节
width	integer	图片宽度，大于300px
height	integer	图片长度，大于300px
img_desc	string	图片描述字段长度最小 1 字节，长度最大 100 字节
product_props	struct	商品属性
color	struct	商品颜色属性
color_rgb	string	颜色RGB编码字段长度最小 1 字节，长度最大 64 字节
color_name	string	颜色名称，如黄色字段长度最小 1 字节，长度最大 64 字节
is_o2o	boolean	true：线上线下同款；false：线上线下不同款
size	string	商品尺码字段长度最小 1 字节，长度最大 8 字节
sales_props	struct	商品销售属性
is_available 必填	boolean	上架状态 true：上架；false：下架
desc_props 必填	struct	商品描述属性
product_name_chinese 必填	string	商品中文名字段长度最小 1 字节，长度最大 100 字节
commission_props	string[]	字符串列表类型数组最大长度 50
external_created_time 必填	string	客户侧的商品创建时间字段长度最小 18 字节，长度最大 20 字节
external_last_modified_time 必填	string	客户侧的商品更新时间字段长度最小 18 字节，长度最大 20 字节

请求示例

curl 'https://api.e.qq.com/v1.1/product_skus/add?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-H 'Content-Type: application/json' \
-d 'account_id="<ACCOUNT_ID>"' \
-d 'data_warehouse_id=101' \
-d 'skus=[
    {
        "external_sku_id": "testSKU",
        "external_spu_id": "testSPU",
        "sku_barcode": "testSKUBarcode",
        "img_urls": [
            {
                "imgs": [
                    {
                        "img_url": "",
                        "width": 320,
                        "height": 300,
                        "img_desc": "图片说明"
                    }
                ],
                "primary_imgs": [
                    {
                        "img_url": "",
                        "width": 1000,
                        "height": 600,
                        "img_desc": "主图1"
                    }
                ],
                "detail_imgs": [
                    {
                        "img_url": "",
                        "width": 320,
                        "height": 300,
                        "img_desc": "详情页图片说明"
                    }
                ]
            }
        ],
        "product_props": {
            "color": {
                "color_rgb": "0#FF00FF",
                "color_name": "blue"
            },
            "size": "XXL"
        },
        "sales_props": {
            "is_available": true
        },
        "desc_props": {},
        "commission_props": [
            "123",
            "886"
        ]
    }
]'

应答字段

应答示例

{
    "code": 0,
    "message": "",
    "data": {}
}