更新模板预览接口
开发环境
开发环境
POST
/v1.3/programmed/update
请求参数
| 名称 | 类型 | 描述 |
|---|---|---|
| account_id* | integer | 广告主帐号 id |
| material_derive_id* | integer | 预览 id |
| auto_derived_program_creative_switch | boolean | 是否开启衍生素材 可选值：{ true, false } |
| standard_switch | boolean | 是否开启素材标准化，标准化后返回新的 MediaId 可选值：{ true, false } |
| update_material_groups | struct[] | 素材组信息列表，数组长度为[0,100] 数组最小长度 0，最大长度 100 |
| material_group_id | integer | 素材组 id |
| materials | struct[] | 素材信息列表，数组长度为[0,100] 数组最小长度 0，最大长度 100 |
| type | enum | 素材类型，视频或图片，[枚举详情] 枚举列表：{ IMAGE, VIDEO } |
| media_id | string | 素材 id 字段长度最小 0 字节，长度最大 1024 字节 |
| previews | struct[] | 预览数据列表，数组长度为[0,100] 数组最小长度 0，最大长度 100 |
| material_derive_preview_id | integer | 素材预览 id |
| template_id | integer | 模板 id |
| creative_template_id | integer | 预览素材的创意形式 id |
使用说明 1.使用该接口更新预览信息,会依据目前服务器繁忙程度,对接口调用进行限流(10QPS),当超过限制访问频率后,提交任务会返回失败。
请求参数
Header 参数
Body 参数application/x-www-form-urlencoded
返回响应
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/v1.3/programmed/update' \
--header 'access_token: <ACCESS_TOKEN>' \
--header 'timestamp: <TIMESTAMP>' \
--header 'nonce: <NONCE>' \
--data-urlencode 'account_id=<ACCOUNT_ID>' \
--data-urlencode 'material_derive_id=2479' \
--data-urlencode 'auto_derived_program_creative_switch=true' \
--data-urlencode 'update_material_groups=[{"material_group_id":11698,"materials":[{"type":"IMAGE","media_id":"3172332054"}],"previews":[{"material_derive_preview_id":4332,"template_id":11425495,"creative_template_id":711}]}]'响应示例响应示例
{
"code": 0,
"message": "",
"message_cn": "",
"data": {
"material_derive_id": 2479
}
}修改于 2023-11-07 03:37:57