開始使用 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 專案中啟用這些 API。 您可以在單一 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 參與者也必須符合一些最低需求,會議才能符合資格。

行動應用程式版本

行動裝置使用者必須更新至下列版本:

平台 應用程式 版本
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 應用程式中建立帳戶時,使用者未滿規定年齡。

請注意,部分地區 (例如歐盟) 對於未成年帳戶有額外限制。

如果您認為使用者的帳戶受到限制,可以提供年齡驗證,確認帳戶是否已通過年齡驗證。進一步瞭解如何驗證年齡