列出会议参与者

GET

/accounts/{accountId}/metrics/meetings/{meetingId}/participants

返回来自实时或过去会议的参与者列表。

如果未提供 “type” 查询参数，则默认值将设置为 “live” 值。此API将仅返回live meeting中参与者的指标 (如果存在)。您可以使用 “从” 和 “到” 查询参数为仪表板数据指定每月日期范围。该月应在最近六个月内。

** 注: **

当帐户调用此API时，此API可能会为参与者的 “user_name” 、 “ip_address” 、 “location” 和 “email' 响应返回空值:

没有 ** 已签署的HIPAA商业伙伴协议 (BAA)。

是 ** legacy ** HIPAA BAA帐户。

显示 ** 不属于 ** 主机帐户的任何用户 (外部用户) 的数据，除非他们满足某些条件。有关详细信息，请参阅 [电子邮件地址显示规则](/docs/api-reference/using-zoom-api # 电子邮件地址)。

** 先决条件: **

业务或更高的计划。

** 范围: ** 'dashboard_meetings:master'

** [速率限制标签](https://marketplace.zoom.us/docs/api参考/速率限制 # 速率限制):** “沉重”

请求参数

Path 参数

meetingId

string

必需

会议的ID或通用唯一ID (UUID)。

如果您提供会议ID，API将返回最新会议实例的响应。

如果您提供的会议UUID以 “/” 字符开头或包含 “//” 字符，则在发出API请求之前，必须 ** 对会议UUID进行双编码。

accountId

string

帐户的唯一标识符。

必需

Query 参数

type

string

可选

要查询的会议类型。

“过去”-所有过去的会议。

“过去”-所有过去的单用户会议。

'live'-所有实时会议。

此值默认为 “live”。

page_size

integer

可选

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

next_page_token

string

可选

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

include_fields

string

可选

如果您希望在此API调用的响应中看到注册人ID属性，请提供 'registrant_id' 作为此字段的值。注册人ID是 [会议注册人] 的唯一标识符 (/docs/api-reference/zoom-api/方法 # 操作/会议注册人)。“实时” 会议类型不支持此功能。

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200** HTTP状态代码: ** '200' 会议参与者返回。此API仅适用于已启用仪表板功能的ZMP和企业或更高版本帐户。

application/json

Body

分页对象。

next_page_token

string

可选

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

示例值:

Tva2CuIdTgsv8wAnhyAdU3m06Y2HuLQtlh3

total_records

integer

可选

跨页可用的所有记录数。

示例值:

page_count

integer

可选

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

示例值:

page_size

integer

可选

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

<= 300

默认值:

示例值:

participants

array [object {40}]

可选

有关会议参与者的信息。如果参与者离开了会议并重新加入了同一会议，则其信息将显示与其加入会议相同的次数。

pc_name

string

参与者的PC名称。

可选

示例值:

HW0010449

audio_quality

enum<string>

可选

参与者的音频质量分数。仅当在Zoom Web门户中启用 ** 仪表板上的会议质量分数和网络警报 ** 设置以及 ** 在仪表板上显示会议质量分数和网络警报 ** 选项时，API才返回此值在 [** 帐户设置 **] 中选择 (https://zoom.us/account/setting)。

'好'-音频几乎完美无瑕，质量非常好。

'公平'-音频偶尔会出现失真，噪音和其他问题，但内容基本上是连续的。参与者可以正常交流。

“差”-音频经常有失真，噪音和其他问题，但内容基本上是连续的。参与者可以正常交流。

“坏”-声音质量极差，音频内容几乎听不见。

枚举值:

goodfairpoorbad

示例值:

good

role

enum<string>

可选

参与者的角色。

'host'-主机。

“与会者”-与会者。

枚举值:

hostattendee

示例值:

host

registrant_id

string

可选

参与者的唯一注册人ID。仅当为 “include_fields” 查询参数传递 “registrant_id” 值时，此字段才返回。

如果 “type” 查询参数为 “live'” 值，则此字段不返回。

示例值:

fdgsfh2ey82fuh

user_name

string

参与者的显示名称。

可选

示例值:

jchill

participant_user_id

string

可选

参与者的通用唯一ID (UUID)。

如果参与者通过登录Zoom加入会议，此值是 [** 获取用户 **](/docs/api-reference/zoom-api/methss # operation/user) api响应中的 “id” 值。

如果参与者加入会议 ** 而没有 ** 登录Zoom，则返回空字符串值。

示例值:

DYHrdpjrS3uaOf7dPkkg8w

recording

boolean

可选

会议期间是否使用了录制功能。

示例值:

false

share_application

boolean

可选

参与者是否选择在screenshare期间共享iPhone或iPad应用程序。

示例值:

true

join_time

string <date-time>

可选

参与者加入会议的时间。

示例值:

2022-03-01T10:15:14Z

full_data_center

string

可选

存储参与者会议数据的数据中心。此字段包括HTTP隧道 (HT) 、云机房连接器 (CRC) 和实时Web网关 (RWG) 位置信息的分号分隔列表。

示例值:

United States (SC Top);

customer_key

string

可选

参与者的SDK标识符。此值可以是字母数字，最大长度为35个字符。

<= 35 字符

示例值:

349589LkJyeW

bo_mtg_id

string

可选

分组会议室 ID。每个分组会议室都被分配了一个唯一的ID。

示例值:

Dkgwu8nm/ExG1vM+GhLRhA==

mac_addr

string

可选

参与者的MAC地址。

** 注意: ** 对于 ** 不属于 ** 主机帐户的任何用户 (外部用户)，此响应将返回一个空字符串 ('') 值。

示例值:

f85e-a012-92d8

string

可选

参与者的通用唯一ID (UUID):

如果参与者通过登录Zoom加入会议，此值是 [** 获取用户 **](/docs/api-reference/zoom-api/methss # operation/user) api响应中的 “id” 值。

如果参与者加入会议 ** 而没有 ** 登录Zoom，则返回空字符串值。

** 注意: ** 使用 'participant_user_id' 值而不是此值。我们将在将来的版本中删除此响应。

示例值:

zJKyaiAyTNC-MWjiWC18KQ

leave_reason

enum<string>

可选

参与者离开会议的原因，其中 '$ name' 是参与者的用户名:

'$ name已离开会议。'

'$ name已与会议断开连接。'

“主持人结束了会议。”

'主持人开始了新的会议。'

'网络连接错误。'

'主机未加入。'

'超出免费会议分钟数限制。'

'已由主机移除。'

“未知原因”。
“离开等候室。

'由主人从等候室移走。'

枚举值:

$name left the meeting.$name got disconnected from the meeting.Host ended the meeting.Host closed the meeting.Host started a new meeting.Network connection error.Host did not join.Exceeded free meeting minutes limit.Removed by host.Unknown reason.Leave waiting room.Removed by host from waiting room.

示例值:

Host ended the meeting.

camera

string

可选

与会者在会议期间使用的摄像机类型。

** 注意: ** 对于 ** 不属于 ** 主机帐户的任何用户 (外部用户)，此响应将返回一个空字符串 ('') 值。

示例值:

FaceTime HD Camera

microphone

string

可选

与会者在会议期间使用的麦克风类型。

** 注意: ** 对于 ** 不属于 ** 主机帐户的任何用户 (外部用户)，此响应将返回一个空字符串 ('') 值。

示例值:

Microphone (2- High Definition Audio Device)

string <email>

可选

参与者的电子邮件地址。如果参与者不是 ** 主机帐户的一部分，则返回一个空字符串值，但有一些例外。有关详细信息，请参阅 [电子邮件地址显示规则](/docs/api-reference/using-zoom-api # 电子邮件地址)。

示例值:

jchill@example.com

leave_time

string <date-time>

可选

参与者离开会议的时间。对于实时会议，仅当参与者已离开正在进行的会议时，此字段才会返回。

示例值:

2022-03-01T10:17:35Z

connection_type

string

参与者的连接类型。

可选

示例值:

UDP

in_room_participants

integer

可选

通过Zoom Room加入的参与者的数量。

示例值:

video_quality

enum<string>

可选

参与者的视频质量。仅当在Zoom Web门户中启用 ** 仪表板上的会议质量分数和网络警报 ** 设置以及 ** 在仪表板上显示会议质量分数和网络警报 ** 选项时，API才返回此值在 [** 帐户设置 **] 中选择 (https://zoom.us/account/setting)。

'好'-视频几乎完美无瑕，质量非常好。

'公平'-视频清晰度很高，偶尔会卡住，快或慢，或其他问题，但频率很低，视频质量很好。

'poor'-视频清晰度不高，但不存在很多问题。视频质量一般。

“坏”-图片非常模糊，经常被卡住。

枚举值:

goodfairpoorbad

示例值:

good

from_sip_uri

string

可选

会议参与者的SIP furi标头。API仅在参与者通过SIP加入会议时返回此响应。

示例值:

example.com

data_center

string

可选

参与者用来加入会议的数据中心。

示例值:

United States (SC Top)

ip_address

string

参与者的IP地址。

可选

示例值:

192.0.2.1

version

string

可选

参与者的Zoom客户端版本。

示例值:

5.9.1.2581

share_whiteboard

boolean

可选

参与者是否选择在屏幕共享期间共享他们的白板。

示例值:

true

user_id

string

可选

参与者的ID。此值在加入会议时分配给参与者，并且仅在会议的持续时间内有效。

示例值:

20162560

audio_call

array [object {3}]

可选

有关会议参与者的音频呼叫的信息。一些参与者可通过电话呼叫加入会议或被绑定到音频。

domain

string

可选

参与者的PC域。

** 注意: ** 对于 ** 不属于 ** 主机帐户的任何用户 (外部用户)，此响应将返回一个空字符串 ('') 值。

示例值:

example.com

internal_ip_addresses

array[string]

可选

参与者的内部IP地址。在以下情况下，此字段将不返回:

调用此API的帐户是 ** legacy ** [HIPAA下的业务伙伴协议 (BAA)](https://www.ecfr.gov/cgi-bin/retrieveECFR？gp = 1 & n = se45.1.160 _1103 & r = SECTION & ty = HTML)。

调用该API的账号是HIPAA下的BAA **，没有 ** 签名的BAA数据处理附录。

sip_uri

string

可选

会议参与者的SIP (会话发起协议) 联系报头URI。API仅在参与者通过SIP加入会议时返回此响应。

示例值:

example.com

speaker

string

可选

与会者在会议期间使用的发言人类型。

** 注意: ** 对于 ** 不属于 ** 主机帐户的任何用户 (外部用户)，此响应将返回一个空字符串 ('') 值。

示例值:

speaker (2- High Definition Audio Device)

location

string

参与者的位置。

可选

示例值:

United States

screen_share_quality

enum<string>

可选

参与者的屏幕共享质量分数。仅当在Zoom Web门户中启用 ** 仪表板上的会议质量分数和网络警报 ** 设置以及 ** 在仪表板上显示会议质量分数和网络警报 ** 选项时，API才返回此值在 [** 帐户设置 **] 中选择 (https://zoom.us/account/setting)。

'好'-视频几乎完美无瑕，质量非常好。

'公平'-视频清晰度很高，偶尔会卡住，快或慢，或其他问题，但频率很低，视频质量很好。

'poor'-视频清晰度不高，但不存在很多问题。视频质量一般。

“坏”-图片非常模糊，经常被卡住。

枚举值:

goodfairpoorbad

示例值:

good

harddisk_id

string

可选

参与者的硬盘ID。

** 注意: ** 对于 ** 不属于 ** 主机帐户的任何用户 (外部用户)，此响应将返回一个空字符串 ('') 值。

示例值:

Disk01

network_type

enum<string>

可选

参与者的网络类型。

“线”

'Wifi'

“Ppp”-点对点。

“蜂窝”-3g、4g和5g蜂窝。

“其他”-未知设备。

枚举值:

WiredWifiPPPCellularOthers

示例值:

Wired

device

enum<string>

可选

参与者用于加入会议的设备类型。

“电话”-参与者通过PSTN加入。

'H.323/SIP'-通过H.323或SIP设备加入的参与者。

“Windows”-参与者使用Windows设备通过VoIP加入。

'Mac '-参与者使用Mac设备通过VoIP加入。

'Ios '-参与者使用iOS设备通过VoIP加入。

'Android'-参与者使用Android设备通过VoIP加入。

** 注意: ** 对于 ** 不属于 ** 主机帐户的任何用户 (外部用户)，此响应将返回一个空字符串 ('') 值。

枚举值:

PhoneH.323/SIPWindowsMaciOSAndroid

示例值:

Phone

share_desktop

boolean

可选

参与者是否选择在screenshare期间共享其桌面。

示例值:

true

status

enum<string>

可选

参与者的状态。

'in_meeting'-在会议中。

“in_waiting_room”-在等候室。

枚举值:

in_meetingin_waiting_room

示例值:

in_meeting

示例

{
    "next_page_token": "Tva2CuIdTgsv8wAnhyAdU3m06Y2HuLQtlh3",
    "total_records": 1,
    "page_count": 1,
    "page_size": 30,
    "participants": [
        {
            "pc_name": "HW0010449",
            "audio_quality": "",
            "role": "host",
            "registrant_id": "fdgsfh2ey82fuh",
            "user_name": "jchill",
            "participant_user_id": "DYHrdpjrS3uaOf7dPkkg8w",
            "recording": false,
            "share_application": true,
            "join_time": "2022-03-01T10:15:14Z",
            "full_data_center": "United States (SC Top);",
            "customer_key": "349589LkJyeW",
            "bo_mtg_id": "Dkgwu8nm/ExG1vM+GhLRhA==",
            "mac_addr": "f85e-a012-92d8",
            "id": "zJKyaiAyTNC-MWjiWC18KQ",
            "leave_reason": "$name left the meeting.",
            "camera": "FaceTime HD Camera",
            "microphone": "Microphone (2- High Definition Audio Device)",
            "email": "jchill@example.com",
            "leave_time": "2022-03-01T10:17:35Z",
            "connection_type": "UDP",
            "in_room_participants": 2,
            "video_quality": "",
            "from_sip_uri": "example.com",
            "data_center": "United States (SC Top)",
            "ip_address": "192.0.2.1",
            "version": "5.9.1.2581",
            "share_whiteboard": true,
            "user_id": "20162560",
            "audio_call": [
                {
                    "call_number": "4131",
                    "call_type": "call-in",
                    "zoom_number": "18773690926"
                }
            ],
            "domain": "example.com",
            "internal_ip_addresses": [
                "192.0.2.1"
            ],
            "sip_uri": "example.com",
            "speaker": "speaker (2- High Definition Audio Device)",
            "location": "United States",
            "screen_share_quality": "",
            "harddisk_id": "Disk01",
            "network_type": "Wired",
            "device": "Phone",
            "share_desktop": true,
            "status": "in_meeting"
        }
    ]
}

🟠400** HTTP状态代码: ** '400' 错误的请求 ** 错误码: ** '12702' 无法访问一年前的会议。

🟠404** HTTP状态代码: ** '404' 未找到 ** 错误代码: ** '3001' 会议ID无效或尚未结束。

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

获取CRC端口使用情况

获取会议共享/录制详细信息