Meet Media API 使用入门

如需使用 Google Meet Media API 及其关联的 OAuth 范围,您的应用必须遵守以下要求。

技术要求

使用 Meet Media API 时,系统会强制执行以下限制:

为了获得最佳效果和支持,请注意以下事项:

  • 客户端使用 libwebrtc 库,并且版本不超过最新 STABLE Chromium 版本的 12 个月。Chromium 浏览器使用 libwebrtc 来实现 WebRTC JavaScript API。

  • 客户端保持至少 4 Mbps 的带宽。

启用 Meet REST API

在使用 Google API 之前,您需要在 Google Cloud 项目中启用它们。 您可以在单个 Google Cloud 项目中启用一个或多个 API。
  • 在 Google Cloud 控制台中,启用 Google Meet REST API。

    启用 API

编解码器弃用政策

  • Google 保留随时停止使用某种编解码器的权利。

  • 推出新编解码器时,开发者会提前 12 个月收到通知,以便在客户端必须支持此编解码器之前做好准备。

身份验证和授权

Google Meet Media API 客户端代表特定用户连接到会议,并使用 OAuth 2.0 进行身份验证和授权

适当的访问权限

满足媒体 API 范围

授权范围是指您请求用户授权您的应用访问会议内容的权限。当有人安装您的应用时,系统会要求用户验证这些范围。通常情况下,您应尽可能选择范围最窄的权限,并避免请求应用不需要的权限。用户更乐意向描述清晰的有限范围授予访问权限。

Meet Media API 支持以下 OAuth 2.0 范围:

范围代码 说明 用法
https://www.googleapis.com/auth/meetings.conference.media.readonly 在 Google Meet 视频通话中录制实时视频和音频。 受限
https://www.googleapis.com/auth/meetings.conference.media.audio.readonly 在 Google Meet 视频通话中录制实时音频。 受限
https://www.googleapis.com/auth/meetings.conference.media.video.readonly 采集 Google Meet 视频通话中的实时视频。 受限

由于会议的敏感性,所有 Meet Media API 范围都受到限制:

如果您的应用需要访问任何其他 Google API,您也可以添加这些范围。如需详细了解 Google API 范围,请参阅使用 OAuth 2.0 访问 Google API

如需定义向用户和应用审核者显示哪些信息,请参阅配置 OAuth 权限请求页面并选择范围

如需详细了解特定的 OAuth 2.0 范围,请参阅适用于 Google API 的 OAuth 2.0 范围