广告计划修改
对广告计划关键字段进行修改
请求地址
https://openapi.aiclk.com/openapi/v1/campaign/update
所属权限
ads_write
请求方式
POST
Header: Content-Type: application/json
请求参数
请求Url中添加参数:
| 字段名 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| account_id | int | 是 | 广告主ID(广告投放平台的userID) |
Post-Body添加参数:
| 字段名 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| 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" : "修改计划名称",
"start_date" : "2020-01-02",
"end_date" : "2020-01-02",
"configure_status": "ENABLE",
"budget" : 50002
}
请求示例
curl -X POST \
'https://openapi.aiclk.com/openapi/v1/campaign/update?account_id=1000009' \
-H 'Content-Type: application/json' \
-H 'OGW_ACCESS_TOKEN: your_access_token' \
-d '{"campaign_id":2092669,"campaign_name":"修改计划名称","configure_status":"ENABLE","start_date":"2020-01-01","end_date":"2020-01-01","budget":50002}'
返回字段释义
| 字段名 | 类型 | 描述 |
|---|---|---|
| code | int | 返回码 |
| message | string | 接口信息 |
| data | object | 返回值 |
返回示例
{
"code":200,
"data":null,
"message":"success"
}