获取词包
全部接口
V1.1
loading
V1.1
loading
| 所属权限 | Ads Management |
| 请求地址 | ad_param/get |
| 请求方法 | post |
全局参数
全局参数是指每一个接口都需要使用到的参数。详情参考，代码案例参考。
| 参数名称 | 参数类型 |
|---|---|
| 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 |
|
campaign_type*
|
enum | 推广计划类型，[枚举详情] 枚举列表：{ CAMPAIGN_TYPE_SEARCH, CAMPAIGN_TYPE_NORMAL, CAMPAIGN_TYPE_WECHAT_OFFICIAL_ACCOUNTS, CAMPAIGN_TYPE_WECHAT_MOMENTS, CAMPAIGN_TYPE_UNSUPPORTED, CAMPAIGN_TYPE_FREETRADE, CAMPAIGN_TYPE_CONTENT_PROMOTION } |
|
promoted_object_type*
|
enum | 推广目标类型，[枚举详情] 枚举列表：{ PROMOTED_OBJECT_TYPE_APP_ANDROID, PROMOTED_OBJECT_TYPE_APP_IOS, PROMOTED_OBJECT_TYPE_ECOMMERCE, PROMOTED_OBJECT_TYPE_LINK_WECHAT, PROMOTED_OBJECT_TYPE_APP_ANDROID_MYAPP, PROMOTED_OBJECT_TYPE_APP_ANDROID_UNION, PROMOTED_OBJECT_TYPE_LOCAL_ADS_WECHAT, PROMOTED_OBJECT_TYPE_QQ_BROWSER_MINI_PROGRAM, PROMOTED_OBJECT_TYPE_LINK, PROMOTED_OBJECT_TYPE_QQ_MESSAGE, PROMOTED_OBJECT_TYPE_QZONE_VIDEO_PAGE, PROMOTED_OBJECT_TYPE_LOCAL_ADS, PROMOTED_OBJECT_TYPE_ARTICLE, PROMOTED_OBJECT_TYPE_LEAD_AD, PROMOTED_OBJECT_TYPE_TENCENT_KE, PROMOTED_OBJECT_TYPE_EXCHANGE_APP_ANDROID_MYAPP, PROMOTED_OBJECT_TYPE_QZONE_PAGE_ARTICLE, PROMOTED_OBJECT_TYPE_QZONE_PAGE_IFRAMED, PROMOTED_OBJECT_TYPE_QZONE_PAGE, PROMOTED_OBJECT_TYPE_APP_PC, PROMOTED_OBJECT_TYPE_MINI_GAME_WECHAT, PROMOTED_OBJECT_TYPE_MINI_GAME_QQ, PROMOTED_OBJECT_TYPE_COUPON_WECHAT, PROMOTED_OBJECT_TYPE_APP_PROMOTION, PROMOTED_OBJECT_TYPE_WECHAT_CHANNELS, PROMOTED_OBJECT_TYPE_WECHAT_OFFICIAL_ACCOUNT, PROMOTED_OBJECT_TYPE_MINI_PROGRAM_WECHAT, PROMOTED_OBJECT_TYPE_APP_QUICK_APP } |
|
adcreative_template_id*
|
integer | 创意规格 id |
|
site_set*
|
enum | 投放站点集合，[枚举详情] 枚举列表：{ SITE_SET_QZONE, SITE_SET_QQCLIENT, SITE_SET_MUSIC, SITE_SET_MOBILE_UNION, SITE_SET_KUAISHOU, SITE_SET_QQCOM, SITE_SET_WECHAT, SITE_SET_MOBILE_MYAPP, SITE_SET_MOBILE_INNER, SITE_SET_TENCENT_NEWS, SITE_SET_TENCENT_VIDEO, SITE_SET_TENCENT_KUAIBAO, SITE_SET_MOBILE_YYB, SITE_SET_PENGYOU, SITE_SET_TUAN, SITE_SET_MEISHI, SITE_SET_PIAO, SITE_SET_MAIL, SITE_SET_PC_UNION, SITE_SET_YINGYONGBAO_PC, SITE_SET_PAIPAISEARCH, SITE_SET_QQSHOP, SITE_SET_PAIPAIDAOGOU, SITE_SET_QZONESEARCH, SITE_SET_WEBUNION_DELETED, SITE_SET_EXPRESSPORTAL, SITE_SET_WEIBO, SITE_SET_WANGGOU, SITE_SET_MOBILE_UNION_DELETED, SITE_SET_THIRDPARTY, SITE_SET_JD_WAICAI, SITE_SET_PCQQ, SITE_SET_KANDIAN, SITE_SET_QQ_MUSIC_GAME, SITE_SET_MOMENTS, SITE_SET_MINI_GAME_WECHAT, SITE_SET_MINI_GAME_QQ, SITE_SET_MOBILE_GAME, SITE_SET_QQSHOPPING, SITE_SET_CHANNELS, SITE_SET_WECHAT_SEARCH, SITE_SET_WECHAT_PLUGIN, SITE_SET_QBSEARCH, SITE_SET_SEARCH_SCENE } |
|
product_catalog_id
|
integer | 商品库 id |
请求示例
curl 'https://api.e.qq.com/v1.1/ad_param/get?access_token=<ACCESS_TOKEN>×tamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=25610' \
-d 'campaign_type=CAMPAIGN_TYPE_NORMAL' \
-d 'promoted_object_type=PROMOTED_OBJECT_TYPE_APP_ANDROID' \
-d 'adcreative_template_id=711' \
-d 'site_set=SITE_SET_MOBILE_UNION' \
-d 'product_catalog_id=1'
应答字段
| 名称 | 类型 | 描述 |
|---|---|---|
|
system_ad_param_list
|
struct[] | 返回信息列表 |
|
code
|
string | 词包，用于广告文案中某些字段的自动替换 |
|
name
|
string | 词包名称 |
|
description
|
string | 词包描述 |
|
max_length
|
integer | 词包最大长度 |
|
product_ad_param_list
|
struct[] | 返回信息列表 |
|
code
|
string | 词包，用于广告文案中某些字段的自动替换 |
|
name
|
string | 词包名称 |
|
description
|
string | 词包描述 |
|
max_length
|
integer | 词包最大长度 |
应答示例
{
"code": 0,
"message": "",
"message_cn": "",
"data": {
"system_ad_param_list": [
{
"code": "city",
"name": "城市",
"description": "使用城市词包，广告展示时，用户会在该广告文案上看到他所在的城市信息，如深圳，武汉",
"max_length": 4
},
{
"code": "gender",
"name": "性别",
"description": "使用性别词包，广告展示时，用户会在该广告文案上看到他相关的性别信息，如男，女",
"max_length": 2
},
{
"code": "day",
"name": "日期",
"description": "使用日期词包，广告展示时，用户会在该广告文案上看到当天日期信息，如 12 月 30 日",
"max_length": 6
},
{
"code": "week",
"name": "星期",
"description": "使用星期词包，广告展示时，用户会在该广告文案上看到当天星期，如星期三",
"max_length": 3
},
{
"code": "constellation",
"name": "星座",
"description": "使用星座词包，广告展示时，用户会在该广告文案上看到他所属的星座，如射手座，金牛座",
"max_length": 3
},
{
"code": "constellation_date",
"name": "星座日期",
"description": "使用星座时间区间词包，广告展示时，用户会在该广告文案上看到他所属的星座时间区间，如 11.23-12.21",
"max_length": 6
}
],
"product_ad_param_list": [
{
"code": "product.product_short_name",
"name": "商品简称",
"description": "欧帝奴浴室柜, OSPREY 双肩包, 蔻驰相机包, 欧米茄石英表",
"max_length": 10
},
{
"code": "product.first_category_name",
"name": "一级分类名称",
"description": "家装建材, 运动户外, 礼品, 钟表眼镜",
"max_length": 8
},
{
"code": "product.second_category_name",
"name": "二级分类名称",
"description": "厨房卫浴, 户外装备, 奢侈品, 腕表",
"max_length": 8
}
]
}
}可视化调试工具
问题仍未解决？
请前往腾讯广告反馈中心在线提交问题，我们的人工客服将为你服务
