跳到主要内容

商品库获取


前置条件

创建一个商品库。


请求地址

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 个字符,由调用方自行生成,需保证全局唯一性
fieldsget 接口增加 fields 字段,用于指定返回参数的字段列表,为选填字段。fields 取值范围为 get 接口返回的 list 中的字段。如不填写,则根据默认值进行返回

请求体类型

application/json


请求体参数

阅读说明:Y - 必填;C - 条件选填(conditional),请关注“描述”信息;空 - 非必填

名称类型必填描述
account_idintegerY
推广帐号 id或 DataNexus 账号 id
catalog_idinteger
商品库 id,通过 product_catalogs/add 接口 创建商品库时分配的唯一 id
catalog_namestring
商品库名称,字段长度最小 1 字节,长度最大 255 字节
pageinteger
搜索页码,默认值:1,最小值 1,最大值 99999
page_sizeinteger
一页显示的数据条数,默认值:10,最小值 1,最大值 100

请求示例

curl -G 'https://api.e.qq.com/v1.1/product_catalogs/get?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=111111111' \
-d 'page=1' \
-d 'page_size=10'

应答体结构

名称类型描述
listarray返回商品库信息列表 数组最大长度 50
product_catalog_idinteger商品库 id
product_catalog_namestring商品库名称
product_catalog_typeenum商品库类型
product_catalog_verticalenum商品库行业类型
product_catalog_statusenum商品库状态
product_recommend_methodsarray推荐方式集合
method_idinteger推荐方式 id
method_namestring推荐方式名称
method_descriptionstring推荐方式描述名称
sub_method_operatorsarray推荐方式逻辑操作符集合
sub_method_idinteger推荐方式 id
sub_method_namestring推荐方式名称
sub_method_descriptionstring推荐方式描述名称
deep_link_enabledobject应用直达选项
ios_deep_link_enabledboolean是否支持 ios 应用直达,false:不支持,true:支持
android_deep_link_enabledboolean是否支持 ios 应用直达,false:不支持,true:支持
h5_deep_link_enabledboolean是否支持 ios 应用直达,false:不支持,true:支持
page_infoobject分页配置信息
pageinteger搜索页码
page_sizeinteger一页显示的数据条数,默认值:10,最小值 1,最大值 100
total_numberinteger总条数
total_pageinteger总页数

应答示例

{
"code": 0,
"message": "",
"message_cn": "",
"data": {
"list": [
{
"product_catalog_id": 123456
}
]
}
}



该内容是否有帮助?