禁用或启用升级版 Smart+ 广告中的创意

此接口可用于禁用或启用升级版 Smart+ 广告中的一个或多个创意。

请求

地址 https://business-api.tiktok.com/open_api/v1.3/smart_plus/ad/material_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。|
|smart_plus_ad_id {必填}|string|广告 ID。<br><br>若想获取广告 ID，需使用 [/smart_plus/ad/get/](1843317378982914.html) 接口。|
|ad_material_ids {必填}|string[]|待执行操作的创意的广告素材 ID 列表。<br>广告素材 ID 是在广告中使用特定创意时生成的广告特定素材 ID。<br>此 ID 不同于你将创意上传到广告账号的创意素材库时收到的创意 ID。<br><br>若想获取广告相关的广告素材 ID，需使用 [/smart_plus/ad/get/](1843317378982914.html) 接口。<br><br>最大数量：20。<br><br>可执行操作的创意类型包括:<ul><li>（通过 Spark Ads 推送功能创建的） 标准轮播 Spark Ads 广告中的轮播素材</li><li>非 Spark Ads 广告中的轮播素材</li><li>非 Spark Ads 广告中的视频</li><li>（通过 Spark Ads 推送功能创建的） Spark Ads 中的视频</li><li>（通过 Spark Ads 提取功能创建的）Spark Ads 中的 TikTok 视频帖子</li><li>（通过 Spark Ads 提取功能创建的）标准轮播 Spark Ads 中的 TikTok 照片帖子</li></ul><br><font color="darkred"><b>注意</b></font>：不支持在同一次请求中混合传入轮播和非轮播的创意类型。|
|operation_status {必填}|string|对创意执行的操作。<br><br>枚举值：`DISABLE`（暂停）、`ENABLE`（启用）。|

示例

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

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|code|number|返回码。完整返回码列表及描述参见[附录 - 返回码](1737172488964097.html)。|
|message|string|返回信息。更多信息参见[附录 - 返回码](1737172488964097.html)。|
|request_id|string|请求的日志 ID，唯一标识一个请求。|
|data|object|返回数据。|
#|smart_plus_ad_id|string[]|广告 ID。|
#|ad_material_ids|string[]|已执行操作的创意的广告素材 ID 列表。<br>广告素材 ID 是在广告中使用特定创意时生成的广告特定素材 ID。<br>此 ID 不同于你将创意上传到广告账号的创意素材库时收到的创意 ID。|
#|material_status|string|创意的状态。<br><br>枚举值：`DISABLE`（已暂停）、`ENABLE`（已启用）。|

示例

(code Success-Response http)
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "ad_material_ids": [
            "{{ad_material_id}}"
        ],
        "operation_status": "DISABLE",
        "smart_plus_ad_id": "{{smart_plus_ad_id}}"
    }
}
(/code)