Google Meet REST API 總覽

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

使用 Meet REST API，您可以執行下列操作：

  • 建立會議空間，讓使用者透過視訊連線。
  • 依資源名稱取得會議空間或會議。
  • 取得參與者和參與者工作階段的清單。
  • 取得會議構件 (錄製內容、轉錄稿和轉錄稿項目)。

您也可以使用 Google Workspace Events API 訂閱 Meet 事件。如要接收變更通知，您可以訂閱特定會議空間，或是訂閱特定使用者擁有的所有會議空間。如需詳細資訊，請參閱：

用途

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

  • 會議前：建立會議空間，視需要調整會議體驗。你也可以管理受邀者及預先設定。

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

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

以下是您可能會想使用 Meet REST API 的幾項範例：

  • 銷售與帳戶管理

    • 擷取會議和參與者資訊，以供記錄。
    • 擷取會議構件，並發布到帳戶中。
    • 透過 AI 模型轉錄及錄製內容，生成教練和銷售成效分析。

  • 學習與發展

    • 建立並預先設定訓練會議。
    • 將共同主辦人角色指派給訓練人員和工作階段負責人。
    • 擷取錄製內容，讓學生在課程結束後複習教材。

  • 開發人員營運

    • 建立會議，立即與隊友連線。
    • 分享即時會議和參與者資訊，讓其他利害關係人加入進行中的會議。
    • 透過 AI 模型執行轉錄資料，生成正確的後續步驟。
在 Chat 聊天室中與同事建立及加入動態會議。
圖 1. 在 Chat 聊天室中與同事建立及加入動態會議。

您也可以在應用程式中整合其他 Google Workspace API (例如 Chat API)，進一步提升協作體驗。詳情請參閱「Chat 使用案例」。

常見詞彙

以下列出這個 API 常用的詞彙：

構件
Meet 針對會議產生的檔案，例如 recordings 和 transcripts。 系統會將構件儲存至會議發起人的 Google 雲端硬碟。通常在會議結束後不久即可擷取。
日曆活動
Google 日曆活動，通常由會議主辦者建立，內含會議參加資訊。Meet 可能是活動的會議解決方案。
Call
使用 Meet 發起工作階段，或通知其他使用者通話即將開始或正在進行中，並允許他們立即加入。
會議
會議是會議空間內的通話例項。使用者通常會將這個情境視為單一會議。
分區戰績
每個會議執行個體的專屬 ID。會議開始時，系統會自動建立會議室。conferenceRecords 資源使用 conferenceRecords/{conferenceRecord} 格式。例如：conferenceRecords/kRyYx8b7vNDsLpR1tG_cNjFUQBoBRhHIMoGJAJkBCQ。
共同主辦人
通話中的使用者，由主辦人授予主辦人管理權限，但無法移除原主辦人。
撥入
使用電話參與通話或收聽串流通話。
主機
建立通話的使用者 (會議發起人) 或通話控制者。請注意，會議發起人可以安排會議，但不必親自出席。主辦人也可以將主辦人權限委派給共同主辦人。
會議代碼

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

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

會議名稱

伺服器產生的專屬 ID，用於識別會議空間。須區分大小寫。例如：jQCFfuBOdN5z。會議 ID 會在 spaces 資源的 name 欄位中傳回。詳情請參閱「Meet 如何識別會議空間」。

會議發起人

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

會議空間

虛擬空間或持續存在的物件 (例如會議室)，用來舉辦會議。一個空間一次只能有一場進行中的會議。會議空間也能協助使用者開會及尋找共用資源。

會議 URI

可點選的網址，使用者可透過這個網址發起或加入通話。每場通話都有專屬網址，由 https://meet.google.com/ 和會議代碼組成。例如：https://meet.google.com/abc-mnop-xyz。

參與者

使用者加入通話或使用夥伴模式，以觀眾身分觀看通話，或是會議室裝置已連線至通話。每人可獲得一項資源。participants參與者加入電話會議時，系統會指派專屬 ID。

參與者工作階段

系統會為加入通話的每位參與者和裝置配對建立專屬工作階段 ID。每個工作階段都有一個 participantSessions 資源。如果參與者使用同一部裝置多次加入同一通電話，系統會為每次加入作業指派專屬的工作階段 ID。

SIP 位址

工作階段啟動通訊協定 (SIP) 位址詳細說明第三方視訊會議設備如何尋找及加入 Meet會議。Meet 支援 SIP URI 配置。