跳转至

批量更新计划投放状态

批量更新计划投放状态

请求地址

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