更新角色信息 - Zoom API 中文版

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

使用此API更改特定角色的权限、名称和描述。

** 先决条件: **

专业或更高的计划。

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

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

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

请求参数

Path 参数

roleId

string

必需

accountId

string

帐户的唯一标识符。

必需

Body 参数application/json

privileges

array[string]

可选

角色的已分配特权。可以是这些特权中的一个或组合。

sub_account_privileges

object

可选

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

second_level

integer

可选

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

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

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

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

示例值:

name

string

角色的名称。

可选

示例值:

My role

description

string

角色的描述。

可选

示例值:

My role

示例

{
    "privileges": [
        "User:Read"
    ],
    "sub_account_privileges": {
        "second_level": 1
    },
    "name": "My role",
    "description": "My role"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200** 错误代码: ** '200' 帐户必须是付费帐户才能更新角色。

application/json

Body

object {0}

示例

{}

🟠400** HTTP状态代码: ** '400' 错误的请求 ** 错误码: ** '1224' 角色名 {roleName} 已被使用。 ** 错误代码: ** '1034' 提供的 “role_id” 不存在。