广告投放商品获取

前置条件

创建商品。

请求地址

https://api.e.qq.com/v3.0/product_items/get

所属权限

广告管理（Ads Management）

请求方法

GET

请求参数

参数名	描述
access_token	授权令牌，完成 OAuth 2.0 授权后获得，参考开发者环境
timestamp	当前的时间戳，单位为秒，允许客户端请求最大时间误差为 300 秒。MarketingAPI 所使用的时间戳，若无特殊说明，均为秒级时间戳签名算法。MarketingAPI 所使用的时区为 GMT+8，例如当时间戳为 1494840119 时，表示 2017-05-15 17:21:59
nonce	随机字串标识，不超过 32 个字符，由调用方自行生成，需保证全局唯一性
fields	get 接口增加 fields 字段，用于指定返回参数的字段列表，为选填字段。fields 取值范围为 get 接口返回的 list 中的字段。如不填写，则根据默认值进行返回

请求体类型

application/json

请求体参数

阅读说明：Y - 必填；C - 条件选填（conditional），请关注“描述”信息；空 - 非必填

名称	类型	必填	描述
account_id	integer	Y	推广帐号 id或 DataNexus 账号 id
catalog_id	integer	Y	商品库 id，通过 <a href='https://datanexus.qq.com/doc/develop/guider/interface/commodity/product_catalogs_add'>product_catalogs/add 接口</a> 创建商品库时分配的唯一 id
filtering	array		过滤条件，1、若此字段不传，或传空则视为无限制条件，默认只返回 Top 100 匹配商品。如需展示所有商品，请于 youhuo.qq.com 或者 youhuo.tencent.com 中查看。2、此接口为非实时接口，最大 2 小时延迟。数组最小长度 1，最大长度 10
field	string	Y	过滤字段，可选值：{ 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	Y	操作符；当 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 }；当 field 取值 product_status 时，枚举列表：{ EQUALS, CONTAINS }
values	string[]	Y	字段取值，字段长度最小 1 字节，长度最大 255 字节

请求示例

curl -G 'https://api.e.qq.com/v1.3/product_items/get?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=111111111' \
-d 'product_catalog_id=<CATALOG_ID>' \
-d 'filtering=[]'

应答体结构

名称	类型	描述
list	array	返回行业信息列表数组最大长度 50
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	爆量分

应答示例

{
  "code": 0,
  "message": "",
  "message_cn": "",
  "data": {
    "list": [
      {
        "product_outer_id": "xly_123",
        "price": 12.9900000000000002131628207280300557613372802734375
      }
    ]
  }
}

该内容是否有帮助？

请求地址​

所属权限​

请求方法​

请求参数​

请求体类型​

请求体参数​

请求示例​

应答体结构​

应答示例​

请求地址

所属权限

请求方法

请求参数

请求体类型

请求体参数

请求示例

应答体结构

应答示例