批量更新计划投放状态
批量更新计划投放状态
请求地址
https://openapi.aiclk.com/openapi/v1/campaign/batch-update-status
所属权限
ads_write
请求方式
POST
请求参数
| 字段名 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| account_id | int | 是 | 广告主ID(广告投放平台的userID) |
Post body(json)
json体是一个列表结构,列表中的每一个元素结构如下:
| 字段名 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| campaign_ids | []int | 是 | 广告计划ID列表 |
| configure_status | string | 是 | 计划更改的目标状态 |
query示例
{
"configure_status":"DELETED",
"campaign_ids":[2092886,2092889]
}
请求示例
curl --location 'https://openapi.aiclk.com/openapi/v1/campaign/batch-update-status?account_id=1000002' \
--header 'Content-Type: application/json' \
--header 'OGW_ACCESS_TOKEN: your_access_token' \
--data '{"campaign_ids":[5018149,5012903,4946617],"configure_status":"PAUSED"}'
返回字段释义
| 字段名 | 类型 | 描述 |
|---|---|---|
| code | int | 返回码 |
| message | string | 返回信息 |
| data | map | 更新结果,json结构,key表示计划ID,value表示计划状态 |
返回示例
{
"code": 200,
"message": "success",
"data": {
"2092886": "DELETED"
}
}