借助 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 模型运行转录数据,以生成正确的后续步骤。
您还可以将其他 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 范围。
相关主题
如需了解如何使用 Google Workspace API 进行开发(包括处理身份验证和授权),请参阅在 Google Workspace 上开发。
如需了解如何使用 Meet REST API 创建会议空间,请参阅使用会议空间指南。
如需了解如何订阅 Google Workspace 事件,请参阅使用 Google Workspace Events API 订阅事件。