Google 会使用 AI 技术将内容翻译成您偏好的语言。AI 翻译可能包含错误。

Meet Media API 使用入门

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

技术要求

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

客户端必须支持以下所有编解码器：
- AV1
- VP9
- VP8
客户端必须使用符合 Meet Media API 的编解码器要求的编解码器实现，包括：
- libvpx (Google) 来解码 VP8 或 VP9
- dav1d (VideoLAN) 来解码 AV1
客户端必须支持以下 WebRTC 标头扩展：
- 绝对发送时间
- 传输级拥塞控制
- 绝对捕获时间
- 依赖项描述符
- 音频电平指示 (urn:ietf:params:rtp-hdrext:ssrc-audio-level)
客户端必须定期发送全套指标。如需了解详情，请参阅客户端指标页面。

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

客户端应使用 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 用户数据的广泛访问权限，因此您需要完成受限范围验证流程。如需了解此要求，请参阅《Google API 服务用户数据政策》和特定 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 参与者还必须满足一些最低要求，会议才能符合条件。

移动应用版本

对于移动设备用户，他们必须更新到以下版本：

平台	App	版本
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 应用中创建时未达到同意年龄的账号。

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

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