借助 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 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 范围。
相关主题
如需了解如何使用 Google Workspace API 进行开发(包括处理身份验证和授权),请参阅在 Google Workspace 上开发。
如需了解如何使用 Meet REST API 创建会议空间,请参阅使用会议空间指南。
如需了解如何订阅 Google Workspace 事件,请参阅使用 Google Workspace Events API 订阅事件。