邀请成员

商务中心的管理员用户可以使用本接口邀请成员加入商务中心，并给成员分配权限和资产。

每个商务中心最多支持4000个成员，最多支持20个管理员用户同时在线。

v1.2与v1.3版本对比

以下表格概括了 v1.2与v1.3接口的变化。 ``xtable |变化内容{30%}|v1.2{35%}|v1.3{35%}| |---|---|---| |接口路径|/v1.2/bc/member/invite/| /v1.3/bc/member/invite/| |请求参数类型|bc_id: number |bc_id`: string |


## 请求

**地址** https://business-api.tiktok.com/open_api/v1.3/bc/member/invite/

**方法** POST

**Header**

``` xtable
|字段|类型|描述|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌，可以通过[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口获取。  |
|Content-Type {必填}|string|请求消息类型<br>允许值: `"application/json"`  |

参数

|字段|类型|描述|
|---|---|---|
|bc_id {必填}|string| 商务中心 ID。 |
| emails {必填} | string[] | 邮箱地址列表。<br>之前已邀请过的邮箱地址会被忽略。<br><br>最大数量：50。|
| user_role{必填}  | string | 用户在商务中心的基础角色。<br><br>枚举值：<ul><li>`ADMIN`：管理员可以访问商务中心内的所有功能。</li><li>`STANDARD`：标准成员只能对分配给他们的账户进行操作。</li> </ul>|
| asset_ids | string[] | 分配给邀请用户的广告账号 ID 列表。<br><br>最大数量：50。<br><br>若想获取商务中心中的广告账户，可使用[/bc/asset/get/](1739432717798401.html)并将 `asset_type` 设置为 `ADVERTISER`。|
| advertiser_role | string | 分配给邀请用户的广告账户权限。<br><br>枚举值：<ul><li>`ADMIN`：管理员。管理广告账号财务、设置和权限。 创建和编辑广告推广系列并查看投放效果数据。</li><li>`OPERATOR`：操作员。创建和编辑广告推广系列并查看投放效果数据。</li><li>`ANALYST`：分析师。查看广告和投放效果数据。</li></ul> |
| ext_user_role | object |用户在商务中心除基本角色外的扩展角色。|
#| finance_role | string | 用户在商务中心的财务角色。<br><br>枚举值：<ul><li>`MANAGER`：有财务经理访问权限的成员可以全面控制与财务和付款相关的所有功能。</li><li>`ANALYST`：有财务分析师访问权限的成员可以查看和下载财务数据。</li> </ul>|

示例

(code curl http)
curl -H "Access-Token:xxx" -H "Content-Type:application/json" -X POST \
-d '{
    "bc_id": "BC_ID",
    "emails": [
        "EMAILS"
    ],
    "user_role": "USER_ROLE",
    "asset_ids": [
        "ASSET_IDS"
    ],
    "advertiser_role": "ADVERTISER_ROLE",
    "ext_user_role": {
        "finance_role": "FINANCE_ROLE"
    }
}' \
https://business-api.tiktok.com/open_api/v1.3/bc/member/invite/
(/code)

|字段|类型|描述|
|---|---|---|
|code |number|返回码，详见[附录-返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)  |
|message |string|返回信息，详见[附录-返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)  |
|data |object|返回数据  |
|request_id |string|请求的日志id，唯一标识一个请求  |

示例

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