为 TTO 账号创建品牌主页

此接口可用于为 TikTok One (TTO) Creator Marketplace 账号创建品牌主页。

请求

地址 https://business-api.tiktok.com/open_api/v1.3/tto/tcm/brand/profile/create/

方法 POST

Header

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|Access-Token {必填}|string|经 TTO Creator Marketplace 账号授权的访问令牌。<br>可以通过[获取访问令牌](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`。  |

参数

|字段{30%}|类型{15%}|描述{55%}|
|--- |--- |--- |
| tto_tcm_account_id {必填} | string | TTO Creator Marketplace 账号的 ID。<br><br>若想获取可通过 `Access-Token` 访问的账号的 ID，需使用 [/tto/oauth2/tcm/](1815693478150146.html) 接口。 |
| brand_name {必填}  | string | 品牌名称。<br><br>长度限制：60 个字符。<br><br><p><span style="color:darkred"><b>注意</b></span>：此字段设置后不可更新。 |
| brand_industry_id {必填}  | string | 品牌行业 ID。<br><br>枚举值参见[品牌主页行业 ID](1830336456075458.html)。<br><br><p><span style="color:darkred"><b>注意</b></span>：此字段设置后不可更新。 |
| brand_website {必填}  | string | 品牌网站链接。<br><br>链接需以 `https://` 开头。 |
| logo_url {必填} | string | 品牌 Logo 图片 URL。<br><br>规格要求：<ul><li>文件格式：JPG、PNG 或 GIF。</li><li>宽高比：1:1。</li><li>文件大小：不超过 5 MB。</li></ul><br><p><span style="color:darkred"><b>注意</b></span>：此字段设置后不可更新。 |
|tiktok_account_url|string|你的 TikTok 账号的 URL。<br><br>URL 需以 `https://www.tiktok.com/@` 开头。<br><br>如果你在创建品牌主页时提供此 URL，达人可直接在你的主页上查看你的关联账号。这有助于在合作前增强品牌的真实性和透明度。<br><br>若想查找你的 TikTok 账号的 URL，前往 TikTok 主页，点击分享按钮，然后复制链接。|

示例

(code curl http)
curl --location  --request POST 'https://business-api.tiktok.com/open_api/v1.3/tto/tcm/brand/profile/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "tto_tcm_account_id": "{{tto_tcm_account_id}}",
    "brand_name": "{{brand_name}}",
    "brand_website": "{{brand_website}}",
    "brand_industry_id": "290101",
    "logo_url": "{{logo_url}}"
}'
(/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|返回数据。|
#|brand_profile_id | string | 已创建的品牌主页的 ID。 |
#|brand_name | string | 品牌名称。 |
#|brand_industry_id | string | 品牌行业 ID。 |
#|brand_website | string | 品牌网站链接。 |
#|logo_url | string | 你的 TTO Creator Marketplace 账号的品牌 Logo 图片的 URL。<br><br><p><span style="color:darkred"><b>注意</b></span>：此 URL 由系统为品牌 Logo 图片生成，与在创建品牌主页的请求中通过 `logo_url` 传入的 URL 不同。 |
#|tiktok_account_url|string|你的 TikTok 账号的 URL。<br><br>如果未提供用于创建品牌主页的 TikTok 账号 URL，此字段将为空字符串 (`""`)。|

示例

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "brand_industry_id": "290101",
        "brand_name": "{{brand_name}}",
        "brand_profile_id": "{{brand_profile_id}}",
        "brand_website": "{{brand_website}}",
        "logo_url": "{{logo_url}}"
    }
}
(/code)