获取角色信息

每个Zoom用户自动具有一个角色，该角色可以是所有者、管理员或成员。具有角色管理的编辑权限的帐户所有者和用户可以添加具有权限列表的自定义角色。

使用此API可获取信息，包括分配给 [角色] 的特定权限 (https://support.zoom.us/hc/en-us/articles/115001078646-基于角色的访问控制)。

** 先决条件 **

专业或更高的计划。

对于角色管理和更新，您必须是帐户所有者或具有角色管理权限的用户。

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

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

返回响应

🟢200** 状态码: ** '200' 返回有关特定角色的信息。 ** 错误代码: ** '200' 您没有检索角色信息的权限。

application/json

Body

privileges

array[string]

可选

分配给角色的权限。可以是这些权限中的一个或多个。

sub_account_privileges

object

可选

此字段将仅显示给在合作伙伴计划中注册并遵循主帐户和子帐户结构的帐户。

second_level

integer

可选

指示帐户如何管理子帐户。

'1'-将子帐户作为帐户的所有者进行管理。

'2'-管理与当前帐户具有相同权限的子帐户。

“3”-管理具有指定权限的子帐户。

示例值:

name

string

角色的名称。

可选

示例值:

My role

description

string

角色的描述。

可选

示例值:

My role

total_members

integer

可选

分配给该角色的成员总数。

示例值:

string

角色的Id。

可选

示例值:

type

string

角色的类型。

可选

示例值:

示例

{
    "privileges": [
        "User:Read"
    ],
    "sub_account_privileges": {
        "second_level": 1
    },
    "name": "My role",
    "description": "My role",
    "total_members": 20,
    "id": "2",
    "type": "iq"
}

🟠400** HTTP状态代码: ** '400' <br> 错误的请求 ** 错误代码: ** '1034' <br> 提供的 “role_id” 不存在。<br>

请求参数

示例代码

返回响应