获取创意规格详情

请求参数

标有*的参数为必填项

名称	类型	描述
account_id*	integer	广告主帐号 id，有操作权限的帐号 id，不支持代理商 id
site_set	enum[]	投放版位集合，当前单版位或者 SITE_SET_TENCENT_NEWS+SITE_SET_TENCENT_VIDEO+SITE_SET_MOBILE_UNION+SITE_SET_KANDIAN+SITE_SET_QQ_MUSIC_GAME 的组合，[枚举详情] 数组最小长度 1，最大长度 32 枚举列表：{ 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 }
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 }
automatic_site_enabled	boolean	是否开启自动版位功能（暂不包含 SITE_SET_WECHAT 和 SITE_SET_MOMENTS），此字段与 site_set 字段至少需要写入一个。可选值：{ true, false }
is_dynamic_creative	boolean	是否查询这个规格在动态创意广告类型下可用的创意元素 adcreative elements，选填值，不填则默认查询常规展示广告所用的元素，设置为 True 时查询动态创意广告相关元素可选值：{ true, false }
adcreative_template_id	integer	创意形式 id
dynamic_creative_type	enum	动态创意类型，[枚举详情] 枚举列表：{ DYNAMIC_CREATIVE_TYPE_COMMON, DYNAMIC_CREATIVE_TYPE_PROGRAM, DYNAMIC_CREATIVE_TYPE_COMPONENT }

应答字段

名称	类型	描述
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[]	投放版位集合，当前单版位或者 SITE_SET_TENCENT_NEWS+SITE_SET_TENCENT_VIDEO+SITE_SET_MOBILE_UNION+SITE_SET_KANDIAN+SITE_SET_QQ_MUSIC_GAME 的组合，[枚举详情]
support_billing_spec_list	struct[]	支持的计费信息
billing_event	enum	计费方式，[枚举详情]
min_price	integer	最低出价，单位分
max_price	integer	最高出价，单位分
support_bid_mode_list	enum[]	支持的出价方式，[枚举详情]
adcreative_elements	struct[]	广告创意元素列表
name	string	广告创意接口要求的 adcreative_elements 结构中的元素字段名，如 image、title 等
element_type	enum	创意元素类型，[枚举详情]
field_type	enum	创意元素传参类型，[枚举详情]
required	boolean	创意元素是否必填，true 或 false
description	string	该创意元素的描述，如图片、广告文案等
parent_name	string	创意元素父节点名称，为父节点的 name 字段
enum_property	struct	广告创意元素枚举值特性
default	string	创意元素枚举默认值
enumeration	struct[]	创意元素枚举可选值数组
value	string	创意元素枚举可选值
description	string	创意元素枚举可选值描述
array_property	struct	广告创意元素数组特性
min_number	integer	广告创意元素数组个数最小值
max_number	integer	广告创意元素数组个数最大值
struct_property	struct	广告创意元素结构体特性
element_mutual_exclusive	boolean	结构体中元素是否互斥，true: 是，仅能使用结构体中的一个元素字段； false: 否
restriction	struct	广告创意元素需满足的限制条件
text_restriction	struct	文本需满足的限制条件，仅当 element_type 是 ELEMENT_TYPE_TEXT 时返回
min_length	integer	最小长度，文本类型适用
max_length	integer	最大长度，文本类型适用
text_pattern	string	text 的正则表达式
image_restriction	struct	图片需满足的限制条件，仅当 element_type 是 ELEMENT_TYPE_IMAGE_ARRAY 或 ELEMENT_TYPE_IMAGE 时返回
width	integer	宽度，单位 px，图片适用
height	integer	高度，单位 px，图片适用
file_size	integer	支持的文件大小最大值，单位 KB，1KB=1024B, 图片、视频适用
file_format	enum[]	支持的图片文件格式数组，[枚举详情]
url_restriction	struct	链接需满足的限制条件，仅当 element_type 是 ELEMENT_TYPE_URL 时返回
url_pattern	string	url 的正则表达式
video_restriction	struct	视频需满足的限制条件，仅当 element_type 是 ELEMENT_TYPE_VIDEO 时返回
width	integer	宽度，单位 px，视频适用，ratio_width、ratio_height、min_width、min_height 与 width、height 不同时返回
height	integer	高度，单位 px，视频适用，ratio_width、ratio_height、min_width、min_height 与 width、height 不同时返回
min_width	integer	最小宽度，单位 px，视频适用，ratio_width、ratio_height、min_width、min_height 与 width、height 不同时返回
min_height	integer	最小高度，单位 px，视频适用，ratio_width、ratio_height、min_width、min_height 与 width、height 不同时返回
ratio_width	integer	宽比例，视频比例=ratio_width：ratio_height，ratio_width、ratio_height、min_width、min_height 与 width、height 不同时返回
ratio_height	integer	高比例，视频比例=ratio_width：ratio_height，ratio_width、ratio_height、min_width、min_height 与 width、height 不同时返回
file_size	integer	支持的文件大小最大值，单位 KB，1KB=1024B, 图片、视频适用
file_format	enum[]	支持的流媒体文件格式数组，[枚举详情]
min_duration	integer	最小时长，单位秒，视频适用
max_duration	integer	最大时长，单位秒，视频适用
number_restriction	struct	数值型需满足的限制条件，仅当 element_type 是 ELEMENT_TYPE_INTEGER 时返回
min	integer	最小长度，文本类型适用
max	integer	最大长度，文本类型适用
landing_page_config	struct	支持的落地页类型
required	boolean	是否必填
support_page_type_list	struct[]	支持落地页类型列表
page_type	string	名称
description	string	描述
support_link_name_type	struct	文字链跳转类型
required	boolean	是否必填
list	struct[]	文字链跳转类型列表
link_name_type	string	名称
description	string	描述
support_link_page_type	struct	文字链支持落地页类型
required	boolean	是否必填
list	struct[]	文字链支持落地页列表
link_page_type	string	名称
description	string	描述
adcreative_attributes	struct[]	广告创意能力项列表
required	boolean	是否必填
name	string	广告创意接口要求的 adcreative_elements 结构中的元素字段名，如 image、title 等
description	string	该创意元素的描述，如图片、广告文案等
field_type	enum	创意元素传参类型，[枚举详情]
property_detail	struct	能力项详情
string_detail	struct	文本需满足的限制条件，仅当 element_type 是 ELEMENT_TYPE_TEXT 时返回
min_length	integer	最小长度，文本类型适用
max_length	integer	最大长度，文本类型适用
text_pattern	string	text 的正则表达式
integer_detail	struct	数值型需满足的限制条件，仅当 element_type 是 ELEMENT_TYPE_INTEGER 时返回
min	integer	最小长度，文本类型适用
max	integer	最大长度，文本类型适用
enum_detail	struct	广告创意元素枚举值特性
default	string	创意元素枚举默认值
enumeration	struct[]	创意元素枚举可选值数组
value	string	创意元素枚举可选值
description	string	创意元素枚举可选值描述
struct_detail	struct	广告创意能力项子节点列表
element_list	struct[]	广告创意能力项子节点列表
required	boolean	是否必填
name	string	广告创意接口要求的 adcreative_elements 结构中的元素字段名，如 image、title 等
description	string	该创意元素的描述，如图片、广告文案等
field_type	enum	创意元素传参类型，[枚举详情]
property_detail	struct	能力项详情
string_detail	struct	文本需满足的限制条件，仅当 element_type 是 ELEMENT_TYPE_TEXT 时返回
min_length	integer	最小长度，文本类型适用
max_length	integer	最大长度，文本类型适用
text_pattern	string	text 的正则表达式
integer_detail	struct	数值型需满足的限制条件，仅当 element_type 是 ELEMENT_TYPE_INTEGER 时返回
min	integer	最小长度，文本类型适用
max	integer	最大长度，文本类型适用
enum_detail	struct	广告创意元素枚举值特性
default	string	创意元素枚举默认值
enumeration	struct[]	创意元素枚举可选值数组
value	string	创意元素枚举可选值
description	string	创意元素枚举可选值描述
array_restriction	struct	广告创意元素数组特性
min_number	integer	广告创意元素数组个数最小值
max_number	integer	广告创意元素数组个数最大值
array_restriction	struct	广告创意元素数组特性
min_number	integer	广告创意元素数组个数最小值
max_number	integer	广告创意元素数组个数最大值
support_dynamic_ability_spec_list	struct	动态广告支持情况
dynamic_ability_type	enum[]	动态广告投放能力类型，[枚举详情]
product_item_display_quantity	enum[]	在该规格位置上单个广告上的创意可展示商品数量，[枚举详情]
unsupport_siteset_detail_spec	struct[]	不支持播放的版位信息列表
site_set	enum[]	投放版位集合，当前单版位或者 SITE_SET_TENCENT_NEWS+SITE_SET_TENCENT_VIDEO+SITE_SET_MOBILE_UNION+SITE_SET_KANDIAN+SITE_SET_QQ_MUSIC_GAME 的组合，[枚举详情]
unsupport_bid_mode_list	struct[]	不支持的出价方式
site_set	enum[]	投放版位集合，当前单版位或者 SITE_SET_TENCENT_NEWS+SITE_SET_TENCENT_VIDEO+SITE_SET_MOBILE_UNION+SITE_SET_KANDIAN+SITE_SET_QQ_MUSIC_GAME 的组合，[枚举详情]
bid_mode_list	enum[]	支持的出价方式，[枚举详情]
unsupport_billing_spec_list	struct[]	不支持的计费信息
site_set	enum[]	投放版位集合，当前单版位或者 SITE_SET_TENCENT_NEWS+SITE_SET_TENCENT_VIDEO+SITE_SET_MOBILE_UNION+SITE_SET_KANDIAN+SITE_SET_QQ_MUSIC_GAME 的组合，[枚举详情]
billing_event	enum	计费方式，[枚举详情]
min_price	integer	最低出价，单位分
max_price	integer	最高出价，单位分
unsupport_type	enum	不支持类型，[枚举详情]

curl --location --request GET '/v1.3/adcreative_template/get' \ --header 'access_token;' \ --header 'timestamp;' \ --header 'nonce;' \ --header 'fields;' \ --data-urlencode 'account_id=<ACCOUNT_ID>' \ --data-urlencode 'site_set=[]' \ --data-urlencode 'adcreative_template_id=<ADCREATIVE_TEMPLATE_ID>'

{ "code": 0, "message": "", "message_cn": "", "data": { "list": [ { "adcreative_template_id": "<ADCREATIVE_TEMPLATE_ID>", "site_set": [], "support_billing_spec_list": [], "support_bid_mode_list": [], "adcreative_elements": [ { "enum_property": { "enumeration": [] }, "array_property": [], "struct_property": [], "restriction": { "text_restriction": [], "image_restriction": { "file_format": [] }, "url_restriction": [], "video_restriction": { "file_format": [] }, "number_restriction": [] } } ], "landing_page_config": { "support_page_type_list": [ { "support_link_name_type": { "list": [] }, "support_link_page_type": { "list": [] } } ] }, "adcreative_attributes": [ { "property_detail": { "string_detail": [], "integer_detail": [], "enum_detail": { "enumeration": [] }, "struct_detail": { "element_list": [ { "property_detail": { "string_detail": [], "integer_detail": [], "enum_detail": { "enumeration": [] }, "array_restriction": [] } } ] }, "array_restriction": [] } } ], "support_dynamic_ability_spec_list": { "dynamic_ability_type": [], "product_item_display_quantity": [] }, "unsupport_siteset_detail_spec": [ { "site_set": [] } ], "unsupport_bid_mode_list": [ { "site_set": [], "bid_mode_list": [] } ], "unsupport_billing_spec_list": [ { "site_set": [] } ] } ] } }

请求参数

Header 参数

access_token

string

必需

以Query Parameter方式在请求路径中传递。授权令牌，完成 OAuth 2.0 授权后获得，参考授权认证章节。

默认值:

<ACCESS_TOKEN>

timestamp

string

必需

以Query Parameter方式在请求路径中传递。当前的时间戳，单位为秒，允许客户端请求最大时间误差为300秒。
MarketingAPI 所使用的时间戳，若无特殊说明，均为秒级时间戳
MarketingAPI 所使用的时区为GMT+8，例如当时间戳为1494840119时，表示 2018-05-15 17:21:59

默认值:

nonce

string

必需

以Query Parameter方式在请求路径中传递。随机字串标识，不超过32个字符，由调用方自行生成，需保证全局唯一性。

默认值:

<NONCE>

fields

string

必需

指定返回的字段列表，为选填字段，如不填写，则根据默认值进行返回

Body 参数application/x-www-form-urlencoded

account_id

integer

必需

广告主帐号 id，有操作权限的帐号 id，不支持代理商 id

示例值:

<ACCOUNT_ID>

site_set

string

可选

投放版位集合，当前单版位或者 SITE_SET_TENCENT_NEWS+SITE_SET_TENCENT_VIDEO+SITE_SET_MOBILE_UNION+SITE_SET_KANDIAN+SITE_SET_QQ_MUSIC_GAME 的组合，[枚举详情]
数组最小长度 1，最大长度 32
枚举列表：{ 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 }

示例值:

[]

adcreative_template_id

integer

创意形式 id

可选

示例值:

<ADCREATIVE_TEMPLATE_ID>

application/json

Body

code

integer

必需

message

string

必需

message_cn

string

必需

data

object

必需

list

array [object {11}]

创意规格列表

必需

获取创意规格详情

请求参数#

应答字段#

请求参数

返回响应

请求参数

应答字段