列出角色

GET

/accounts/{accountId}/roles

在您的帐户上列出角色

** 先决条件 **:

Pro或更高的计划。

要设置初始角色，您必须是帐户所有者。

后续的角色管理，您必须是拥有角色管理权限的账号Owner或用户。

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

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

请求参数

Path 参数

accountId

string

帐户的唯一标识符。

必需

Query 参数

type

string

可选

指定一个值以获取相应角色类型的响应。

'common'-Zoom的常见角色。
'iq'-Zoom IQ Sales的角色

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200** HTTP状态代码: ** '200' 返回的角色列表。

application/json

Body

角色列表

roles

array [object {5}]

Roles对象列表

可选

name

string

角色名称

可选

示例值:

My Role

description

string

角色描述

可选

示例值:

my role

total_members

integer

此角色的成员总数

可选

示例值:

200

string

角色Id

可选

示例值:

RqBLcd1jLS9a7RBkbGtqn2A

type

string

角色类型

可选

示例值:

total_records

integer

可选

跨页可用的所有记录数

示例值:

200

示例

{
    "roles": [
        {
            "name": "My Role",
            "description": "my role",
            "total_members": 200,
            "id": "RqBLcd1jLS9a7RBkbGtqn2A",
            "type": "iq"
        }
    ],
    "total_records": 200
}

🟠400** HTTP状态代码: ** '400' <br> 错误的请求 ** 错误代码: ** '4700' <br> 访问令牌无效，不包含role:read:admin作用域。

修改于 2023-10-31 06:13:33

创建角色

更新角色信息