如要使用 Google Meet Media API 和相關聯的 OAuth 2.0 範圍,應用程式必須符合下列規定。
技術相關規定
使用 Meet Media API 時,系統會強制執行下列限制:
用戶端必須支援下列所有轉碼器:
AV1VP9VP8
用戶端必須使用符合 Meet Media API 編解碼器需求的編解碼器實作,包括:
libvpx(Google) 解碼VP8或VP9dav1d(VideoLAN) 解碼AV1
用戶端必須支援下列 WebRTC 標頭擴充功能:
用戶端必須定期傳送完整套件指標。詳情請參閱用戶端指標頁面。
如要獲得最佳結果和支援服務,請按照下列步驟操作:
用戶應使用
libwebrtc程式庫,且版本應不超過最新STABLEChromium 版本12 個月。Chromium 瀏覽器會使用libwebrtc實作 WebRTC JavaScript API。用戶端應維持至少 4 Mbps 的頻寬。
啟用 Meet REST API
使用 Google API 前,您需要在 Google Cloud 專案中啟用這些 API。 您可以在單一 Google Cloud 專案中啟用一或多個 API。在 Google Cloud 控制台啟用 Google Meet REST 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 範圍都受到限制:
- 受限制:這些範圍可廣泛存取 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 參與者也必須符合一些最低需求,會議才能符合資格。
行動應用程式版本
行動裝置使用者必須更新至下列版本:
| 平台 | 應用程式 | 版本 |
|---|---|---|
| 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 應用程式中建立帳戶時,使用者未滿規定年齡。
請注意,部分地區 (例如歐盟) 對於未成年帳戶有額外限制。
如果您認為使用者的帳戶受到限制,可以提供年齡驗證,確認帳戶是否已通過年齡驗證。進一步瞭解如何驗證年齡