Google Meet REST API 概览

借助 Google Meet REST API，您可以为 Google Meet 创建和管理会议，并直接从应用中为用户提供入口点。

借助 Meet REST API，您可以执行以下操作：

  • 创建会议空间，以便用户通过视频进行连接。
  • 按资源名称获取会议室或会议。
  • 获取参与者和参与者会话的列表。
  • 获取会议数据制品（录制内容、转写内容和转写条目）。

您还可以使用 Google Workspace Events API 订阅 Meet 事件。如需接收有关变更的通知，您可以订阅指定的会议室或属于指定用户的所有会议室。 如需了解详情，请参阅：

使用场景

应用可以与 Meet REST API 集成，以执行以下任务：

  • 会议开始前：根据需要创建会议空间，量身打造会议体验。您还可以管理受邀者并预先配置设置。

  • 会议期间：检索会议信息，以便根据返回的元数据更改应用体验。

  • 会议结束后：获取会议内容，例如录制内容和转写内容。

您可能希望使用 Meet REST API 执行的一些操作包括：

  • 销售和客户管理

    • 检索会议和参与者信息以供记录。
    • 提取会议制品并将其发布到账号中。
    • 通过 AI 模型运行转写内容和录音，生成指导和销售效果分析。

  • 学习与发展

    • 创建并预配置用于培训的会议。
    • 为培训人员和会议负责人分配共同主持人角色。
    • 检索录制内容，以便学生在课程结束后查看资料。

  • 开发者操作

    • 创建会议，以便立即与队友联系。
    • 通过分享实时会议和参与者信息，让其他利益相关者加入正在进行的会议。
    • 通过 AI 模型运行转写数据，生成正确的后续步骤。
在 Chat 聊天室中与同事创建并加入动态会议。
图 1. 在 Chat 聊天室中与同事创建并加入动态会议。

您还可以将其他 Google Workspace API（例如 Chat API）集成到应用中，以进一步提升协作效率。如需了解详情，请参阅聊天用例。

常用术语

以下是此 API 中使用的一些常用术语：

工件
Meet 针对会议生成的文件，例如 recordings 和 transcripts。 制品会保存到会议组织者的 Google 云端硬盘中。会议结束后，这些内容通常很快就可以提取。
日历活动
Google 日历中包含多位参加者的活动，通常由会议组织者创建，其中包含会议的加入信息。 Meet 可能是活动的会议解决方案。
Call
使用 Meet 的会话，或通知他人通话即将开始或正在进行，并允许他们立即加入。
会议
会议是会议空间中的通话实例。用户通常会将此场景视为一次会议。
会议记录
每次会议的唯一 ID。会议开始时会自动创建。conferenceRecords 资源采用 conferenceRecords/{conferenceRecord} 格式。例如，conferenceRecords/kRyYx8b7vNDsLpR1tG_cNjFUQBoBRhHIMoGJAJkBCQ。
共同主持人
通话中的人员，由主持人授予主持人管理权限，但无法移除原来的主持人。
拨号加入
使用电话参与通话或收听直播通话。
主机
创建通话（即会议组织者）的人员或控制通话的人员。请注意，会议组织者可以组织会议，但不必在会议举行时到场。主持人还可以将主持人权限委托给共同主持人。
会议代码

会议室的可输入唯一 10 字符字符串，用于会议室的会议 URI 中。不区分大小写。例如 abc-mnop-xyz。长度上限为 128 个字符。

会议代码不应长期存储，因为它们可能会与会议室分离，并且将来可能会重复用于不同的会议室。一般来说，会议代码会在上次使用后 365 天过期。如需了解详情，请参阅了解 Google Meet 中的会议代码。

会议名称

用于标识会议空间的服务器生成的唯一 ID。区分大小写。例如 jQCFfuBOdN5z。会议 ID 会在 spaces 资源的 name 字段中返回。如需了解详情，请参阅 Meet 如何识别会议室。

会议组织者

创建会议空间的用户。此用户也可以视为会议所有者。他们可能不在通话中，也可能不是会议主持人。只能有一位会议组织者。

会议空间

用于举行会议的虚拟场所或持久对象（例如会议室）。在任何时间，一个会议室中只能进行一场正在进行的会议。会议空间还可帮助用户开会和查找共享资源。

会议 URI

可点击的网址，用于发起或加入通话。每次通话都有一个唯一的网址，由 https://meet.google.com/ 后跟会议代码组成。例如 https://meet.google.com/abc-mnop-xyz。

参与者

加入通话或使用副屏模式的人员、以观看者身份观看通话的人员，或连接到通话的会议室设备。每个人都有一个 participants 资源。当参与者加入会议时，系统会为其分配一个唯一 ID。

参与者会话

为加入通话的每个参与者-设备对创建的唯一会话 ID。每个会话都有一个 participantSessions 资源。如果参与者通过同一参与者-设备对多次加入同一通话，系统会为每次加入分配唯一的会话 ID。

SIP 地址

会话发起协议 (SIP) 地址详细说明了第三方视频会议硬件如何查找和加入 Meet 会议。Meet 支持 SIP URI 方案。