批量更新单元状态

批量更新单元状态

请求地址

https://openapi.aiclk.com/openapi/v1/adgroup/batch-update-status

所属权限

ads_write

请求方式

POST

请求参数

字段名	类型	是否必须	描述
account_id	int	是	广告主ID(广告投放平台的userID)

Post body（json）

json体是一个列表结构，列表中的每一个元素结构如下：

字段名	类型	是否必须	描述
adgroup_ids	[]int	是	广告单元ID列表
configure_status	string	是	单元更改的目标状态

query示例

{
    "adgroup_ids":[20194874,20194873],
    "configure_status":"ENABLE"
}

请求示例

curl --location 'https://openapi.aiclk.com/openapi/v1/adgroup/batch-update-status?account_id=1000002' \
--header 'Content-Type: application/json' \
--header 'OGW_ACCESS_TOKEN: your_access_token' \
--data '{"adgroup_ids":[7570525],"configure_status":"DELETED"}'

返回字段释义

字段名	类型	描述
code	int	返回码
message	string	返回信息
data	[]map	更新结果
-adgroup_id	map	单元ID
-status	map	单元状态

返回示例

{
    "code": 200,
    "message": "success",
    "data": [
        {
            "adgroup_id": 20194874,
            "status": "ENABLE"
        },
        {
            "adgroup_id": 20194873,
            "status": "ENABLE"
        }
    ]
}