Google Meet REST API 總覽

您可以使用 Google Meet REST API 建立及管理 Google Meet 會議，也能直接從應用程式為使用者提供進入點。

您可以透過 Meet REST API 執行以下操作：

  • 建立會議空間，以便透過視訊將使用者交流互動。
  • 依資源名稱取得會議空間或會議。
  • 取得參與者和參與者工作階段清單。
  • 取得會議成果 (錄製內容、轉錄稿和轉錄稿項目)。

您也可以使用 Google Workspace Event API 訂閱 Meet 活動。如要收到變更通知，您可以訂閱指定會議空間，或屬於特定使用者的所有會議空間。 詳情請參閱「使用 Google Workspace 活動 API 訂閱活動」和「訂閱 Google Meet 事件」。

用途

應用程式可與 Meet REST API 整合，執行下列工作：

  • 會議開始前：視需要建立會議空間，打造會議體驗。您也可以管理邀請對象及預先調整各項設定。

  • 在會議期間：根據傳回的中繼資料擷取會議資訊，以變更應用程式體驗。

  • 會議結束後：擷取會議成果，例如錄製和語音轉錄內容。

以下是可能想使用 Meet REST API 的情況，例如：

  • 銷售和帳戶管理

    • 擷取會議和參與者資訊，以供記錄之用。
    • 擷取會議成果並張貼到帳戶中。
    • 運用 AI 模型執行語音轉錄和錄音內容，產生指導和銷售效益分析。

  • 學習與發展

    • 建立會議並預先設定培訓用途。
    • 將共同主辦人角色指派給訓練講師和課程負責人。
    • 擷取錄製內容，方便學生在課程結束後複習教材。

  • 開發人員營運

    • 建立會議，方便團隊成員立即交流互動。
    • 分享即時會議和參與者資訊，讓其他利害關係人加入進行中的會議。
    • 透過 AI 模型執行語音轉錄資料，產生正確的後續步驟。
在 Chat 聊天室中為同事建立及加入動態會議。
圖 1.在 Chat 聊天室中發起動態會議並與同事加入。

您也可以將其他 Google Workspace API (例如 Chat API) 整合至應用程式，進一步促進協作。詳情請參閱「 Chat 用途」。

常見詞彙

以下是此 API 中使用的常見詞彙清單：

構件
Meet 為回應會議而產生的檔案，例如錄製內容和transcripts。一般來說，會議結束後，就可以立即擷取構件。
日曆活動
Google 日曆中有多位與會者的活動，通常由會議發起人建立，內含會議參加資訊。Meet 可能是活動的會議解決方案。
服務專線
使用 Meet 的會議，或通知其他人通話已開始或進行中，並允許對方立即加入。
會議
會議是指會議空間中的「通話」的情況。使用者通常會將此情境視為一場會議。
共同主辦人
「通話」中，已獲得主機授予主機管理權限的人員 (但無法移除原始主機的權限)。
主機
建立通話的使用者 (會議發起人) 或控制通話的使用者。請注意，會議發起人可以主持會議，但會出席者無法出席。主機也可以將主機權限委派給共同主辦人。
會議代碼

可輸入的不重複 10 個字元字串，用於會議空間的會議 URI 中使用的會議空間。不會區分大小寫。例如：abc-mnop-xyz。長度上限為 128 個半形字元。

請勿長期儲存會議代碼，因為會議代碼可能會與會議空間解除關聯，且日後可用於不同的會議空間。一般來說，會議代碼會在上次使用後的 365 天失效。詳情請參閱「瞭解 Google Meet 中的會議代碼」。

會議名稱

伺服器產生的不重複 ID，用來識別會議空間。交易 ID 有大小寫之分例如：jQCFfuBOdN5z。會議 ID 會傳回 spaces 資源的 name 欄位中。

會議發起人

建立會議空間的使用者。這位使用者也可以視為會議擁有者他們可能不在通話期間或會議主辦人中。只能有一位會議發起人。

會議空間

舉辦會議的虛擬地點或永久物件 (例如會議室)。一次只能在一個聊天室中舉辦一場進行中的會議。此外，會議空間也能協助使用者找到及尋找共用資源。

會議 URI

可點選的網址，啟動或將使用者加入通話。每次呼叫都有專屬網址，由 https://meet.google.com/ 和會議代碼組成。例如：https://meet.google.com/abc-mnop-xyz。

參與者

加入通話或使用夥伴模式、以觀看者身分觀看的使用者，或連線至通話的會議室裝置。每個人都有一個 conferenceRecords.participants 資源。參與者加入會議時，系統會指派專屬 ID。

參與者工作階段

為加入通話的每個參與者裝置組合建立的專屬工作階段 ID。每個工作階段都有一個 conferenceRecords.participants.participantSessions 資源。如果參與者多次從同一參與者/裝置配對加入同一呼叫，這些參與者會分別獲得指派的專屬工作階段 ID。

API 專屬授權和驗證資訊

授權範圍是您要求使用者授權的應用程式來存取會議內容。當使用者安裝應用程式時，系統會要求使用者驗證這些範圍。一般來說，您應盡可能選擇範圍最狹窄的範圍，避免要求應用程式不需要的範圍。使用者較能輕鬆授予明確說明範圍的存取權。

Meet REST API 支援下列 OAuth 2.0 範圍：

範圍程式碼 說明 用量
https://www.googleapis.com/auth/meetings.space.readonly 允許應用程式讀取使用者可存取的任何會議空間相關中繼資料。 敏感內容
https://www.googleapis.com/auth/meetings.space.created 允許應用程式建立、修改及讀取應用程式所建立會議空間的相關中繼資料。 敏感內容
https://www.googleapis.com/auth/drive.readonly 允許應用程式從 Google Drive API 下載錄音和轉錄稿檔案。 受限制

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