列出角色中的成员

用户角色可以具有一组权限，仅允许访问用户需要查看或编辑的页面。使用此API列出分配了特定角色的所有成员。

** 先决条件: **

专业人士或更高的计划。

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

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

请求参数

Path 参数

roleId

string

角色ID

必需

accountId

string

帐户的唯一标识符。

必需

Query 参数

page_count

string

可选

为此请求返回的页数。

page_number

integer

可选

** 已弃用。** 在将来的版本中，我们将不再支持此字段。相反，使用 'next_page_token' 进行分页。

next_page_token

string

可选

使用next page标记对大型结果集进行分页。只要可用结果集超过当前页面大小时，就会返回下一页令牌。此令牌的有效期为15分钟。

page_size

integer

可选

单个API调用中返回的记录数。

返回响应

🟢200** HTTP状态代码: ** '200' 成功

application/json

Body

角色成员列表

page_number

integer

当前结果的页码。

可选

默认值:

示例值:

next_page_token

string

可选

下一页标记用于通过大型结果集进行分页。每当可用结果集超过当前页面大小时，将返回下一页令牌。此令牌的有效期为15分钟。

示例值:

TUNTL8kGBvdBSJiX1PaNAVxYbjV7ouJlKS2

members

array [object {6}]

角色成员列表

可选

last_name

string

成员姓氏

可选

示例值:

Chill

string

会员ID

可选

示例值:

49D7a0xPQvGQ2DCMZgSe7w

department

string

会员部门

可选

示例值:

Developers

type

integer

成员类型

可选

示例值:

first_name

string

成员名

可选

示例值:

Jill

string

会员电子邮件

可选

示例值:

jchil.test@example.com

total_records

integer

可选

跨页可用的所有记录的总数。

示例值:

page_count

integer

可选

为发出的请求返回的页数。

示例值:

page_size

integer

可选

单个API调用中返回的记录数。

<= 300

默认值:

示例值:

示例

{
    "page_number": 1,
    "next_page_token": "TUNTL8kGBvdBSJiX1PaNAVxYbjV7ouJlKS2",
    "members": [
        {
            "last_name": "Chill",
            "id": "49D7a0xPQvGQ2DCMZgSe7w",
            "department": "Developers",
            "type": 2,
            "first_name": "Jill",
            "email": "jchil.test@example.com"
        }
    ],
    "total_records": 22,
    "page_count": 3,
    "page_size": 30
}

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

🟠404** HTTP状态代码: ** '404' <br> 未找到

请求参数

示例代码

返回响应