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