Google Meet REST API 總覽

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

使用 Meet REST API,您可以執行下列操作:

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

您也可以使用 Google Workspace Events API 訂閱 Meet 事件。如要接收變更通知,您可以訂閱特定會議空間,或訂閱指定使用者擁有的所有會議空間。詳情請參閱「使用 Google Workspace Events API 訂閱事件」和「訂閱 Google Meet 事件」。

用途

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

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

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

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

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

  • 銷售與帳戶管理

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

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

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

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

常見詞彙

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

構件
Meet 針對會議產生的檔案,例如 recordingstranscripts。 會議結束後,通常很快就能擷取構件。
日曆活動
Google 日曆活動,通常由會議發起人建立,內含會議參加資訊,且有多位參與者。 Meet 可能是活動的會議解決方案。
Call
使用 Meet 發起工作階段,或通知他人通話即將開始或正在進行中,並允許他們立即加入。
會議
會議是會議空間內的通話例項。使用者通常會將這個情境視為單一會議。
共同主辦人
通話中的使用者,由主辦人授予主辦人管理權限,但無法移除原主辦人。
主機
建立通話的使用者 (會議發起人) 或通話控制者。請注意,會議發起人可以安排會議,但不必親自出席。主辦人也可以將主辦人權限委派給共同主辦人
會議代碼

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

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

會議名稱

伺服器產生的專屬 ID,用於識別會議空間。須區分大小寫。例如:jQCFfuBOdN5z。會議 ID 會在 spaces 資源的 name 欄位中傳回。

會議發起人

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

會議空間

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

會議 URI

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

參與者

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

參與者工作階段

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