名称 | 类型 | 描述 |
---|---|---|
account_id* | integer | 广告主 id,有操作权限的广告主 id,如果已经升级了工作台,则填写 bm_id |
product_catalog_id* | integer | 商品库 id |
filtering | struct[] | 过滤条件,1、若此字段不传,或传空则视为无限制条件,默认只返回 Top 100 匹配商品。如需展示所有商品,请于 youhuo.qq.com 或者 youhuo.tencent.com 中查看。2、此接口为非实时接口,最大 2 小时延迟。 数组最小长度 1,最大长度 10 |
field* | string | 过滤字段 可选值:{ product_set_id, product_name, product_outer_id, first_category_id, second_category_id, third_category_id, fourth_category_id, sdpa_or_mdpa, category_ids, landing_page_types, filter_video, limit, high_info_tag } |
operator* | enum | 操作符 当 field 取值 product_set_id 时,枚举列表:{ EQUALS } 当 field 取值 product_name 时,枚举列表:{ EQUALS, CONTAINS } 当 field 取值 product_outer_id 时,枚举列表:{ EQUALS, IN } 当 field 取值 first_category_id 时,枚举列表:{ EQUALS, IN } 当 field 取值 second_category_id 时,枚举列表:{ EQUALS, IN } 当 field 取值 third_category_id 时,枚举列表:{ EQUALS, IN } 当 field 取值 fourth_category_id 时,枚举列表:{ EQUALS, IN } 当 field 取值 sdpa_or_mdpa 时,枚举列表:{ EQUALS } 当 field 取值 category_ids 时,枚举列表:{ EQUALS, IN } 当 field 取值 landing_page_types 时,枚举列表:{ EQUALS, IN } 当 field 取值 filter_video 时,枚举列表:{ EQUALS } 当 field 取值 limit 时,枚举列表:{ EQUALS } 当 field 取值 sort_by 时,枚举列表:{ EQUALS } 当 field 取值 high_info_tag 时,枚举列表:{ EQUALS } |
values* | string[] | 字段取值,values 数组的个数限制与 operator 的取值相关 当 field 取值 product_set_id 时, 字段长度最小 1 字节,长度最大 255 字节 当 field 取值 product_outer_id 时, 字段长度最小 1 字节,长度最大 255 字节 当 field 取值 product_name 时, 字段长度最小 1 字节,长度最大 255 字节 当 field 取值 first_category_id 时, 字段长度最小 1 字节,长度最大 255 字节 当 field 取值 second_category_id 时, 字段长度最小 1 字节,长度最大 255 字节 当 field 取值 third_category_id 时, 字段长度最小 1 字节,长度最大 255 字节 当 field 取值 fourth_category_id 时, 字段长度最小 1 字节,长度最大 255 字节 当 field 取值 sdpa_or_mdpa 时, 字段长度最小 1 字节,长度最大 255 字节 当 field 取值 category_ids 时, 字段长度最小 1 字节,长度最大 255 字节 当 field 取值 landing_page_types 时, 字段长度最小 1 字节,长度最大 255 字节 当 field 取值 filter_video 时, 字段长度最小 1 字节,长度最大 255 字节 当 field 取值 limit 时, 字段长度最小 1 字节,长度最大 255 字节 当 field 取值 sort_by 时, 字段长度最小 1 字节,长度最大 255 字节 当 field 取值 high_info_tag 时, 字段长度最小 1 字节,长度最大 255 字节 |
名称 | 类型 | 描述 |
---|---|---|
list | struct[] | 返回信息列表 |
product_outer_id | string | 广告主商品 id |
product_name | string | 商品名称 |
product_image_url | string | 商品预览图 |
product_short_name | string | 商品简称 |
price | float | 商品日常售价,大于等于 0,至多 2 位小数 |
first_category_id | integer | 一级分类 id |
first_category_name | string | 一级分类名称 |
second_category_id | integer | 二级分类 id |
second_category_name | string | 二级分类名称 |
third_category_id | integer | 三级分类 id |
third_category_name | string | 三级分类名称 |
fourth_category_id | integer | 四级分类 id |
fourth_category_name | string | 四级分类名称 |
brand_name | string | 品牌名称 |
brand_id | integer | 品牌 id |
description | string | 商品描述 |
custom_data | string | 商品自定义属性 |
is_video | boolean | 是否视频商品(true|false) |
data_source | string | 搜索结果来源名称 |
product_select_score | float | 爆量分 |
curl --location --request GET '/v1.3/product_items/get' \
--header 'access_token;' \
--header 'timestamp;' \
--header 'nonce;' \
--header 'fields;' \
--data-urlencode 'account_id=111111111' \
--data-urlencode 'product_catalog_id=<CATALOG_ID>' \
--data-urlencode 'filtering=[]'
{
"code": 0,
"message": "",
"message_cn": "",
"data": {
"list": [
{
"product_outer_id": "xly_123",
"price": 12.9900000000000002131628207280300557613372802734375
}
]
}
}