Google Meet REST API 概览

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

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

  • 创建会议空间，让用户通过视频交流。
  • 按资源名称获取会议空间或会议。
  • 获取参与者和参与者会话列表。
  • 获取会议内容（录制内容、转写内容和转写条目）。

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

用例

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

  • 会议开始前：通过创建会议空间来根据需要定制会议体验。您还可以管理邀请对象和预配置设置。

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

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

您可能希望将 Meet REST API 用于以下方面的一些示例：

  • 销售和客户管理

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

  • 学习与发展

    • 创建并预配置培训会议。
    • 为培训师和会议负责人分配共同主持人角色。
    • 检索可让学生在课程结束后复习资料的录制内容。

  • 开发者运营

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

您还可以将 Chat API 等其他 Google Workspace API 整合到您的应用中，以进一步促进协作。如需了解详情，请参阅 Chat 用例。

常用术语

下面列出了此 API 中使用的常用术语：

工件
Meet 为响应会议而生成的文件，例如录制内容和transcripts。 通常情况下，工件在会议结束后很快就可供提取。
日历活动
Google 日历中有多名参加者的活动，通常由会议组织者创建，其中包含会议的加入信息。Meet 可能是适合活动的会议解决方案。
通话
使用 Meet 进行的会话，或者通知其他人通话正在开始或正在进行，并允许他们立即加入。
会议
会议是指会议空间中的一次通话实例。用户通常会将这种情况视为一次会议。
共同主持人
通话中已被主持人授予的主持人管理权限的人员，但无法移除原始主持人。
主机
创建通话的人（会议组织者）或控制通话的人。请注意，会议组织者可以组织会议 但不能在会议开始后出席主机还可以将主机权限委托给共同主持人。
会议代码

会议空间的可输入的唯一字符串，该字符串由 10 个字符组成，且在会议空间的会议 URI 中使用。不区分大小写。例如 abc-mnop-xyz。长度上限为 128 个字符。

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

会议名称

由服务器生成的唯一 ID，用于标识会议空间。区分大小写。例如 jQCFfuBOdN5z。会议 ID 会在 spaces 资源的 name 字段中返回。

会议组织者

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

会议空间

举行会议的虚拟地点或永久性对象（例如会议室）。在一个空间内，同一时间只能举行一场正在进行的会议。会议空间还有助于用户开会和查找共享资源。

会议 URI

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

参与者

加入通话或使用副屏模式的用户、以观众身份观看或通过连接到通话的房间设备观看。每个人都有一项 conferenceRecords.participants 资源。当参与者加入会议时，系统会分配一个唯一 ID。

参与者会话

为加入通话的每个参与者-设备对创建的唯一会话 ID。每个会话都有一个 conferenceRecords.participants.participantSessions 资源。如果参与者多次从同一参与者-设备对加入同一通话，则每个人都会获得唯一的会话 ID。

API 特定的授权和身份验证信息

授权范围是您请求用户授予您的应用访问会议内容的权限。当用户安装您的应用时，系统会要求用户验证这些范围。通常，您应尽可能选择聚焦范围最窄的范围，避免请求应用不需要的范围。用户更乐意授予对有限且明确说明范围的访问权限。

Meet REST API 支持以下 OAuth 2.0 范围：

范围代码 说明 用量
https://www.googleapis.com/auth/meetings.space.readonly 允许应用读取用户有权访问的任何会议空间的元数据。 敏感内容
https://www.googleapis.com/auth/meetings.space.created 允许应用创建、修改和读取与您应用创建的会议空间相关的元数据。 敏感内容
https://www.googleapis.com/auth/drive.readonly 允许应用通过 Google Drive API 下载录音和转录文件。 受限

如需详细了解特定 OAuth 2.0 范围，请参阅 Google API 的 OAuth 2.0 范围。