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 云项目中启用它们。您可以在单个 Google Cloud 项目中启用一个或多个 API。

  • 在 Google Cloud 控制台中，启用 Google Meet REST API。

    启用 API

编解码器弃用政策

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

  • 在推出新编解码器时，开发者将收到 12 个月通知 ，之后客户端才需要支持此编解码器。

身份验证和授权

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

合适的访问权限

Meet Media 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 范围都受到限制：

除了 Meet Media API 范围之外，您还必须使用 OAuth 请求常规读取会议范围。此范围是访问会议元数据（例如参与者和媒体条目信息）以及协商成功连接所必需的。

范围代码 说明 用法
https://www.googleapis.com/auth/meetings.space.read 允许应用读取用户有权访问的任何会议室的元数据。 敏感

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

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

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

对最终用户的要求

如需使用 Meet Media API，Meet 参与者还必须满足一些最低要求，会议才有资格使用该 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 应用中由家长创建账号时未达到同意年龄的账号。

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

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