获取 TTO Creator Marketplace 账户详情
你可以使用本接口检索 TikTok One(TTO)Creator Marketplace 账户的详细信息。
请求
地址 https://business-api.tiktok.com/open_api/v1.3/tto/oauth2/info/
方法 GET
Header
|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|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)。|
参数
|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|tto_tcm_account_id {必填}|string|TTO Creator Marketplace 账户的 ID。<br><br>要获取通过访问令牌 `Access-Token` 可访问的账户 ID,使用接口 [/tto/oauth2/tcm/](1815693478150146.html)。|
示例
(code curl http)
curl --location --request GET 'https://business-api.tiktok.com/open_api/v1.3/tto/oauth2/info/?tto_tcm_account_id={{tto_tcm_account_id}}' \
--header 'Access-Token: {{Access-Token}}'
(/code)
返回
|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|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|返回数据。|
#|tto_tcm_account_id|string|TTO Creator Marketplace 账户的 ID。|
#|account_name|string|TTO Creator Marketplace 账户的名称。|
#|timezone|string|TTO Creator Marketplace 账户的时区代码。<br><br>示例:`America/Los_Angeles`。<br><br>有关时区代码对应的具体时区,参见 [时区说明](1737585867307010.html)。|
#|country|string|TTO Creator Marketplace 账户的国家或地区代码。<br><br>示例:`US`。<br><br>有关国家或地区代码对应的具体地域,参见 [地区代码](1737586324313089.html)。|
#|business_verification_status|string|TTO Creator Marketplace 账户的企业验证状态。<br><br>枚举值:<ul><li>`NOT_SUBMITTED`:账户尚未提交企业验证审核。</li><li>`UNDER_REVIEW`:账户正在进行企业验证审核。</li><li>`NOT_PASSED`:账户未通过企业验证审核。</li><li>`PASSED`:账户已通过企业验证审核。</li><li>`EXPIRED`:账户的企业验证已过期。</li></ul><br>了解[如何在 TikTok One 上验证你的企业](https://ads.tiktok.com/help/article/how-to-verify-your-business-for-tiktok-one)。|
示例
(code Success-Response http)
HTTPS/1.1 200 OK
{
"code": 0,
"message": "OK",
"request_id": "{{request_id}}",
"data": {
"account_name": "{{account_name}}",
"business_verification_status": "PASSED",
"country": "US",
"timezone": "America/Los_Angeles",
"tto_tcm_account_id": "{{tto_tcm_account_id}}"
}
}
(/code)