跳转至

批量更新创意状态

批量更新创意状态

请求地址

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