订阅 Google Meet 活动

本页介绍了您的应用可以使用 Google Workspace Events API 订阅的 Google Meet 事件。确定需要哪些类型的活动后，创建订阅即可开始接收 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 space 资源的 资源名称中的 ID。 如需了解详情，请参阅 Meet 如何识别会议空间。
用户 //cloudidentity.googleapis.com/users/USER

其中，USER 是 Meet REST API participant 资源的 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 说明 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.fileGenerated

为会议室中的会议生成录制文件。

conferenceRecord.recording

google.workspace.meet.transcript.v2.fileGenerated

为会议空间中的会议生成转写文件。

conferenceRecord.transcript

事件数据

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

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

事件载荷中的资源数据

下表提供了订阅 Meet 会议室的 JSON 载荷示例。这些示例使用会议记录 ID（例如 conferenceRecords/AAA-BBB-CCC-DDD-EEE）来标识会议室。如需了解详情，请参阅 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"
    }
}