更新升级版 Smart+ 广告组的操作状态

此接口可用于启用、暂停或删除升级版 Smart+ 广告组。

请求

地址 https://business-api.tiktok.com/open_api/v1.3/smart_plus/adgroup/status/update/

方法 POST

Header

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。<br>可以通过[获取访问令牌](1738373164380162.html)接口获取。|
|Content-Type {必填}|string|请求消息类型。<br>允许值：`application/json`。|

参数

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|advertiser_id {必填}|string|广告主 ID。|
|adgroup_ids {必填}|string[]|要执行操作的广告组的 ID。<br><br>数量范围：1-20。|
|operation_status {必填}|string|对广告组执行的操作。<br><br>枚举值：`DISABLE`（暂停）、`ENABLE`（启用）、`DELETE`（删除）。<br><br><p><span style="color:darkred"><b>注意</b></span>：无法修改已删除广告组或已删除推广系列中的广告组的状态。|

示例

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/smart_plus/adgroup/status/update/' \
--header 'Access-Token: "{{Access-Token}}"' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "adgroup_ids": ["{{adgroup_id}}","{{adgroup_id}}"],
    "operation_status":"DISABLE"
}'
(/code)

返回

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|code|number|返回码。完整返回码列表及描述参见[附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|message|string|返回信息。更多信息参见[附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|request_id|string|请求的日志 ID，唯一标识一个请求。|
|data|object|返回数据。|
#|adgroup_list|object[]|操作成功的广告组列表。|
##|adgroup_id|string|操作成功的广告组的 ID。|
##|状态|string|操作成功的广告组的当前状态。<br><br>枚举值：`DISABLE`（已暂停）、`ENABLE`（已启用）、`DELETE`（已删除）。|
#|error_list|object[]|包含错误信息及对应的操作失败广告组的列表。|
##|adgroup_id|string|操作失败的广告组的 ID。|
##|error_message|string|与操作失败的广告组相关的报错提示。|

示例

对于成功的更新

(code Success-Response http)
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "adgroup_list": [
            {
                "adgroup_id": "{{adgroup_id}}",
                "status": "DISABLE"
            },
            {
                "adgroup_id": "{{adgroup_id}}",
                "status": "DISABLE"
            }
        ],
        "error_list": []
    }
}
(/code)

对于失败的更新

(code Success-Response http)
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "adgroup_list": [],
        "error_list": [
            {
                "adgroup_id": "{{adgroup_id}}",
                "error_message": "Adgroup does not exist. adgroup_id {{adgroup_id}}."
            }
        ]
    }
}
(/code)