← 返回目录
📁 API Reference › TikTok One

获取 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)

内容来源:TikTok API for Business 官方文档 · 本地归档

在接这个接口时卡住了?
Stuck wiring this API into production? We build ad-delivery tooling on these platforms — campaign automation, reporting pipelines, error-handling and migration between API versions.
联系我们 · Talk to us 每日平台更新简报 →