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 聊天室中创建和加入与同事动态会议。

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

常用术语

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

工件
Meet 为回应会议而生成的文件，例如录制内容和transcripts。 通常情况下，会议结束后不久就可以提取工件了。
日历活动
Google 日历中有多位参加者的活动，通常由会议组织者创建，其中包含会议的加入信息。Meet 可能是该活动的会议解决方案。
通话
使用 Meet 进行的会议，或通知其他人有通话开始或正在进行并允许他们立即加入。
会议
会议是会议空间内的一次通话。用户通常会将此场景视为单次会议。
共同主持人
由主持人授予主机管理权限但不能移除原始主机的通话人员。
主机
通话的创建者（会议组织者）或通话控制者。请注意，会议组织者可以组织会议，但在会议进行时无法到场。主机可以将主机权限委托给共同主持人。
会议代码
一个可输入且包含 10 个字符的唯一字符串，用于会议空间，在会议空间的加入网址内使用。例如 abc-mnop-xyz。会议代码不应长期存储，因为它们可能会与会议空间分离，并且将来可以重复用于其他会议空间。通常，会议代码会在最后一次使用 365 天后过期。如需了解详情，请参阅了解 Google Meet 中的会议代码。
会议名称
由服务器生成的唯一 ID，用于标识会议空间。会议 ID 会在 spaces 资源的 name 字段中返回。
会议组织者
创建会议空间的用户。此用户也可以被视为会议所有者。他们可能不在通话期间，也可能不是会议主持人。只能有一位会议组织者。
会议空间
举行会议的虚拟地点或持续性对象（例如会议室）。一个聊天室中一次只能召开一场正在进行的会议。会议空间还有助于用户会面和查找共享资源。
参与者
已加入通话或使用伙伴模式、以观看者身份观看或连接到通话的房间设备的用户。每个人都有一个 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 范围。