腾讯有数官方文档

获取商品SKU

请求地址

product_skus/get

请求方法

GET

请求参数

名称 类型 描述
account_id 必填 integer

推广帐号 id ,有操作权限的帐号 id,包括代理商和广告主帐号id

data_warehouse_id 必填 integer

数据仓库ID

external_sku_id 必填 string

您为商品SKU分配的唯一ID。 一般而言,是您在商品库为该商品SKU分配的id。

字段长度最小 1 字节,长度最大 128 字节

请求示例

curl -G 'https://api.e.qq.com/v1.1/product_skus/get?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id="<ACCOUNT_ID>"' \
-d 'data_warehouse_id=101' \
-d 'external_sku_id="testSKU"'

应答字段

名称 类型 描述
list 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

url类型,长度不超过2048

字段长度最小 1 字节,长度最大 2048 字节
width integer

图片宽度,整型值

height integer

图片高度,整型值

img_desc string

图片描述

字段长度最小 1 字节,长度最大 100 字节
primary_imgs struct[]

主图图片信息列表

数组最大长度 10
img_url string

url类型,长度不超过2048

字段长度最小 1 字节,长度最大 2048 字节
width integer

图片宽度,整型值

height integer

图片高度,整型值

img_desc string

图片描述

字段长度最小 1 字节,长度最大 100 字节
detail_imgs struct[]

详情页图片信息列表

数组最大长度 10
img_url string

url类型,长度不超过2048

字段长度最小 1 字节,长度最大 2048 字节
width integer

图片宽度,整型值

height integer

图片高度,整型值

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 字节
external_created_time 必填 string

客户侧的商品创建时间

字段长度最小 18 字节,长度最大 20 字节
external_last_modified_time 必填 string

客户侧的商品更新时间

字段长度最小 18 字节,长度最大 20 字节

应答示例

{
    "code": 0,
    "message": "",
    "data": {
        "list": [
            {
                "external_sku_id": "testSKU",
                "external_spu_id": "testSPU",
                "sku_barcode": "testSKUBarcode",
                "promotion_ids": [
                    "123",
                    "456"
                ],
                "coupon_ids": [
                    "34FDERHA3",
                    "IOR345ASDF"
                ],
                "img_urls": [
                    {
                        "dimensions": {
                            "color": "Yellow"
                        },
                        "imgs": [
                            {
                                "img_url": "",
                                "width": 320,
                                "height": 300,
                                "img_desc": "图片说明"
                            }
                        ],
                        "primary_imgs": [
                            {
                                "img_url": "",
                                "width": 1000,
                                "height": 600,
                                "img_desc": "主图1"
                            }
                        ],
                        "logo_imgs": [
                            {
                                "img_url": "",
                                "width": 100,
                                "height": 100,
                                "img_desc": "Logo图"
                            }
                        ],
                        "brand_imgs": [
                            {
                                "img_url": "",
                                "width": 320,
                                "height": 300,
                                "img_desc": "图片说明"
                            }
                        ],
                        "detail_imgs": [
                            {
                                "img_url": "",
                                "width": 320,
                                "height": 300,
                                "img_desc": "详情页图片说明"
                            }
                        ]
                    }
                ],
                "product_props": {
                    "weight": {
                        "weight": 12.3,
                        "tare_weight": 101.5,
                        "gross_weight": 100.5,
                        "net_weight": 95.5
                    },
                    "dimension": {
                        "length": 1.2,
                        "width": 1.2,
                        "height": 3.3,
                        "volumn": 30
                    },
                    "color": {
                        "color_rgb": "0#FF00FF",
                        "color_name": "blue"
                    },
                    "is_ofo": false,
                    "is_weight": true,
                    "product_year": 2018,
                    "product_season": 1,
                    "origin": "深圳",
                    "package_unit_desc": "2*5*750ml",
                    "package_type": "箱",
                    "sale_unit": "个",
                    "size": "XXL",
                    "custom_props": {
                        "param1": "value1",
                        "param2": "value2"
                    }
                },
                "external_brand_id": "35667",
                "labels": [
                    "性价比高",
                    "物美价廉"
                ],
                "front_category_id_list": [
                    "1356",
                    "1234"
                ],
                "background_category_id_list": [
                    "2456",
                    "123"
                ],
                "target_url_props": {
                    "target_url_android": "",
                    "target_url_wechat": "",
                    "target_url_mobile": "",
                    "target_url_miniprogram": "",
                    "target_url_ios": "",
                    "target_url_pc": ""
                },
                "sales_props": {
                    "is_gift": false,
                    "is_presell": false,
                    "score_rule": "",
                    "sales_num": 345,
                    "is_score": true,
                    "is_available": true,
                    "available_time": "2018-11-28 00:00:00",
                    "status": "NEW"
                },
                "desc_props": {
                    "product_name_cn": "中文名称",
                    "product_name_en": "English Name",
                    "product_description_start_time": "",
                    "product_description_end_time": "",
                    "product_description": "",
                    "product_desc_src_url": "",
                    "product_type": "NORMAL"
                },
                "comment_props": {
                    "favorite_count": 15005,
                    "comment_count": 13003,
                    "ratings": "4.5",
                    "favourable_comment_rate": "98%"
                },
                "commission_props": [
                    "123",
                    "886"
                ],
                "logistics_props": [
                    {
                        "shipping_fee": 335,
                        "delivery_type": "EXPRESS"
                    }
                ],
                "extra_props": {
                    "extra1": "value1"
                }
            }
        ]
    }
}