工具 API

gmv_max_creative_update

Removes creatives (TikTok posts/videos) from a Product or Live GMV Max Campaign, or adds back creatives that were previously removed. The campaign must be active; to find active GMV Max campaigns, use /gmv_max/report/get/ with `filtering` set to `{"campaign_statuses":["STATUS_DELIVERY_OK"]}`. For Product GMV Max Campaigns, the campaign's `product_video_specific_type` must be `AUTO_SELECTION`. After submitting `REMOVE` or `ADD`, wait 20 minutes before checking updated statuses in /gmv_max/report/get/. If a creative is successfully removed from a Product GMV Max Campaign, its `creative_delivery_status` in /gmv_max/report/get/ becomes `EXCLUDED`.

ecommerceOAuth1 积分

调用信息

工具标识
tiktok-ads.gmv_max_creative_update
服务提供方
TikTok 广告
平均响应
0 ms
近 7 天调用
0

输入参数

action必填

Action to perform on the listed creatives. `REMOVE` removes creatives from the GMV Max Campaign. `ADD` adds back creatives that were previously removed. After the action is performed, wait 20 minutes before verifying the updated statuses using /gmv_max/report/get/. If a creative is successfully removed from a Product GMV Max Campaign, its `creative_delivery_status` in /gmv_max/report/get/ will be `EXCLUDED`.

advertiser_id必填

Advertiser ID.

campaign_id必填

ID of the GMV Max campaign to update. The campaign must be in active status. To retrieve active GMV Max Campaigns, use /gmv_max/report/get/ with `filtering` set to `{"campaign_statuses":["STATUS_DELIVERY_OK"]}`. If this is a Product GMV Max Campaign, the campaign's `product_video_specific_type` must be `AUTO_SELECTION`.

item_list必填

List of TikTok posts (videos) to remove or add back. Maximum 400 items per request. This endpoint allows removal of up to 10,000 posts from a GMV Max Campaign, with a limit of 400 posts per request. For example, to exclude 800 posts, send two requests with 400 posts each.