更新组成员 - Zoom API 中文版

使用此API执行以下任务之一:

从一个组中删除组成员，并将其移动到不同的组。

设置用户的主组。默认情况下，主组是用户添加到的第一个组。

如果用户是多个组的成员，则可以 [为用户分配主要组](https://support.zoom.us/hc/en-us/articles/204519819-组-管理-# h_d07c7dcd-4fd8-485a-b5fe-a322e8d21c09)。默认情况下，用户将使用主组的设置。但是，如果用户是具有锁定设置的组的成员，则这些组设置将对用户保持锁定。

** 先决条件: **

专业或更高的帐户

** 范围: ** 'group:master'

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

请求参数

Path 参数

groupId

string

必需

组的唯一ID。要获取此值，请使用 [** List groups **](/docs/api-reference/zoom-api/methos # operation/groups) api。

要设置用户的主组，请使用 'target_group_id' 值作为此参数的值。

要将组成员从一个组移动到另一个组，请使用指定组的 “groupid”。

memberId

string

必需

组成员的唯一ID。要获取此值，请使用 [** 列出组成员 **](/docs/api-reference/zoom-api/methos # operation/groupMembers) api。

accountId

string

帐户的唯一标识符。

必需

Body 参数application/json

target_group_id

string

可选

目标组的ID。要获取此值，请使用 [** List groups **](/docs/api-reference/zoom-api/methos # operation/groups) api。

要设置用户的主要组，请使用指定的主要组的 “groupid” 值。

要将组成员从一个组移动到另一个组，请使用指定组的 “groupid”。

示例值:

SobVexyrQjqCkcxjpBWi6w

action

enum<string>

必需

要执行的操作:

“移动”-从一个组中删除组成员，并将其移动到不同的组。

'set_primary'-设置用户的主要组。

枚举值:

moveset_primary

示例值:

move

示例

{
    "target_group_id": "SobVexyrQjqCkcxjpBWi6w",
    "action": "move"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢204** HTTP状态代码: ** '204' ** 无内容 ** 组成员已更新。

application/json

Body

object {0}

示例

{}

🟠400** HTTP状态代码: ** '400' 错误的请求 ** 错误代码: ** '200' 仅适用于付费帐户 {accountId}。 ** 错误代码: ** '300' target_group_id不能为空。 ** 错误代码: ** '1010' 组不属于此帐户:{accountId}。

🟠404** HTTP状态代码: ** '404' 未找到 ** 错误代码: ** '4130' 具有此 {groupId} 的组不存在。