Google Meet REST API 總覽

Google Meet REST API 可讓您建立及管理 Google Meet 會議，並提供從應用程式直接提供給使用者的進入點。

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

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

您也可以使用 Google Workspace Event API 訂閱 Meet 活動。如要接收異動通知，您可以訂閱指定會議空間，或訂閱屬於指定使用者的所有會議聊天室。詳情請參閱「使用 Google WorkspaceEvents API 訂閱活動」和「訂閱 Google Meet 活動」。

用途

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

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

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

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

您可以透過下列方式使用 Meet REST API：

  • 銷售與帳戶管理

    • 擷取會議和參與者資訊以做為錄製之用。
    • 擷取會議成果並發布至帳戶中。
    • 透過 AI 模型執行語音轉錄和記錄，產生指導與銷售成效分析。

  • 學習與發展

    • 建立及預先設定用於訓練課程的會議。
    • 為訓練講師和工作階段主管指派共同主辦人角色。
    • 擷取錄製內容，讓學生在課程結束後複習教材。

  • 開發人員作業

    • 建立會議就能立即聯繫團隊成員。
    • 透過分享即時會議和參與者資訊，讓其他相關人員加入進行中的會議。
    • 透過 AI 模型執行轉錄資料，產生正確的後續步驟。
在 Chat 聊天室中發起動態會議，並邀請同事一同加入。
圖 1.在 Chat 聊天室中發起動態會議，並邀請同事一同加入。

您也可以在應用程式中加入 Chat API 等其他 Google Workspace API，進一步實現協作。詳情請參閱「 Chat 用途」。

常見詞彙

下列是此 API 的常見詞彙：

成果
Meet 為回應會議而產生的檔案，例如錄製的內容和transcripts。通常會議結束後，很快就能擷取成果。
日曆活動
Google 日曆中有多位參與者的活動，通常由會議發起人建立，內含會議的參加資訊。會議可能是活動的會議解決方案。
服務專線
使用 Meet 進行的會議。或者，通知其他使用者即將或正在進行通話，並讓他們立即加入。
會議
會議是指會議空間中的通話活動。使用者通常會將這種情況視為單次會議。
共同主辦人
呼叫中的人員，已獲得主機授予主機管理權限，但無法移除原始主機。
主機
建立通話的使用者 (會議發起人) 或通話控制者。請注意，會議發起人可以發起會議，但會議期間無法進行。主機也可以將主機權限委派給「共同主機」。
會議代碼
在會議空間的加入網址中使用可輸入的不重複 10 個字元字串，用於會議空間。例如 abc-mnop-xyz。請勿長期儲存會議代碼，因為會議代碼可能會與會議空間脫離，且日後可重複用於不同的會議空間。一般來說，會議代碼會在上次使用後的 365 天到期。詳情請參閱「瞭解 Google Meet 的會議代碼」。
會議名稱
伺服器產生的專屬 ID，用於識別會議空間。會議 ID 會在 spaces 資源的 name 欄位中傳回。
會議發起人
建立會議聊天室的使用者。這位使用者也可以視為會議擁有者。這些磁碟可能未在通話期間出現，也可能不是會議主機。但只能有一個會議發起人。
會議空間
舉辦會議的虛擬地點或永久物件 (例如會議室)。我們一次只能在一個空間中舉辦一場進行中的會議。會議空間也能協助使用者認識及尋找共用資源。
參與者
加入通話的使用者、使用夥伴模式、以觀看者的身分觀看，或是使用已接通通話的會議室裝置。每個人都有一項 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 範圍」。