開始使用 Meet Media API

如要使用 Google Meet Media API 及其相關的 OAuth 範圍,應用程式必須遵守下列規定。

技術相關規定

使用 Meet Media API 時,系統會強制執行下列限制:

為獲得最佳結果和支援,請注意下列事項:

  • 用戶端使用 libwebrtc 程式庫,且版本與最新 STABLE Chromium 版本相差不超過 12 個月。Chromium 瀏覽器會使用 libwebrtc 實作 WebRTC JavaScript API。

  • 用戶端維持最低頻寬 4 Mbps

編解碼廢止政策

  • Google 保留隨時停止使用編碼器的權利。

  • 推出新編解碼時,開發人員會在 12 個月前收到通知,客戶必須在這個時間點前支援這個編解碼。

驗證及授權

Google Meet Media API 用戶端會代表特定使用者連線至會議,並使用 OAuth 2.0 進行驗證和授權

適當的存取權

符合 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 範圍附加規定」。如果您在伺服器上儲存 (或傳輸) 受限制範圍的資料,就必須接受安全性評估。

如果應用程式需要存取其他 Google API,您也可以新增這些範圍。如要進一步瞭解 Google API 範圍,請參閱「使用 OAuth 2.0 存取 Google API」。

如要定義要向使用者和應用程式審查人員顯示哪些資訊,請參閱「設定 OAuth 同意畫面並選擇範圍」。

如要進一步瞭解特定 OAuth 2.0 範圍,請參閱「Google API 適用的 OAuth 2.0 範圍」。