在商品 GMV Max 推广系列中移除或加回创意

你可以使用本接口在商品或直播 GMV Max 推广系列中移除创意（视频）或加回之前移除的创意。

请求

地址 https://business-api.tiktok.com/open_api/v1.3/campaign/gmv_max/creative/update/

方法 POST

Header

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

参数

|字段{35%}|类型{15%}|描述{50%}|
|---|---|---|
|advertiser_id {必填}|string|广告主 ID。|
|campaign_id {必填}|string|推广系列 ID。<br><br><font color="darkred"><b>注意</b></font>:<ul><li>推广系列必须处于投放中状态。如需获取您的广告账户中投放中的 GMV Max 推广系列，可使用 [/gmv_max/report/get/](1824721673497601.html) 接口，并将 `filtering` 设置为 `&#123;"campaign_statuses":&#91;"STATUS_DELIVERY_OK"&#93;&#125;`。</li><li>若是商品 GMV Max 推广系列，推广系列的 `product_video_specific_type` 必须为 `AUTO_SELECTION`。</li></ul>|
|action {必填}|string|要执行的操作类型。<br><br>枚举值:<ul><li>`REMOVE`：从 GMV Max 推广系列中移除创意。</li><li>`ADD`：将先前移除的创意加回到 GMV Max 推广系列中。</li></ul><br><font color="darkred"><b>注意</b></font>:<ul><li>执行操作后，需等待 20 分钟，再使用 [/gmv_max/report/get/](1824721673497601.html) 接口验证更新后的状态。</li><li>如果创意成功从商品 GMV Max 推广系列中移除，其在 [/gmv_max/report/get/](1824721673497601.html) 中的 `creative_delivery_status` 将变为 `EXCLUDED`。</li></ul>|
|item_list {必填}|object[]|要操作的 TikTok 帖子（视频）列表。<br><br>最大数量：400。<br><br><font color="darkred"><b>注意</b></font>:<ul><li>本接口支持从 GMV Max 推广系列中最多移除 10,000 个帖子，每次请求最多可移除 400 个。</li><li>例如，如果需要排除 800 个帖子，可以先发送一个包含 400 个帖子的请求，再发送第二个请求以移除剩余的 400 个。</li></ul>|
#|item_id {必填}|string|要操作的 TikTok 帖子 ID。<ul><li>当 `action` 为 `REMOVE` 时，可使用 [/gmv_max/report/get/](1824721673497601.html) 接口，并将 `filtering` 设置为 `&#123;"creative_delivery_statuses":&#91;"IN_QUEUE","LEARNING","DELIVERING","NOT_DELIVERYING","UNAVAILABLE","NOT_ACTIVE"&#93;&#125;`，以获取符合条件的创意。</li><li>当 `action` 为 `ADD` 时，请使用 [/gmv_max/report/get/](1824721673497601.html) 接口，并将 `filtering` 设置为 `&#123;"creative_delivery_statuses":&#91;"EXCLUDED"&#93;&#125;`，以获取先前移除的创意。</li></ul><br><font color="darkred"><b>注意</b></font>: 目前直播 GMV Max 推广系列中 TikTok 帖子的 `item_id` 仅支持通过 TikTok 广告管理平台获取。|
#|spu_id_list {+条件必填}|string[]|指定商品 GMV Max 推广系列时必填。<br><br>与 TikTok 帖子关联的商品 SPU ID 列表。<br><br>如需获取与商品 GMV Max 推广系列中的 TikTok 帖子关联的商品 SPU ID 列表，可使用 [/campaign/gmv_max/info/](1822000968821762.html) 接口。|

示例

移除创意

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/campaign/gmv_max/creative/update/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "campaign_id": "{{campaign_id}}",
    "item_list": [
        {
            "item_id": "{{item_id}}",
            "spu_id_list": ["{{spu_id}}"]
        },
        {
            "item_id": "{{item_id}}",
            "spu_id_list": ["{{spu_id}}"]
        }
    ],
    "action": "REMOVE"
}'
(/code)

加回创意

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/campaign/gmv_max/creative/update/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "campaign_id": "{{campaign_id}}",
    "item_list": [
        {
            "item_id": "{{item_id}}",
            "spu_id_list": ["{{spu_id}}"]
        },
        {
            "item_id": "{{item_id}}",
            "spu_id_list": ["{{spu_id}}"]
        }
    ],
    "action": "ADD"
}'
(/code)

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|code |number|返回码。完整返回码列表及描述，可查看[附录 - 返回码](https://business-api.tiktok.com/portal/docs/return-codes-appendix/v1.3)。|
|message |string|返回信息。更多信息可查看[附录 - 返回码](https://business-api.tiktok.com/portal/docs/return-codes-appendix/v1.3)。|
|request_id|string|请求的日志 ID，唯一标识一个请求。|
|data|object|返回数据。|

示例

(code curl http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {}
}
(/code)