批量修改广告创意

批量修改广告创意，支持同时修改多个创意的字段信息，每次最多支持10个创意。每个创意的可修改字段与修改广告创意接口一致。

请求地址

https://openapi.aiclk.com/openapi/v2/creative/batch-update-v2

所属权限

ads_write

请求方式

POST

Header: Content-Type: application/json

请求参数

URL中携带参数：

字段名	类型	是否必须	描述
account_id	int	是	广告主ID(广告投放平台的userID)

Post body（json）

json体是一个列表结构，列表最多包含10个元素，不允许出现重复的creative_id。列表中的每一个元素结构如下：

公共参数

字段名	类型	是否必须	描述
creative_id	int	是	创意ID
creative_name	string	否	创意名称
configure_status	string	否	状态，允许值：ENABLE, PAUSED, DELETED

第三方监测参数

字段名	类型	是否必须	描述
click_feedback_url	string	否	点击监控链接，多个监控链接之间用英文空格分隔，最多支持填写50个
api_id	int	否	api监控链接的ID

落地页与建站参数

字段名	类型	是否必须	描述
target_url	string	否	落地页链接
target_url_h5	string	否	落地页链接（应用推广）
target_type	string	否	建站类型，使用建站时必填。允许值：鲸鱼建站-WHALE、赤兔建站-CHITU
clk_site_id	int	否	建站ID，使用建站时必填
deep_link	string	否	deeplink链接
universal_link	string	否	universal_link链接

素材与文案参数

字段名	类型	是否必须	描述
title	string	否	标题
second_title	string	否	副标题
description	string	否	创意描述
image	[]int	否	图片信息，格式见字段示例
video_id	int	否	视频ID
app_logo	string	否	APP的logo链接
app_name	string	否	APP名称

备注：

更多字段说明及各推广分类下的字段要求，请参考修改广告创意接口文档。

Body 示例

[
    {
        "creative_id": 3994457,
        "creative_name": "修改创意名称1",
        "configure_status": "PAUSED"
    },
    {
        "creative_id": 3994458,
        "title": "新的标题文案",
        "click_feedback_url": "https://example.com/click"
    }
]

请求示例

curl -X POST \
  'https://openapi.aiclk.com/openapi/v2/creative/batch-update-v2?account_id=1000009' \
  -H 'Content-Type: application/json' \
  -H 'OGW_ACCESS_TOKEN: your_access_token' \
  -d '[{"creative_id":3994457,"creative_name":"修改创意名称","configure_status":"PAUSED"},{"creative_id":3994458,"title":"新的标题文案"}]'

返回字段释义

字段名	类型	描述
code	int	返回码
message	string	返回信息
data	object	更新结果
-success_ids	[]int	更新成功的创意ID列表
-errors	[]object	更新失败的创意信息列表
--creative_id	int	更新失败的创意ID
--message	string	失败原因

返回示例

全部成功

{
    "code": 200,
    "message": "success",
    "data": {
        "success_ids": [3994457, 3994458],
        "errors": []
    }
}

部分成功

{
    "code": 200,
    "message": "success",
    "data": {
        "success_ids": [3994457],
        "errors": [
            {
                "creative_id": 3994458,
                "message": "创意不存在"
            }
        ]
    }
}