订阅 Google Meet 活动

本文档介绍了您的应用可以使用 Google Workspace Events API 订阅的 Google Meet 事件。确定需要哪些类型的活动后，创建订阅即可开始接收来自 Meet 的活动。

除了订阅事件之外，您还可以通过调用 Google Meet REST API 来查询事件。定期调用 Meet REST API 以检索活动，或弥补因中断而可能错过的订阅活动。如需了解如何接收和回复 Meet 活动，请参阅 Meet 文档中的回复 Google Meet 中的活动。

如需详细了解如何为 Meet 开发应用，请参阅 Google Meet REST API 概览。

支持的 Meet 活动

通过 Google Workspace 订阅，您可以接收有关 Meet 中以下类型更改的事件：

您可以监控哪些资源中的事件

如需接收事件，您需要指定要监控的 Meet 资源，该资源称为订阅的目标资源。

Google Workspace Events API 支持以下 Meet 目标资源：

目标资源 格式 限制（如果适用）
会议空间 //meet.googleapis.com/spaces/SPACE

其中，SPACE 是 Meet REST API spaces 资源的 资源名称中的 ID。 如需了解详情，请参阅 Meet 如何识别会议空间。
用户 //cloudidentity.googleapis.com/users/USER

其中，USER 是 Meet REST API participants 资源的 signedinUser.user 字段中的 ID。 如需了解详情，请参阅处理参与者。

订阅接收有关用户是会议室所有者的所有会议室的事件。通常，会议室所有者也是与会议室关联的 Google 日历活动的组织者。

用于创建订阅的事件类型

创建对 Meet 资源的订阅时，您可以使用 eventTypes[] 字段指定要接收的事件类型。事件类型按照 CloudEvents 规范进行格式设置，例如 google.workspace.APPLICATION.RESOURCE.VERSION.ACTION。

例如，如需接收有关 Meet 空间中会议新参与者的事件，您可将事件类型指定为 google.workspace.meet.participant.v2.joined。如需详细了解事件的工作方式，请参阅 Google Workspace 事件的结构。

下表显示了订阅 Meet 资源时支持的事件类型：

Event type 格式 资源数据
会议在会议空间中开始。 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 会议室的会议开始或结束。

  • google.workspace.meet.conference.v2.started
  • google.workspace.meet.conference.v2.ended

排除资源数据：

{
  "conferenceRecord":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID"
  }
}

有参与者加入或退出 Meet 会议空间中的会议。

  • google.workspace.meet.participant.v2.joined
  • google.workspace.meet.participant.v2.left

排除资源数据：

{
  "participantSession":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID/participants/PARTICIPANT_ID/participantSessions/PARTICIPANT_SESSION_ID"
  }
}

在 Meet 会议空间中，会议开始录制、结束录制或生成文件。

  • google.workspace.meet.recording.v2.started
  • google.workspace.meet.recording.v2.ended
  • google.workspace.meet.recording.v2.fileGenerated

排除资源数据：

{
  "recording":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID/recordings/RECORDING_ID"
  }
}

在 Meet 会议空间中，智能笔记开始、结束或生成会议文件。
开发者预览版

  • google.workspace.meet.smartNote.v2.started
  • google.workspace.meet.smartNote.v2.ended
  • google.workspace.meet.smartNote.v2.fileGenerated

排除资源数据：

{
  "smartNote":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID/smartNotes/SMART_NOTE_ID"
  }
}

在 Meet 会议室中，会议转写开始、结束或生成文件。

  • google.workspace.meet.transcript.v2.started
  • google.workspace.meet.transcript.v2.ended
  • google.workspace.meet.transcript.v2.fileGenerated

排除资源数据：

{
  "transcript":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID/transcripts/TRANSCRIPT_ID"
  }
}

限制
  • 受邀参加会议的日历邀请对象和其他参与者只能接收以下事件：google.workspace.meet.conference.v2.started 和 google.workspace.meet.transcript.v2.fileGenerated。