本文档介绍了您的应用可以使用 Google Workspace Events API 订阅的 Meet 事件。确定所需的事件类型后，创建订阅即可开始接收来自 Meet 的事件。
除了订阅事件之外，您还可以通过调用 Google Meet REST API 来查询事件。调用 Meet REST API 以定期检索事件，或补上您可能因服务中断而错过的订阅事件。如需了解接收和响应 Meet 事件的方式，请参阅 Meet 文档中的响应 Google Meet 中的事件。
如需详细了解如何为 Meet 开发应用，请参阅 Meet REST API 概览。
支持的 Meet 事件
通过 Google Workspace 订阅，您可以接收有关 Meet 中以下类型更改的事件：
可监控事件的资源
如需接收事件，请指定要监控的 Meet 资源，该资源称为订阅的目标资源。
Google Workspace Events API 支持以下 Meet 目标资源：
| 目标资源 | 格式 | 限制（如适用） |
|---|---|---|
| 会议空间 | //meet.googleapis.com/spaces/SPACE
其中 SPACE 是 Meet REST API |
|
| 用户 | //cloudidentity.googleapis.com/users/USER
其中 USER 是 Meet REST API |
订阅会接收有关用户作为会议空间所有者的所有会议空间的事件。通常，会议空间所有者也是与会议空间关联的 Google 日历活动的组织者。 |
用于创建订阅的事件类型
创建 Meet 资源订阅时，请使用 eventTypes[] 字段指定您要接收的事件类型。事件类型根据 CloudEvents 规范进行格式化，例如 google.workspace.APPLICATION.RESOURCE.VERSION.ACTION。
例如，如需接收有关 Meet 空间会议中新参与者的事件，请将事件类型指定为 google.workspace.meet.participant.v2.joined。如需详细了解事件的工作原理，请参阅 Google Workspace 事件的结构。
下表显示了订阅 Meet 资源支持哪些事件类型：
| 事件类型 | 格式 | 资源数据 |
|---|---|---|
| 会议在会议空间中开始。 | google.workspace.meet.conference.v2.started |
conferenceRecord |
| 会议空间中的会议结束。 | google.workspace.meet.conference.v2.ended |
conferenceRecord |
| 参与者加入会议空间中正在进行的会议。 | google.workspace.meet.participant.v2.joined |
conferenceRecord.participantSession |
| 参与者离开会议空间中的活跃会议。 | google.workspace.meet.participant.v2.left |
conferenceRecord.participantSession |
| 会议空间中的会议开始录制。 | google.workspace.meet.recording.v2.started |
conferenceRecord.recording |
| 会议空间中的会议录制结束。 | google.workspace.meet.recording.v2.ended |
conferenceRecord.recording |
| 系统会为会议空间中的会议生成录制文件。 | google.workspace.meet.recording.v2.fileGenerated |
conferenceRecord.recording |
| 在会议空间中，系统开始为会议生成智能会议记录。 | google.workspace.meet.smartNote.v2.started |
conferenceRecord.smartNote |
| 会议空间中的会议智能笔记结束。 | google.workspace.meet.smartNote.v2.ended |
conferenceRecord.smartNote |
| 系统会为会议空间中的会议生成智能笔记文件。 | google.workspace.meet.smartNote.v2.fileGenerated |
conferenceRecord.smartNote |
| 会议空间中的会议开始转写。 | google.workspace.meet.transcript.v2.started |
conferenceRecord.transcript |
| 会议空间中的会议转写结束。 | google.workspace.meet.transcript.v2.ended |
conferenceRecord.transcript |
| 系统会为会议空间中的会议生成转写文件。 | google.workspace.meet.transcript.v2.fileGenerated |
conferenceRecord.transcript |
事件数据
本部分介绍了 Meet 会议空间中事件的事件数据和示例载荷。
当您的 Google Workspace 订阅收到来自 Meet 的事件时，data 字段会包含该事件的载荷。此载荷包含有关已更改的 Google Workspace 资源的信息。例如，如果您订阅了有关聊天室中新转录内容的事件，则这些事件的载荷会包含有关已更改的 transcripts 资源的信息。
事件载荷中的资源数据
下表提供了订阅 Meet 会议空间的 JSON 载荷示例。这些示例使用会议记录 ID（例如 conferenceRecords/kRyYx8b7vNDsLpR1tG_cNjFUQBoBRhHIMoGJAJkBCQ）来标识会议空间。如需了解详情，请参阅 Meet 如何识别会议空间。
对于订阅收到的每个事件，载荷会显示在事件的 data 字段中：
| 事件类型 | JSON 载荷 |
|---|---|
Meet 会议空间中的会议开始或结束。
|
排除资源数据：
{
"conferenceRecord":
{
"name": "conferenceRecords/ |
参与者加入或离开 Meet 会议空间中的会议。
|
排除资源数据：
{
"participantSession":
{
"name": "conferenceRecords/ |
在 Meet 会议空间中，会议开始录制、结束录制或生成文件。
|
排除资源数据：
{
"recording":
{
"name": "conferenceRecords/ |
在 Meet 会议空间中，智能笔记开始、结束或为会议生成文件。
|
排除资源数据：
{
"smartNote":
{
"name": "conferenceRecords/ |
在 Meet 会议空间中，会议的转写文稿开始或结束，或者生成了文件。
|
排除资源数据：
{
"transcript":
{
"name": "conferenceRecords/ |
限制
- 日历邀请对象和受邀参加会议的其他参与者只能收到以下事件：
google.workspace.meet.conference.v2.started和google.workspace.meet.transcript.v2.fileGenerated。