名称 | 类型 | 描述 |
---|---|---|
account_id* | integer | 广告主帐号 id,有操作权限的帐号 id,不支持代理商 id |
filtering | struct[] | 过滤条件,若此字段不传,或传空则视为无限制条件,详见 [过滤条件] 数组最小长度 1,最大长度 5 |
field* | string | 过滤字段 可选值:{ promoted_object_type, promoted_object_id, created_time, last_modified_time, is_ad_acct } |
operator* | enum | 操作符 当 field 取值 promoted_object_type 时,枚举列表:{ EQUALS } 当 field 取值 promoted_object_id 时,枚举列表:{ EQUALS, IN } 当 field 取值 created_time 时,枚举列表:{ EQUALS, LESS_EQUALS, LESS, GREATER_EQUALS, GREATER } 当 field 取值 last_modified_time 时,枚举列表:{ EQUALS, LESS_EQUALS, LESS, GREATER_EQUALS, GREATER } |
values* | string[] | 字段取值,values 数组的个数限制与 operator 的取值相关,详见 [过滤条件] 当 field 取值 promoted_object_type 时, 枚举列表:{ PROMOTED_OBJECT_TYPE_APP_ANDROID, PROMOTED_OBJECT_TYPE_APP_IOS, PROMOTED_OBJECT_TYPE_APP_ANDROID_MYAPP, PROMOTED_OBJECT_TYPE_APP_ANDROID_UNION, PROMOTED_OBJECT_TYPE_QQ_BROWSER_MINI_PROGRAM, PROMOTED_OBJECT_TYPE_LOCAL_ADS, PROMOTED_OBJECT_TYPE_EXCHANGE_APP_ANDROID_MYAPP, PROMOTED_OBJECT_TYPE_MINI_GAME_WECHAT, PROMOTED_OBJECT_TYPE_MINI_GAME_QQ, PROMOTED_OBJECT_TYPE_WECHAT_OFFICIAL_ACCOUNT, PROMOTED_OBJECT_TYPE_APP_QUICK_APP } 当 field 取值 promoted_object_id 且 operator 取值 IN 时, 字段长度最小 0 字节,长度最大 128 字节 当 field 取值 promoted_object_id 时, 字段长度最小 0 字节,长度最大 128 字节 当 field 取值 created_time 时, 字段长度为 10 字节 当 field 取值 last_modified_time 时, 字段长度为 10 字节 |
page | integer | 搜索页码,默认值:1 最小值 1,最大值 99999 |
page_size | integer | 一页显示的数据条数,默认值:10 最小值 1,最大值 100 |
使用说明 1.每次调用该接口,系统将自动至应用宝或 app store 拉取最新的下载链接。
名称 | 类型 | 描述 |
---|---|---|
list | struct[] | 返回信息列表 |
promoted_object_name | string | 推广目标名称 |
promoted_object_id | string | |
promoted_object_type | enum | 推广目标类型,[枚举详情] |
promoted_object_spec | struct | 推广目标 详细信息 |
app_ios_spec | struct | IOS 应用信息,从苹果 App Store 拉取的 IOS 应用信息 |
packname | string | 应用的包名 |
version | string | 应用的版本 |
icon | string | 应用图标地址 |
icon_512 | string | 应用图标地址,分辨率固定 512x512 |
average_rating | string | 应用评分 |
package_size | string | 应用包大小,单位字节 |
genres | string[] | 应用分类,来自外系统的分类,目前仅用于广告展示 |
package_download_url | string | 应用安装包下载地址 |
app_android_spec | struct | android 应用信息,从腾讯开放平台拉取的 android 应用信息 |
packname | string | 应用的包名 |
version | string | 应用的版本 |
icon | string | 应用图标地址 |
average_rating | string | 应用评分 |
package_size | string | 应用包大小,单位字节 |
genres | string[] | 应用分类,来自外系统的分类,目前仅用于广告展示 |
package_download_url | string | 应用安装包下载地址 |
channel_package_spec | struct[] | 渠道包详细信息列表,只返回最近 99 个渠道包,如需获取全部渠道包信息,请使用获取推广渠道包接口(app_android_channel_packages/get) |
app_android_channel_package_id | string | 安卓应用渠道包 id,当前特指投放腾讯开放平台安卓应用的渠道包 id,从推广目标模块的读取接口可以获取 |
package_name | string | 包名称 |
app_android_union_spec | struct | 广告包 app 应用信息 |
packname | string | 应用的包名 |
version | string | 应用的版本 |
icon | string | 应用图标地址 |
package_size | string | 应用包大小,单位字节 |
package_md5 | string | 应用安装包 md5 |
package_download_url | string | 应用安装包下载地址 |
channel_package_spec | struct[] | 渠道包详细信息列表,只返回最近 99 个渠道包,如需获取全部渠道包信息,请使用获取推广渠道包接口(app_android_channel_packages/get) |
app_android_channel_package_id | string | 安卓应用渠道包 id,当前特指投放腾讯开放平台安卓应用的渠道包 id,从推广目标模块的读取接口可以获取 |
package_name | string | 包名称 |
app_android_myapp_spec | struct | 应用宝 app 信息 |
packname | string | |
version | string | |
icon | string | |
package_size | string | |
channel_package_spec | struct[] | 渠道包详细信息列表,只返回最近 99 个渠道包,如需获取全部渠道包信息,请使用获取推广渠道包接口(app_android_channel_packages/get) |
app_android_channel_package_id | string | 安卓应用渠道包 id,当前特指投放腾讯开放平台安卓应用的渠道包 id,从推广目标模块的读取接口可以获取 |
package_name | string | 包名称 |
mini_game_wechat_spec | struct | 微信小游戏信息 |
mini_game_program_id | string | 微信小游戏 id |
qq_browser_mini_program | struct | QQ 浏览器小程序信息 |
packname | string | |
icon | string | |
local_ads_spec | struct | 本地门店信息 |
shop_name | string | 门店名称 |
address | string | 门店地址 |
telphone | string | 门店电话 |
system_industry_id | string | 门店行业 id |
created_time | integer | 创建时间(时间戳) |
last_modified_time | integer | 最后修改时间(时间戳) |
page_info | struct | 分页配置信息 |
page | integer | 搜索页码 |
page_size | integer | 一页显示的数据条数 |
total_number | integer | 总条数 |
total_page | integer | 总页数 |
curl --location --request GET '/v1.3/promoted_objects/get' \
--header 'access_token;' \
--header 'timestamp;' \
--header 'nonce;' \
--header 'fields;' \
--data-urlencode 'account_id=<ACCOUNT_ID>' \
--data-urlencode 'filtering=[{"field":"promoted_object_type","operator":"EQUALS","values":["PROMOTED_OBJECT_TYPE_APP_IOS"]}]' \
--data-urlencode 'page=1' \
--data-urlencode 'page_size=10'
{
"code": 0,
"message": "",
"message_cn": "",
"data": {
"list": [
{
"promoted_object_id": "C3C2X",
"promoted_object_type": "PROMOTED_OBJECT_TYPE_APP_IOS",
"promoted_object_spec": {
"app_ios_spec": {
"packname": "com.test.pack",
"version": "7.7.8",
"icon": "http://www.example.com/image/1",
"icon_512": "http://www.example.com/image/2",
"average_rating": "3.5",
"package_size": "323156992",
"genres": [
"社交",
"娱乐"
],
"package_download_url": "https://itunes.apple.com/cn/app/qq/id444934666"
}
},
"created_time": 1491019858,
"last_modified_time": 1491098468
}
],
"page_info": {
"page": 1,
"page_size": 10,
"total_number": 1,
"total_page": 1
}
}
}