在商务中心创建机构号

此接口可用于在商务中心创建机构号。

注意
通过 API 在商务中心创建机构号目前为白名单功能。如需使用此功能，请联系你的 TikTok 销售代表。

准备工作

• 了解机构号。
• 了解机构号不可用的功能列表。
• 确保商务中心已通过企业验证。若需确认这一点，需使用 /bc/get/ 或 /account/verification/status/ 接口查看返回的商务中心 verification_status 是否为 VERIFIED。
• 如果你的商务中心缺少联系信息和结算信息，请登录商务中心进行补充。
• 你需要成为商务中心的管理员。若要确认你对商务中心的权限，需使用 /bc/get/ 接口并确认返回的 user_role 是否为 ADMIN。
• 对于代理商商务中心，请确保已使用 /bc/advertiser/create/ 接口，通过指定 qualification_info 为客户创建广告账号。此操作可生成已通过验证的 qualification_id，用于关联你要创建的机构号。

请求

地址 https://business-api.tiktok.com/open_api/v1.3/bc/oa/create/

方法 POST

Header

|字段{35%}|类型{15%}|描述{50%}|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。<br><br>可以通过[获取访问令牌](1738373164380162.html)接口获取。|
|Content-Type {必填}|string|请求信息类型。<br><br>允许值：`multipart/form-data`。|

参数

|字段{35%}|类型{15%}|描述{50%}|
|---|---|---|
|bc_id {必填}|string|商务中心的 ID。<br><br>若想获取你有权访问的商务中心列表，需使用 [/bc/get/](1737115687501826.html) 接口。|
|display_name {必填}|string|机构号的显示名称（用户名）。<br><br>长度限制：30 个字符。|
|handle|string|机构号的用户名（名称）。<br><br>长度限制：24 个字符。<br><br>用户名不能只包含数字。<br><br>若用户名已被占用，系统将报错。|
|profile_image|file|用作机构号头像的文件。|
|operating_region_code {必填}|string|你希望开展业务的国家或地区的代码。<br><br>枚举值参见 <a href="#item-link-List of values for operating_region_code">`operating_region_code` 值列表</a>。<br><br><p><span style="color:darkred"><b>注意</b></span>：若你的企业位于中国大陆，在创建机构号时必须选择中国大陆以外的运营地区，因为 `CN` 不是 `operating_region_code` 的可用枚举值。|
|qualification_info {+条件必填}|object|当你的商务中心的 `type` 为 `AGENCY` 或 `SELF_SERVICE_AGENCY` 时，此为必填字段。<br><br>资质信息。<br><br>若想获取商务中心的类型，需使用 [/bc/get/](1737115687501826.html) 接口并查看返回的 `type`。<br><br>如果你的商务中心的 `type` 为 `DIRECT` 或 `SELF_SERVICE`，系统将报错。|
#|qualification_id|string|与客户广告账号关联的已通过验证的资质（资质证明）ID。<br><br>若想在你的代理商商务中心获取已通过验证的资质，需使用 [/bc/advertiser/qualification/get/](https://ads.tiktok.com/marketing_api/docs?id=1770118680584194) 接口，并将 `filtering` 设置为 `&#123;"verified": true&#125;`。<br><br><p><span style="color:darkred"><b>注意</b></span>： <ul><li>如果你尚未为客户创建广告账号，可以通过调用 [/bc/advertiser/create/](https://business-api.tiktok.com/portal/docs/create-an-ad-account/v1.3) 接口，并添加客户的 `qualification_info` 来生成 `qualification_id`。</li><li>如果你为客户创建了广告账号，但该广告账号尚未通过验证，参见[验证 TikTok 商务中心账号或广告账号](https://business-api.tiktok.com/portal/docs/verify-your-business-center-account-or-ad-account-on-tiktok/v1.3)，了解如何通过 API 验证广告账号。</li></ul>|

operating_region_code 值列表

| <code>operating_region_code</code> 值{20%} | 描述{80%} |
|---|---|
| `AR` | 阿根廷 |
| `AU` | 澳大利亚 |
| `AT` | 奥地利 |
| `BD` | 孟加拉国 |
| `BE` | 比利时 |
| `BR` | 巴西 |
| `BG` | 保加利亚 |
| `KH` | 柬埔寨 |
| `CA` | 加拿大 |
| `CL` | 智利 |
| `CO` | 哥伦比亚 |
| `HR` | 克罗地亚 |
| `CY` | 塞浦路斯 |
| `CZ` | 捷克 |
| `DK` | 丹麦 |
| `EC` | 厄瓜多尔 |
| `EG` | 埃及 |
| `EE` | 爱沙尼亚 |
| `FI` | 芬兰 |
| `FR` | 法国 |
| `DE` | 德国 |
| `GR` | 希腊 |
| `HU` | 匈牙利 |
| `ID` | 印度尼西亚 |
| `IQ` | 伊拉克 |
| `IE` | 爱尔兰 |
| `IL` | 以色列 |
| `IT` | 意大利 |
| `JP` | 日本 |
| `JO` | 约旦 |
| `KZ` | 哈萨克斯坦 |
| `KW` | 科威特 |
| `LV` | 拉脱维亚 |
| `LT` | 立陶宛 |
| `LU` | 卢森堡 |
| `MY` | 马来西亚 |
| `MX` | 墨西哥 |
| `MA` | 摩洛哥 |
| `NL` | 荷兰 |
| `NZ` | 新西兰 |
| `NO` | 挪威 |
| `PK` | 巴基斯坦 |
| `PE` | 秘鲁 |
| `PH` | 菲律宾 |
| `PL` | 波兰 |
| `PT` | 葡萄牙 |
| `RO` | 罗马尼亚 |
| `SA` | 沙特阿拉伯 |
| `SG` | 新加坡 |
| `SK` | 斯洛伐克 |
| `SI` | 斯洛文尼亚 |
| `ZA` | 南非 |
| `KR` | 韩国 |
| `ES` | 西班牙 |
| `SE` | 瑞典 |
| `CH` | 瑞士 |
| `TW` | 中国台湾 |
| `TH` | 泰国 |
| `TR` | 土耳其 |
| `AE` | 阿拉伯联合酋长国 |
| `GB` | 英国 |
| `US` | 美国 |
| `VN` | 越南 |

示例

在直客商务中心创建机构号

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/bc/oa/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: multipart/form-data' \
--form 'bc_id="{{bc_id}}"' \
--form 'display_name="{{display_name}}"' \
--form 'handle="{{handle}}"' \
--form 'profile_image="@{{profile_image}}"' \
--form 'operating_region_code="VN"'
(/code)

在代理商商务中心创建机构号

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/bc/oa/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: multipart/form-data' \
--form 'bc_id="{{bc_id}}"' \
--form 'display_name="{{display_name}}"' \
--form 'profile_image="@{{profile_image}}"' \
--form 'handle="{{handle}}"' \
--form 'operating_region_code="US"' \
--form 'qualification_info="{\"qualification_id\": \"{{qualification_id}}\"}"'
(/code)

返回

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|code|number|返回码。完整返回码列表及描述参见[附录 - 返回码](1737172488964097.html)。|
|message|string|返回信息。更多信息参见[附录 - 返回码](1737172488964097.html)。|
|request_id|string|请求的日志 ID，唯一标识一个请求。|
|data|object|返回数据。|
#|asset_id|string|新创建的机构号 ID。<br><br><p><span style="color:darkred"><b>注意</b></span>：此 ID 与 `MANAGED_BUSINESS_ACCOUNT` 资产类型的 `asset_id` 相对应，你可以使用 [/bc/asset/get/](1739432717798401.html) 或 [/bc/asset/admin/get/](1739433007779841.html) 接口获取此 ID。每个新机构号会生成两个 `asset_id`：一个对应 `MANAGED_BUSINESS_ACCOUNT` 类型，另一个对应 `TT_ACCOUNT` 类型。你可以依据你希望授予的权限，使用 [/bc/asset/assign/](1739438211077121.html) 接口将任一类型的资产分配给某位成员。|
#|asset_name|string|新建机构号的显示名称（用户名）。|

示例

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