Meet Media API 使用入门

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

技术要求

使用 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 范围。

最终用户要求

为了使会议符合条件，Meet 参与者还必须满足一些最低要求才能使用 Meet Media API。

移动应用版本

移动设备用户必须更新到以下版本：

平台 应用 版本
Android Meet 应用 309
iOS Meet 应用 308
Android Gmail 应用 2025.05.30
iOS Gmail 应用 6.0.250518

不支持的平台

我们不支持运行 Meet 的第三方硬件客户端。例如，如果您的最终用户使用的是运行 Meet 的 Cisco 硬件会议室设备，则您的 Meet Media API 实例无法加入通话。

年龄限制

Meet Media API 无法从注册为未成年人的账号收集媒体。

这些账号通常是指未达到其所在国家/地区的同意年龄（通常未满 18 周岁）的账号，或者是由家长在 Google Family Link 应用中创建时未达到同意年龄的账号。

请注意，某些地区（例如欧盟）对哪些类型的账号会被视为未满年龄的账号有额外限制。

如果您认为某位用户的账号受到限制，可以提供年龄验证信息，以检查其账号是否已通过年龄验证。详细了解如何验证您的年龄。