获取商品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>×tamp=<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"
}
}
]
}
}
Copyright © 1998-2019 Tencent. All Rights Reserved.