参与者是指加入通话或使用伙伴模式、以观众或连接到通话的会议室设备的身份观看的人员。每个人都有一个 conferenceRecords.participants
资源。
“参与者会话”是为加入通话的每个参与者-设备对创建的唯一会话 ID。每个会话都有一个 conferenceRecords.participants.participantSessions
资源。如果参与者从同一参与者设备对多次加入同一通话,系统会为每个参与者分配唯一的会话 ID。
本页面介绍了如何获取所有已参加会议或正在参加会议的参与者或仅有关单个参与者的信息,以及他们的会话信息。
参与者
以下部分详细介绍了如何获取有关参与者的信息。
conferenceRecords.participants
资源包含 user
字段。user
只能是以下对象之一:
signedinUser
是以下任一项:通过个人计算机、移动设备或通过伙伴模式加入会议的人数。
会议室设备使用的机器人账号。
anonymousUser
是指未登录 Google 帐号的无法识别的用户。phoneUser
是指从手机拨号加入会议的用户,其身份未知,因为用户未使用 Google 帐号登录。
搜索所有参与者
如需获取有关会议记录中所有参与者的详细信息,请对 conferenceRecords.participants
资源使用带有 parent
路径参数的 list()
方法。
您可以使用 earliestStartTime
或 latestEndTime
字段过滤在特定时间之前或之后加入的用户。这两个字段均采用 RFC 3339 UTC“Zulu”格式的时间戳格式,具有纳秒级分辨率和最多九个小数位:{year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z
。例如:
earliestStartTime < 2023-10-01T15:01:23Z
latestEndTime < 2023-10-01T15:01:23Z
如需在现有会议中让活跃参与者加入其中,请使用 latestEndTime IS
NULL
。
该方法会返回会议参与者列表(按加入时间降序排序),作为 conferenceRecords.participants
资源的实例。
以下代码示例展示了如何列出会议记录中的所有参与者:
Java
Node.js
Python
将父值替换为会议记录的名称。
搜索特定参与者
如需搜索特定参与者,请对 conferenceRecords.participants
资源使用 get()
方法和 name
路径参数。如需检索参与者的姓名,请使用 conferenceRecords.participants.list
方法。
该方法会返回参与者姓名作为 conferenceRecords.participants
资源的实例。
以下代码示例展示了如何检索特定参与者:
Java
Node.js
Python
将参与者姓名替换为要查找的特定参与者的姓名。
参与者会话
以下各部分详细介绍了如何获取有关参与者会话的信息。
搜索所有参与者会话
如需获取有关会议记录中参与者的所有参与者会话的详细信息,请对 conferenceRecords.participants.participantSessions
资源使用带有 parent
路径参数的 list()
方法。
您可以使用 startTime
或 endTime
字段过滤在特定时间之前或之后加入的用户。这两个字段均采用 RFC 3339 UTC“Zulu”格式的时间戳格式,具有纳秒级分辨率和最多九个小数位:{year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z
。例如:
startTime < 2023-10-01T15:01:23Z
endTime < 2023-10-01T15:01:23Z
该方法会返回参与者会话列表(按加入时间降序排序),作为 conferenceRecords.participants.participantSession
资源的实例。
以下代码示例展示了如何列出会议记录中的所有参与者会话:
Java
Node.js
Python
将父项值替换为会议记录名称和参与者姓名。
搜索特定参与者会话
如需搜索特定参与者会话,请对 conferenceRecords.participants.participantSessions
资源使用带有 name
路径参数的 get()
方法。如需检索参与者的姓名,请使用 list()
方法。
该方法会返回参与者姓名作为 conferenceRecords.participants.participantSessions
资源的实例。
以下代码示例展示了如何检索特定参与者会话:
Java
Node.js
Python
将参与者姓名替换为要查找的特定参与者的姓名。