获取创意规格列表
全部接口
V1.1
loading
V1.1
loading
| 所属权限 | Ads Management,Ads Insight |
| 请求地址 | adcreative_template_list/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 |
|
site_set
|
enum | 投放版位，[枚举详情] 枚举列表：{ SITE_SET_QZONE, SITE_SET_PENGYOU, SITE_SET_QQCLIENT, SITE_SET_TUAN, SITE_SET_MEISHI, SITE_SET_PIAO, SITE_SET_MUSIC, SITE_SET_MOBILE_UNION, SITE_SET_QQCOM, SITE_SET_MAIL, SITE_SET_WECHAT, SITE_SET_MOBILE_MYAPP, SITE_SET_PC_UNION, SITE_SET_YINGYONGBAO_PC, SITE_SET_MOBILE_INNER, SITE_SET_JD_WAICAI, SITE_SET_TENCENT_NEWS, SITE_SET_TENCENT_VIDEO, SITE_SET_TENCENT_KUAIBAO, SITE_SET_PCQQ, SITE_SET_KANDIAN, SITE_SET_QQ_MUSIC_GAME, SITE_SET_KUAISHOU, SITE_SET_MOMENTS, SITE_SET_MINI_GAME_WECHAT, SITE_SET_MINI_GAME_QQ, SITE_SET_MOBILE_GAME, SITE_SET_MOBILE_YYB, SITE_SET_QQSHOPPING } |
|
campaign_type
|
enum | 推广计划类型，[枚举详情] 枚举列表：{ CAMPAIGN_TYPE_NORMAL, CAMPAIGN_TYPE_WECHAT_MOMENTS } |
|
promoted_object_type
|
enum | 推广目标类型，[枚举详情] 枚举列表：{ PROMOTED_OBJECT_TYPE_LINK, PROMOTED_OBJECT_TYPE_LINK_WECHAT, PROMOTED_OBJECT_TYPE_ECOMMERCE, 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_WECHAT, PROMOTED_OBJECT_TYPE_QQ_MESSAGE, PROMOTED_OBJECT_TYPE_LEAD_AD, PROMOTED_OBJECT_TYPE_MINI_GAME_WECHAT, PROMOTED_OBJECT_TYPE_MINI_GAME_QQ, PROMOTED_OBJECT_TYPE_WECHAT_OFFICIAL_ACCOUNT } |
|
dynamic_ability_type
|
enum[] | 动态广告投放能力类型，[枚举详情] 数组最小长度 0，最大长度 3 枚举列表：{ DYNAMIC_TYPE_SINGLE_PRODUCT_AD, DYNAMIC_TYPE_MULTIPLE_PRODUCT_AD, DYNAMIC_TYPE_DYNAMIC_CREATIVE } |
|
is_dynamic_creative
|
boolean | 是否查询这个规格在动态创意广告类型下可用的创意元素 adcreative elements，选填值，不填则默认查询常规展示广告所用的元素，设置为 True 时查询动态创意广告相关元素 可选值：{ true, false } |
|
wechat_scene_spec_position
|
integer[] | 微信公众号与小程序定投 数组最小长度 0，最大长度 9223372036854775807 |
|
adcreative_template_id
|
integer | 创意形式 id |
|
page
|
integer | 搜索页码，默认值：1 最小值 1，最大值 99999 |
|
page_size
|
integer | 一页显示的数据条数，默认值：10 最小值 1，最大值 100 |
请求示例
curl -G 'https://api.e.qq.com/v1.1/adcreative_template_list/get?access_token=<ACCESS_TOKEN>×tamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=<ACCOUNT_ID>' \
-d 'dynamic_ability_type=[]' \
-d 'wechat_scene_spec_position=[]' \
-d 'adcreative_template_id=<ADCREATIVE_TEMPLATE_ID>' \
-d 'page=1' \
-d 'page_size=10'
应答字段
| 名称 | 类型 | 描述 |
|---|---|---|
|
list
|
struct[] | 创意规格列表 |
|
adcreative_template_id
|
integer | 创意形式 id |
|
adcreative_template_style
|
string | 创意形式类型 |
|
adcreative_template_appellation
|
string | 创意形式名称 |
|
adcreative_sample_image
|
string | 创意规格示意图链接 |
|
promoted_object_type
|
enum | 推广目标类型，[枚举详情] |
|
site_set
|
enum | 投放版位，[枚举详情] |
|
support_billing_spec_list
|
struct[] | 支持的计费信息 |
|
billing_event
|
enum | 计费方式，[枚举详情] |
|
min_price
|
integer | 最低出价，单位分 |
|
max_price
|
integer | 最高出价，单位分 |
|
support_bid_mode_list
|
enum[] | 支持的出价方式，[枚举详情] |
|
page_info
|
struct | 分页配置信息 |
|
page
|
integer | 搜索页码 |
|
page_size
|
integer | 一页显示的数据条数 |
|
total_number
|
integer | 总条数 |
|
total_page
|
integer | 总页数 |
应答示例
{
"code": 0,
"message": "",
"message_cn": "",
"data": {
"list": [
{
"adcreative_template_id": "<ADCREATIVE_TEMPLATE_ID>",
"support_billing_spec_list": [],
"support_bid_mode_list": []
}
],
"page_info": {
"page": 1,
"page_size": 10,
"total_number": 1,
"total_page": 1
}
}
}可视化调试工具
问题仍未解决？
请前往腾讯广告反馈中心在线提交问题，我们的人工客服将为你服务
