作为品牌方获取 TTO 视频关联请求

你可以使用本接口检索 TikTok One（TTO）Creator Marketplace 账号的视频关联请求，即将达人的公开视频关联至 TTO Creator Marketplace 营销活动的请求。

请求

接口 https://business-api.tiktok.com/open_api/v1.3/tto/tcm/campaign/link/status/

方法 GET

Header

|字段{32%}|类型{15%}|描述{53%}|
|---|---|---|
|Access-Token {必填}|string|由 TTO Creator Marketplace 账户授权的访问令牌。<br>详情参见[从 TTO Creator Marketplace 账户获取授权和访问令牌](https://business-api.tiktok.com/portal/docs/obtain-authorization-and-authentication-from-a-tto-creator-marketplace-account/v1.3)。|

参数

|字段{32%}|类型{15%}|描述{53%}|
|--- |--- |--- |
| tto_tcm_account_id {必填} | string | TTO Creator Marketplace 账号的 ID。<br><br>要获取您可以通过 `Access-Token` 访问的账号 ID，请使用接口 [/tto/oauth2/tcm/](1815693478150146.html)。 | 
| campaign_ids | string[] | 用于筛选结果的现有 TTO Creator Marketplace 营销活动 ID 列表。<br><br>要获取 TTO Creator Marketplace 营销活动列表，请使用接口 [/tto/tcm/campaign/](1815693562720258.html)。<br><br>最大数量：50。 |
| handle_names | string[] | 用于筛选结果的达人账号名称列表。<br><br>最大数量：50。 |
| campaign_type | string | TTO Creator Marketplace 营销活动类型。<br><br>枚举值：<br>- `CAMPAIGN`：带有营销活动级别邀请链接的营销活动。<br>- `BRAND_LINK`：带有品牌级别邀请链接的营销活动。<br>如果未指定此字段，将返回所有营销活动。 |
| page | integer | 当前页数。<br><br>默认值：1。取值范围：≥ 1。 |
| page_size | integer | 每页数量。<br><br>默认值：10。取值范围：1-50。 |

示例

(code curl http)
curl --location  --request GET 'https://business-api.tiktok.com/open_api/v1.3/tto/tcm/campaign/link/status/?tto_tcm_account_id={{tto_tcm_account_id}}' \
--header 'Access-Token: {{Access-Token}}'
(/code)

|字段{32%}|类型{15%}|描述{53%}|
|---|---|---|
|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|返回数据。|
#| video_infos | object[] | 视频关联请求的信息。|
##| video_id | string | 请求关联至营销活动的达人公开视频的 ID。|
##| status | string | 请求状态。<br><br>枚举值：<ul><li>`IN_REVIEW`：已发送给达人，等待达人接受或拒绝。</li><li>`APPROVE`：已被达人批准。</li><li>`REJECTED`：已被达人拒绝。</li><li>`REVOKE`：已撤销。</li></ul>|
##| campaign_id | string | TTO Creator Marketplace　营销活动的 ID。|
##| last_reminded_timestamp | string | 上次向达人发送关联请求或提醒通知的时间，采用 [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) 格式。<br><br>示例：`2025-01-01T00:00:01Z`。|
##| number_of_requests | number | 向达人发送的将此视频（`video_id`）关联至此营销活动（`campaign_id`）的请求次数。<br><br>示例：1。|
##| campaign_type | string | TTO Creator Marketplace 营销活动类型。<br><br>枚举值：<ul><li>`CAMPAIGN`：带有营销活动层级邀请链接的营销活动。</li><li>`BRAND_LINK`：带有品牌层级邀请链接的营销活动。</li></ul>|
##| link_request_id | string | 关联请求的 ID。<br><br>您可以将该 ID 分享给被邀请的达人，由达人通过 [/tto/creator/link/request/confirm/](1837247744649345.html) 接受或拒绝请求。|
#| page_info | object | 分页信息。|
##| page | integer | 当前页数。|
##| page_size | integer | 当前页大小。|
##| total_page | integer | 总页数。|
##| total_number | integer | 营销活动总数。|

示例

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "page_info": {
            "page": 1,
            "page_size": 10,
            "total_number": 2,
            "total_size": 1
        },
        "video_infos": [
            {
                "campaign_id": "{{campaign_id}}",
                "last_reminded_timestamp": "2025-02-07T21:44:57Z",
                "number_of_requests": 1,
                "status": "APPROVE",
                "campaign_type": "CAMPAIGN",
                "video_id": "{{video_id}}"
            },
            {
                "campaign_id": "{{campaign_id}}",
                "last_reminded_timestamp": "2025-02-07T21:12:44Z",
                "number_of_requests": 1,
                "status": "REVOKE",
                "campaign_type": "CAMPAIGN",
                "video_id": "{{video_id}}"
            }
        ]
    }
}
(/code)