接口文档SDK业务专题开发者工具

获取推广目标
全部接口
V1.1
loading

所属权限 Ads Management,Ads Insights
请求地址 promoted_objects/get
请求方法 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 中的字段。如不填写，则根据默认值进行返回

请求参数

标有*的参数为必填项

名称 类型 描述
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 拉取最新的下载链接。

请求示例


curl -G 'https://api.e.qq.com/v1.1/promoted_objects/get?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=<ACCOUNT_ID>' \
-d 'filtering=[{"field":"promoted_object_type","operator":"EQUALS","values":["PROMOTED_OBJECT_TYPE_APP_IOS"]}]' \
-d 'page=1' \
-d 'page_size=10'

应答字段

名称 类型 描述
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 总页数

应答示例

{
    "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
        }
    }
}

可视化调试工具

广告资源

广告技术

开发文档

辅助工具

帮助支持

手机浏览开发者官网

Copyright © 1998 - Tencent Inc. All Rights Reserved.