批量修改广告计划

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

请求地址

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

所属权限

ads_write

请求方式

POST

Header: Content-Type: application/json

请求参数

请求Url中添加参数：

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

Post body（json）

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

字段名	类型	是否必须	描述
campaign_id	int	是	计划ID
campaign_name	string	否	计划名称
configure_status	string	否	计划状态，允许值：ENABLE, PAUSED, DELETED 删除状态的计划不能使用该接口再次更改状态
start_date	string	否	投放开始日期，示例：2020-01-01
end_date	string	否	投放结束日期，示例：2020-01-01
budget	int	否	计划日预算，单位：分，范围：100元-5000000元
tomorrow_budget	int	否	明日预算，单位：分，范围：100元-5000000元 值为0代表关闭

备注：

广告计划结束日期不能早于当前日期；
广告计划投放结束日期不能早于投放开始日期；
广告计划投放日期区间需在开始日期起的三年内；
广告计划投放开始日期不能早于当前日期。

Body 示例

[
    {
        "campaign_id": 2092669,
        "campaign_name": "修改计划名称1",
        "configure_status": "ENABLE",
        "budget": 50002
    },
    {
        "campaign_id": 2092670,
        "start_date": "2020-01-02",
        "end_date": "2020-06-01"
    }
]

请求示例

curl -X POST \
  'https://openapi.aiclk.com/openapi/v2/campaign/batch-update-v2?account_id=1000009' \
  -H 'Content-Type: application/json' \
  -H 'OGW_ACCESS_TOKEN: your_access_token' \
  -d '[{"campaign_id":2092669,"campaign_name":"修改计划名称","configure_status":"ENABLE","budget":50002},{"campaign_id":2092670,"start_date":"2020-01-02","end_date":"2020-06-01"}]'

返回字段释义

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

返回示例

全部成功

{
    "code": 200,
    "message": "success",
    "data": {
        "success_ids": [2092669, 2092670],
        "errors": []
    }
}

部分成功

{
    "code": 200,
    "message": "success",
    "data": {
        "success_ids": [2092669],
        "errors": [
            {
                "campaign_id": 2092670,
                "message": "计划不存在"
            }
        ]
    }
}