订阅 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.meet.conference.v2.started conferenceRecord
会议室中的会议结束。 google.meet.conference.v2.ended conferenceRecord
参与者加入会议室中的正在进行的会议。 google.meet.participant.v2.joined conferenceRecord.participantSession
参与者退出会议室中的有效会议。 google.meet.participant.v2.left conferenceRecord.participantSession
为会议室中的会议生成录制文件。 google.meet.recording.v2.fileGenerated conferenceRecord.recording
为会议空间中的会议生成转写文件。 google.meet.transcript.v2.fileGenerated conferenceRecord.transcript

事件数据

本部分介绍了 Meet 会议室中的活动事件数据和有效负载示例。

当您的 Google Workspace 订阅收到来自 Meet 的事件时，data 字段会包含相应事件的载荷。此载荷包含有关发生更改的 Google Workspace 资源的信息。例如，如果您订阅了有关聊天室中新转写的事件，则这些事件的载荷包含有关发生更改的 transcripts 资源的信息。

事件载荷中的资源数据

下表提供了订阅 Meet 会议室的 JSON 载荷示例。这些示例使用会议记录 ID（例如 conferenceRecords/kRyYx8b7vNDsLpR1tG_cNjFUQBoBRhHIMoGJAJkBCQ）来标识会议室。如需了解详情，请参阅 Meet 如何识别会议室。

对于订阅接收的每个事件，载荷都会显示在事件的 data 字段中：

示例 Event type JSON 载荷

会议开始，进入 Meet 会议空间。

google.workspace.meet.conference.v2.started
排除资源数据
{
    "conferenceRecord":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID"
    }
}
参与者在 Meet 会议空间中加入会议。

google.workspace.meet.participant.v2.joined
排除资源数据
{
    "participantSession":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID/participants/PARTICIPANT_ID/participantSessions/PARTICIPANT_SESSION_ID"
    }
}
系统会为 Meet 会议空间中的会议生成录制内容。 google.workspace.meet.recording.v2.fileGenerated
排除资源数据
{
    "recording":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID/recordings/RECORDING_ID"
    }
}
在 Meet 会议空间中为会议生成转写内容。 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。