获取模板列表接口

请求参数

标有*的参数为必填项

名称	类型	描述
account_id*	integer	广告主帐号 id
material_derive_id*	integer	预览 id
material_group_id*	integer	素材组 id
material_derive_preview_id*	integer	素材预览 id
template_id_list	array	模板 id 列表列表，数组长度为[0,100] 数组最小长度 0，最大长度 100
key_word	string	搜索名称字段长度最小 0 字节，长度最大 1024 字节
sort_by	struct[]	排序列表，数组长度为[0,100] 数组最小长度 0，最大长度 100
field	enum	排序条件字段，最新上传：derive_on_first_time，消耗：template_stat.cost，点击率：template_stat.click_rate，使用量：template_stat.use_cnt，[枚举详情] 枚举列表：{ derive_on_first_time, template_stat.cost, template_stat.click_rate, template_stat.use_cnt }
desc	enum	默认降序：DESC，升序：ASC，[枚举详情] 枚举列表：{ DESC, ASC }
page_info	struct	排序
page	integer	页码,最小为 1
rows	integer	页大小
total	integer	总数

使用说明
1.
使用该接口获取模板列表信息,会依据目前服务器繁忙程度,对接口调用进行限流,当超过限制访问频率后,提交任务会返回失败。

curl --location --request POST '/v1.3/programmed_template/get' \ --header 'access_token;' \ --header 'timestamp;' \ --header 'nonce;' \ --data-urlencode 'account_id=<ACCOUNT_ID>' \ --data-urlencode 'material_derive_id=2449' \ --data-urlencode 'material_group_id=11651' \ --data-urlencode 'material_derive_preview_id=4281' \ --data-urlencode 'template_id_list=[]' \ --data-urlencode 'sort_by=[]' \ --data-urlencode 'page_info={"page":1,"rows":20,"total":1}'

{ "code": 0, "message": "", "message_cn": "", "data": { "template_infos": [ { "id": 100231348, "type": 1, "name": "test1234", "image_url": "http://p.qpic.cn/gdt_venus", "video_url": "", "width": 800, "height": 800, "duration": 0, "use_cnt": 0, "cost": 0, "click_rate": 0, "conversion_rate": 0, "conversion_cost": 0 } ], "page_info": { "page": 1, "rows": 20, "total": 1 } } }

获取模板列表接口

请求参数#

请求参数

返回响应

请求参数