商品库获取
前置条件
创建一个商品库。
请求地址
https://api.e.qq.com/v3.0/product_catalogs/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 | 商品库 id,通过 product_catalogs/add 接口 创建商品库时分配的唯一 id | |
catalog_name | string | 商品库名称,字段长度最小 1 字节,长度最大 255 字节 | |
page | integer | 搜索页码,默认值:1,最小值 1,最大值 99999 | |
page_size | integer | 一页显示的数据条数,默认值:10,最小值 1,最大值 100 |
请求示例
curl -G 'https://api.e.qq.com/v1.1/product_catalogs/get?access_token=<ACCESS_TOKEN>×tamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=111111111' \
-d 'page=1' \
-d 'page_size=10'
应答体结构
名称 | 类型 | 描述 |
---|---|---|
list | array | 返回商品库信息列表 数组最大长度 50 |
product_catalog_id | integer | 商品库 id |
product_catalog_name | string | 商品库名称 |
product_catalog_type | enum | 商品库类型 |
product_catalog_vertical | enum | 商品库行业类型 |
product_catalog_status | enum | 商品库状态 |
product_recommend_methods | array | 推荐方式集合 |
method_id | integer | 推荐方式 id |
method_name | string | 推荐方式名称 |
method_description | string | 推荐方式描述名称 |
sub_method_operators | array | 推荐方式逻辑操作符集合 |
sub_method_id | integer | 推荐方式 id |
sub_method_name | string | 推荐方式名称 |
sub_method_description | string | 推荐方式描述名称 |
deep_link_enabled | object | 应用直达选项 |
ios_deep_link_enabled | boolean | 是否支持 ios 应用直达,false:不支持,true:支持 |
android_deep_link_enabled | boolean | 是否支持 ios 应用直达,false:不支持,true:支持 |
h5_deep_link_enabled | boolean | 是否支持 ios 应用直达,false:不支持,true:支持 |
page_info | object | 分页配置信息 |
page | integer | 搜索页码 |
page_size | integer | 一页显示的数据条数,默认值:10,最小值 1,最大值 100 |
total_number | integer | 总条数 |
total_page | integer | 总页数 |
应答示例
{
"code": 0,
"message": "",
"message_cn": "",
"data": {
"list": [
{
"product_catalog_id": 123456
}
]
}
}
该内容是否有帮助?