工具 API
tcm_
Applies for a creator's authorization to boost a TikTok video for a TikTok Creator Marketplace (TTCM) order or a TikTok One (TTO) Creator Marketplace campaign. The request must use an Access-Token authorized by a TikTok Creator Marketplace account or TTO Creator Marketplace account. This endpoint depends on prior TTCM or TTO Creator Marketplace setup: the video must already be linked to a TTCM order created via /tcm/order/create/v2/ or to a TTO Creator Marketplace campaign created via /tto/tcm/campaign/create/. Relevant video and account IDs can be obtained from related TTCM/TTO endpoints.
调用信息
- 工具标识
- tiktok-ads.tcm_tt_video_apply
- 服务提供方
- TikTok 广告
- 平均响应
- 0 ms
- 近 7 天调用
- 0
输入参数
actionAction to take. `EXTEND` requests that an approved authorization be extended by the number of days in `authorization_days`; for example, if `authorization_days` is 30, the request asks to extend the authorization by 30 days.
authorization_daysRequested authorization validity period in days. Value range: 1-365. Default is 30. Use this field either to specify the validity period for a new authorization request or, when `action` is `EXTEND`, to request extending an approved authorization by the given number of days. The creator chooses the final approved validity period, so the actual validity period can differ from the requested value.
tcm_account_id必填TikTok Creator Marketplace account ID or TTO Creator Marketplace account ID. To obtain the TTO Creator Marketplace account IDs accessible with the provided `Access-Token`, use /tto/oauth2/tcm/.
video_id必填ID of a video created under the creator account. The video must be uploaded, tagged as branded content, and linked either to a TTCM order via the `invite_link` or `campaign_code` created through /tcm/order/create/v2/, or to a TTO Creator Marketplace campaign via the `invite_link` created through /tto/tcm/campaign/create/. You can obtain `video_id` from /tcm/order/get/v2/ or /tcm/report/get/v2/ for TTCM flows, and from /tto/tcm/campaign/ or /tto/tcm/report/ for TTO flows.