创建模板预览接口

请求参数

标有*的参数为必填项

名称	类型	描述
account_id*	integer	广告主帐号 id
ad_metadata*	struct	广告元数据
product_infos	struct[]	商品标签信息列表，数组长度为[0,100] 数组最小长度 0，最大长度 100
catalog_id	integer	商品库 id
product_outer_id	string	商品 id 字段长度最小 0 字节，长度最大 1024 字节
site_sets	enum[]	投放版位集合，当前单版位或者 SITE_SET_TENCENT_NEWS+SITE_SET_TENCENT_VIDEO+SITE_SET_MOBILE_UNION+SITE_SET_MOBILE_INNER+SITE_SET_KANDIAN+SITE_SET_QQ_MUSIC_GAME 的组合，[枚举详情] 数组最小长度 0，最大长度 100 枚举列表：{ 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 }
automatic_site_enabled	boolean	是否开启自动版位可选值：{ true, false }
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_ARTICLE, PROMOTED_OBJECT_TYPE_LEAD_AD, PROMOTED_OBJECT_TYPE_TENCENT_KE, 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 }
bid_mode	enum	出价方式，[枚举详情] 枚举列表：{ BID_MODE_CPC, BID_MODE_CPA, BID_MODE_CPM, BID_MODE_OCPC, BID_MODE_OCPM }
auto_derived_program_creative_switch	boolean	是否开启衍生素材可选值：{ true, false }
standard_switch	boolean	是否开启素材标准化，标准化后返回新的 MediaId 可选值：{ true, false }
create_material_groups*	struct[]	素材组信息列表，数组长度为[0,100] 数组最小长度 0，最大长度 100
materials	struct[]	素材信息列表，数组长度为[0,100] 数组最小长度 0，最大长度 100
type	enum	素材类型，视频或图片，[枚举详情] 枚举列表：{ IMAGE, VIDEO }
media_id	string	素材 id 字段长度最小 0 字节，长度最大 1024 字节

使用说明
1.
使用该接口创建预览信息,会依据目前服务器繁忙程度,对接口调用进行限流(10QPS),当超过限制访问频率后,提交任务会返回失败。

curl --location --request POST '/v1.3/programmed/add?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \ --header 'access_token;' \ --header 'timestamp;' \ --header 'nonce;' \ --header 'fields;' \ --data-urlencode 'account_id=<ACCOUNT_ID>' \ --data-urlencode 'ad_metadata={"product_infos":null,"site_sets":["SITE_SET_TENCENT_NEWS","SITE_SET_TENCENT_VIDEO"],"automatic_site_enabled":false,"promoted_object_type":"PROMOTED_OBJECT_TYPE_LEAD_AD","bid_mode":"BID_MODE_OCPM"}' \ --data-urlencode 'auto_derived_program_creative_switch=true' \ --data-urlencode 'create_material_groups=[{"materials":[{"type":"IMAGE","media_id":"3172332054"}]}]'

创建模板预览接口

请求参数#

请求参数

返回响应

请求参数