工具 API

ad_update

Updates creatives for regular ads, including call-to-action, ad name, text, image, and video material, via `POST /open_api/v1.3/ad/update/`. For Smart Creative ads, use `/ad/aco/update/`. Incremental update mode is supported only when `patch_update=true`, and only for `ad_name`, `identity_id`, `identity_type`, `identity_authorized_bc_id`, `video_id`, `image_ids`, `music_id`, `tiktok_item_id`, `ad_text`, and `ad_texts`. All other fields use full-update semantics: send all required values for the ad or unspecified fields may be overwritten to null. Creating non-Spark Ads using Custom Identities in ad groups delivering to Automatic Placement or Select Placement when TikTok is included is no longer supported for existing ad accounts. All new ad accounts created on or after January 15, 2026 cannot create non-Spark Ads using Custom Identities for these placements. Existing ads remain unaffected and editable. Campaigns delivering only to Pangle or Global App Bundle placements are not affected by this Custom Identity deprecation.

ecommerceOAuth1 积分

调用信息

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

输入参数

adgroup_id必填

Ad group ID.

advertiser_id必填

Advertiser ID.

creatives必填

Advertising creatives to update. Max size: 20.

patch_update

Whether to use incremental update mode. Supported only for `ad_name`, `identity_id`, `identity_type`, `identity_authorized_bc_id`, `video_id`, `image_ids`, `music_id`, `tiktok_item_id`, `ad_text`, and `ad_texts`. For example, to update only the ad name, set `patch_update=true`, pass the new `ad_name`, and include required fields such as the headers, `advertiser_id`, and `ad_id`. For all other fields, this endpoint uses full update mode; sending partial data can overwrite unspecified fields to null. TikTok recommends thorough testing before enabling incremental mode.