添加小组成员 - Zoom API 中文版

与网络研讨会中的与会者相比，网络研讨会中的小组成员可以查看和发送视频、屏幕共享、注释并做更多的事情。
[添加小组成员](https://support.zoom.us/hc/en-us/articles/115005657826-Inviting-Panelists-to-a-Webinar # h_7550d59e-23f5-4703-9e22-e76bded1ed70) 到预定的网络研讨会。

** 先决条件: **

Pro或更高的计划与网络研讨会附加。

** 范围: ** 'webinar:master'

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

请求参数

Path 参数

webinarId

integer

网络研讨会的ID。

必需

accountId

string

帐户的唯一标识符。

必需

Body 参数application/json

网络研讨会小组成员。

panelists

array [object {7}]

可选

panelist对象列表。

name_tag_name

string

可选

要在名称标记中显示的小组成员的姓名。

示例值:

xHhPyb8ERMCmiC5njPjFdQ

name

string

可选

小组成员的全名。

** 注意: ** 该值不能超过12个中文字符。

示例值:

Jill Chill

name_tag_pronouns

string

可选

要在名称标记中显示的代词。

示例值:

pronouns

name_tag_description

string

可选

姓名标签的描述，如人员的头衔。

示例值:

description

virtual_background_id

string

可选

要绑定的虚拟背景ID。

示例值:

xHhPyb8ERMCmiC5njPjFdQ

string <email>

可选

小组成员的电子邮件。有关返回值的详细信息，请参阅 [电子邮件地址显示规则](https://developers.zoom.us/docs/api/rest/using-zoom-api/# email-address-display-rules)。

示例值:

jchill@example.com

name_tag_id

string

可选

要绑定的名称标记ID。

示例值:

xHhPyb8ERMCmiC5njPjFdQ

示例

{
    "panelists": [
        {
            "name_tag_name": "xHhPyb8ERMCmiC5njPjFdQ",
            "name": "Jill Chill",
            "name_tag_pronouns": "pronouns",
            "name_tag_description": "description",
            "virtual_background_id": "xHhPyb8ERMCmiC5njPjFdQ",
            "email": "jchill@example.com",
            "name_tag_id": "xHhPyb8ERMCmiC5njPjFdQ"
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢201** HTTP状态代码: ** '201' 小组成员创建。

application/json

Body

updated_at

string <date-time>

可选

添加小组成员的时间。

示例值:

2022-03-26T07:30:16Z

string

网络研讨会Id。

可选

示例值:

95204914252

示例

{
    "updated_at": "2022-03-26T07:30:16Z",
    "id": "95204914252"
}

🟠400** HTTP状态代码: ** '400' 错误的请求 ** 错误代码: ** '1010' 用户不属于此帐户:{accountId}。 ** 错误码: ** '3000' 您已达到可添加的小组成员数的限制。有关详细信息，请与Zoom支持人员联系。

🟠404** HTTP状态代码: ** '404' 未找到 ** 错误代码: ** '1001' 用户 {userId} 不存在或不属于此帐户。 ** 错误代码: ** '3001' 网络研讨会 {webinarId} 未找到或已过期。

🟠429** HTTP状态代码: ** '429' 请求太多