TOOL API
smart_
Disables or enables one or more creatives in an Upgraded Smart+ Ad via `/smart_plus/ad/material_status/update/`. You must provide the target ad and the ad-specific material IDs associated with that ad. Ad IDs and associated ad material IDs can be obtained from `/smart_plus/ad/get/`.
Call information
- Tool slug
- tiktok-ads.smart_plus_ad_material_status_update
- Provider
- TikTok for Business
- Average response
- 0 ms
- Calls in 7 days
- 0
Input parameters
ad_material_idsrequiredList of ad material IDs for the creatives to operate on. An ad material ID is an ad-specific material ID generated when a particular creative is used in an ad, and it differs from the creative ID from the ad account Creative Library. To obtain ad material IDs associated with the specified ad, use `/smart_plus/ad/get/`. Max size: 20. Supported creative types are: carousels from Standard Carousel Spark Ads (via Spark Ads Push), carousels from non-Spark Ad Standard Carousels, videos from non-Spark Ads, videos from Spark Ads (via Spark Ads Push), TikTok video posts used as Spark Ad Videos (via Spark Ads Pull), and TikTok photo posts used as Standard Carousel Spark Ads (via Spark Ads Pull). You cannot mix carousel and non-carousel creative types in the same request.
advertiser_idrequiredAdvertiser ID.
operation_statusrequiredOperation to perform on the specified creatives: `DISABLE` pauses them, and `ENABLE` enables them.
smart_plus_ad_idrequiredAd ID for the Upgraded Smart+ Ad whose creatives you want to enable or disable. To obtain valid ad IDs, use `/smart_plus/ad/get/`.