参与者是指加入通话的用户、使用副屏模式以观看者身份观看的用户,或已连接到通话的会议室设备。每个人都有一个 conferenceRecords.participants
资源。
参与者会话是指为加入通话的每个参与者-设备对创建的唯一会话 ID。每个会话都有一个 conferenceRecords.participants.participantSessions
资源。如果参与者使用同一参与者-设备对多次加入同一通话,系统会为每个参与者分配唯一的会话 ID。
本页介绍了如何获取有关参加过或正在参加会议的所有参与者或仅一位参与者的信息,以及他们的会话信息。
参与者
以下部分详细介绍了如何获取参与者的信息。
conferenceRecords.participants
资源包含 user
字段。user
只能是以下对象之一:
signedinUser
是:通过个人计算机、移动设备或通过配套模式加入会议的个人。
会议室设备使用的机器人账号。
anonymousUser
是指未登录 Google 账号的未识别用户。phoneUser
是指通过电话拨号加入会议的用户,由于用户未使用 Google 账号登录,因此其身份未知。
搜索所有参与者
如需获取会议记录中所有参与者的详细信息,请对 conferenceRecords.participants
资源使用 list()
方法,并附带 parent
路径参数。
您可以使用 earliestStartTime
或 latestEndTime
字段过滤出在特定时间之前加入或之后离开的用户。这两个字段均采用 RFC 3339 UTC“Zulu”格式的时间戳格式,精确到纳秒且最多有 9 位小数:{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
资源使用 name
路径参数调用 get()
方法。如需检索参与者的姓名,请使用 conferenceRecords.participants.list
方法。
该方法会将参与者名称作为 conferenceRecords.participants
资源的实例返回。
以下代码示例展示了如何检索特定参与者:
Java
Node.js
Python
将参与者姓名替换为要查找的特定参与者的姓名。
参与者会话
以下部分详细介绍了如何获取与参与者会话相关的信息。
搜索所有参与者会话
如需获取会议记录中某位参与者的所有参与者会话的详细信息,请对 conferenceRecords.participants.participantSessions
资源使用 list()
方法,并附带 parent
路径参数。
您可以使用 startTime
或 endTime
字段过滤出在特定时间之前加入或之后离开的用户。这两个字段均采用 RFC 3339 UTC“Zulu”格式的时间戳格式,精确到纳秒且最多有 9 位小数:{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
将参与者姓名替换为要查找的特定参与者的姓名。
使用 People API 检索参与者详细信息
如需检索参与者的详细信息,请使用 People API 中的 people.get
方法。
- 使用路径的尾部组件从参与者资源名称中提取人员的 ID。例如,如果参与者资源名称为
conferenceRecords/abc-123/participants/12345
,则 People API 的 ID 为12345
。 - 添加来源
READ_SOURCE_TYPE_PROFILE
、READ_SOURCE_TYPE_CONTACT
和READ_SOURCE_TYPE_OTHER_CONTACT
。这样可确保回复中包含 Google Workspace 组织的内部用户和外部联系人。
以下示例会同时搜索某位用户的组织付款资料和联系人:
cURL
curl \
'https://people.googleapis.com/v1/people/PERSON_ID?personFields=names%2CemailAddresses&sources=READ_SOURCE_TYPE_OTHER_CONTACT&sources=READ_SOURCE_TYPE_PROFILE&sources=READ_SOURCE_TYPE_CONTACT' \
--header 'Authorization: Bearer ACCESS_TOKEN' \
--header 'Accept: application/json' \
--compressed