作为达人将视频关联至 TTO Creator Marketplace 营销活动

你可以使用本接口作为 TikTok 达人将视频关联到 TikTok One (TTO) Creator Marketplace 推广系列。

请求

地址 https://business-api.tiktok.com/open_api/v1.3/tto/creator/campaign/video/link/

方法 POST

Header

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|Access-Token {必填}|string|经 TikTok 达人授权的访问令牌。<br>使用 [/tt_user/oauth2/token/](https://business-api.tiktok.com/portal/docs/get-renew-or-revoke-a-creator-access-token/v1.3#item-link-获取创作者访问令牌) 或 [/tt_user/oauth2/refresh_token/](https://business-api.tiktok.com/portal/docs/get-renew-or-revoke-a-creator-access-token/v1.3#item-link-刷新创作者访问令牌) 接口获取或刷新访问令牌。||
|Content-Type {必填}|string|请求信息类型。<br>允许格式：`application/json`。 |

参数

|字段{30%}|类型{15%}|描述{55%}|
|--- |--- |--- |
|creator_id {必填}|string|TikTok 账号的开发者应用唯一识别 ID。<br><br>需将 [/tt_user/oauth2/token/](https://business-api.tiktok.com/portal/docs?id=1768493902119937#item-link-Obtain%20a%20Creator%20access%20token) 或 [/tt_user/oauth2/refresh_token/ ](https://business-api.tiktok.com/portal/docs?id=1768493902119937#item-link-Renew%20a%20Creator%20access%20token)接口返回的 `open_id` 字段值传入本字段。|
| tto_invite_link {必填} | string | 与 TTO Creator Marketplace 推广系列关联的邀请链接。<br><br>若想创建 TTO Creator Marketplace 推广系列并获取关联的邀请链接，需使用 [/tto/tcm/campaign/create/](1815693549459458.html) 接口。 <br><br><p><span style="color:darkred"><b>注意</b></span>： <ul><li> 如果邀请链接属于推广系列层级（关联推广系列的 `campaign_type` 为 `CAMPAIGN`），达人应为受邀加入该推广系列的达人之一。若想确认这一点，需使用[ /tto/tcm/campaign/](1815693562720258.html) 接口，并查看返回的 `handle_names` 是否包含该达人的用户名 (`creator_id`)。</li><li> 如果邀请链接属于品牌层级（关联推广系列的 `campaign_type` 为 `BRAND`），达人可为任意 TTO 达人。</li></ul> |
| video_id{必填}  | string | TTO 达人发布的视频的 ID。<br><br>若想获取 TTO 达人所发布视频的列表，需使用 [/tto/creator/authorized/video/list/](1834913554657282.html) 接口。<br>若想通过 TTO 达人的 TikTok 账号发布视频帖子，需使用 [/business/video/publish/](1762228496095234.html) 接口。<br><br><p><span style="color:darkred"><b>注意</b></span>：此 ID 不能是已关联现有 TTO Creator Marketplace 推广系列的视频的 ID。|

示例

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/tto/creator/campaign/video/link/' \
--header 'Access-Token: "{{Access-Token}}"' \
--header 'Content-Type: application/json' \
--data '{
    "creator_id": "{{creator_id}}",
    "tto_invite_link": "{{tto_invite_link}}",
    "video_id": "{{video_id}}"
}'
(/code)

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|code |number|返回码。完整返回码列表及描述参见[附录 - 返回码](1737172488964097.html)。|
|message|string|返回信息。更多信息参见[附录 - 返回码](1737172488964097.html)。|
|request_id |string|请求的日志 ID，唯一标识一个请求。 |
|data |object|返回数据。<br> <br>如果请求成功，此字段将为空对象 (`{}`)。|

示例

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