分配角色 - Zoom API 中文版

用户角色可以具有一组权限，仅允许访问用户需要查看或编辑的页面。使用此API向成员 [分配角色](https://support.zoom.us/hc/en-us/articles/115001078646-基于角色的访问控制 # h_748b6fd8-5057-4cf4-bbfd-787909c09db0)。

** 先决条件: **

专业人士或更高的计划。

** 范围: ** 'role:master'

** [速率限制标签](https://marketplace.zoom.us/docs/api-reference/Rate-limits # 速率限制):** 'Medium'

请求参数

Path 参数

roleId

string

角色ID

必需

accountId

string

帐户的唯一标识符。

必需

Body 参数application/json

members

array [object {2}]

可选

您要向其分配此角色的用户的userId/用户电子邮件数组。一次最多可以为30个用户分配一个角色。

<= 30 items

string

可选

要向其分配角色的用户ID。

示例值:

Cs97wug2RTm5TNvuvk4yRw

string <email>

可选

您要向其分配角色的用户的电子邮件地址。在ID字段中提供用户ID或在电子邮件字段中提供电子邮件地址。如果两个字段都提供，则仅使用userId。

示例值:

user@example.com

示例

{
    "members": [
        {
            "id": "Cs97wug2RTm5TNvuvk4yRw",
            "email": "user@example.com"
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢201** HTTP状态代码: ** '201' 已添加的成员

application/json

Body

add_at

string <date-time>

可选

将成员分配给角色的日期和时间。

示例值:

2019-06-01T07:58:03Z

ids

string

用户ID

可选

示例值:

示例

{
    "add_at": "2019-06-01T07:58:03Z",
    "ids": "2"
}

🟠400** HTTP状态代码: ** '400' 错误的请求 ** 错误代码: ** '1034' 提供的 “role_id” 不存在。 ** 错误代码: ** '300' 需要RoleId。 无法删除或添加普通/所有者角色的成员。