修改成员信息
商务中心的管理员用户可以使用本接口修改成员的用户名以及他们在商务中心的角色。
v1.2与v1.3版本对比
以下表格概括了 v1.2与v1.3接口的变化。
``xtable
|变化内容{30%}|v1.2{35%}|v1.3{35%}|
|---|---|---|
|接口路径|/v1.2/bc/member/update/|/v1.3/bc/member/update/|
|请求参数类型|bc_id: number<br>user_id: number|bc_id: string <br>user_id`: string|
## 请求
**地址**
https://business-api.tiktok.com/open_api/v1.3/bc/member/update/
**方法** POST
**Header**
``` xtable
|字段|类型|描述|
|---|---|---|
|Access-Token {必填}|string|授权access_token,可以通过[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口获取。 |
|Content-Type {必填}|string|请求消息类型<br>允许值: `"application/json"`。 |
参数
|字段|类型|描述|
|---|---|---|
|bc_id {必填}|string| 商务中心ID。 |
| user_id {必填}| string | 用户ID。 |
| user_role | string |用户在商务中心的新基本角色。枚举值:<ul><li>`ADMIN`:管理员可以管理商务中心的成员和资产。<li>`STANDARD`:标准成员只能处理分配给他们的广告账户。 |
| user_name | string | 新用户名。|
| ext_user_role | object |用户在商务中心除基本角色外的扩展角色。非必填。|
#| finance_role | string | 用户在商务中心的新财务角色。枚举值:<ul><li>`ANALYST`:财务分析师可以查看、导出、下载商务中心拥有或创建的所有广告账户的付款交易记录。<li>`MANAGER`:财务经理拥有财务分析师的所有权限,并拥有一系列编辑权限,他们可以利用这些权限为商务中心拥有或创建的所有广告账户进行付款、充值、修改联系信息以开具账单和发票。 |
示例
(code curl http)
curl -H "Access-Token:xxx" -H "Content-Type:application/json" -X POST \
-d '{
"bc_id": "BC_ID",
"user_id": "USER_ID",
"user_role": "USER_ROLE",
"user_name": "USER_NAME",
"ext_user_role": {
"finance_role": "FINANCE_ROLE"
}
}' \
https://business-api.tiktok.com/open_api/v1.3/bc/member/update/
(/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)