申请 Spark Ads 授权

你可以使用本接口发送请求，申请 TikTok 达人的授权，以在 TikTok One (TTO) Creator Marketplace 营销活动中推广其视频。

请求

地址 https://business-api.tiktok.com/open_api/v1.3/tcm/tt_video/apply/

方法 POST

Header

|字段|类型|描述|
|---|---|---|
|Access-Token {必填}|string|由 TTO Creator Marketplace 账户授权的[访问令牌](https://business-api.tiktok.com/portal/docs/obtain-authorization-and-authentication-from-a-tto-creator-marketplace-account/v1.3)。|
|Content-Type {必填}|string|请求消息类型。<br>允许格式：`application/json`。|

参数

|字段|类型|描述|
|---|---|---|
|video_id {必填}|string| 在达人账号下创建的视频的 ID。<br><br>该视频需要满足以下要求：<ul><li>该视频已上传并标记为品牌内容，并且达人已通过由 [/tto/tcm/campaign/create/](1815693549459458.html) 生成的邀请链接(`invite_link`)将视频与一个 TTO Creator Marketplace 营销活动绑定。<ul><li>可以通过 [/tto/tcm/campaign/](1815693562720258.html) 或 [/tto/tcm/report/](1815693573340162.html) 获取 `video_id`。</li></ul></li></ul>|
|tcm_account_id {必填}|string|TTO Creator Marketplace 账户 ID。|
|authorization_days |number|授权的有效期（按天计）。<br><br>枚举值：7、30、60、365。<br>默认值：30。<br><br><p><span style="color:darkred"><b>注意</b></span>：本字段可在申请授权时指定授权的有效期，或用于申请更新已批准授权的有效期。<br>实际有效期可能不同于您申请的有效期，因为创作者在批准申请时可自行选择任意有效期（7, 30, 60, 365）。|
|action|string|要执行的操作。<br><br>枚举值：<ul><li>`EXTEND`：按指定天数（`authorization_days`）延长授权的有效期。例如，当 `authorization_days` 为 30 时，你将请求将授权延长 30 天。</li></ul>|

示例

(code curl http)
curl --location  --request GET 'https://business-api.tiktok.com/open_api/v1.3/tcm/tt_video/apply/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "tcm_account_id":"{{tcm_account_id}}",
    "video_id":"{{video_id}}",
    "authorization_days": 30
}'
(/code)

返回

|字段|类型|描述|
|---|---|---|
|code |number|返回码。完整返回码列表及描述，可查看[附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|message |string|返回信息。更多信息可查看[附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|request_id|string|请求的日志 ID，唯一标识一个请求。|
|data|object|返回数据。|

示例

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