跳转至

广告计划修改

对广告计划关键字段进行修改

请求地址

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"
}