Google Meet REST API 總覽

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

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

  • 建立及設定會議空間，讓使用者透過視訊連線。
  • 預先設定空間存取層級、審核設定，以及自動錄製或轉錄功能。
  • 管理會議空間成員及指派共同主辦人角色。
  • 在會議空間中，以程式輔助方式結束進行中的會議。
  • 取得會議記錄、出席狀況詳細資料和參與者工作階段中繼資料。
  • 擷取會議構件 (錄製內容、轉錄稿和轉錄稿項目)。

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

用途

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

  • 會議前：視需要建立會議空間、預先設定存取限制 (開放、信任或受限)、套用控管設定 (分享螢幕畫面、即時通訊、回應、麥克風和攝影機)、設定自動錄製或自動轉錄，以及指派空間成員擔任共同主辦人。

  • 會議期間：使用 Google Workspace Events API 擷取有效會議的中繼資料和參與者工作階段、動態管理成員、監聽即時生命週期事件，或以程式輔助方式結束有效會議。

  • 會議結束後：從 Google 雲端硬碟擷取會議記錄和出席記錄、下載錄製內容和 Google 文件轉錄稿，以及存取精細的轉錄稿語音項目，用於輔導、法規遵循或 AI 分析。

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

  • 銷售與帳戶管理

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

  • 學習與發展

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

  • 客戶支援與諮詢

    • 直接從服務台單或客戶入口網站建立安全且受限的會議空間。
    • 預先設定主辦人管理設定，確保只有支援服務專員可以分享螢幕畫面或管理出席者。
    • 啟用自動錄音或轉錄功能，確保通話品質並符合法規要求。
    • 在預約行程或支援工作階段結束時，以程式輔助方式結束進行中的會議。

  • 開發人員營運

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

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

常見詞彙

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

進行中的會議
在會議空間內進行的研討會。會議空間一次只能有一場進行中的通話。結束後，就會成為會議記錄。
構件
Meet 根據會議生成的檔案，例如recordings和transcripts。構件會儲存在會議發起人的雲端硬碟中。通常在會議結束後不久即可擷取。
日曆活動
Google 日曆活動，通常由會議發起人建立，內含如何加入會議的資訊，且有多位與會者。Meet 可能是活動的會議解決方案。
撥打電話
使用 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。

成員

使用者明確新增至會議空間，並具有指定角色 (例如 COHOST)。與僅在直播會議期間在場的參與者不同，成員會與持續存在的會議空間建立關聯，並在該空間的多場會議中保留權限。

出席者

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

參與者工作階段

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

錄製

錄製會議時產生的 MP4 影片檔案和相關中繼資料。錄製內容會儲存在會議發起人的雲端硬碟中，並可做為會議成果擷取。

SIP 位址

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

轉錄稿

記錄會議中對話內容的文字文件，並以 Google 文件檔案格式匯出至會議發起人的雲端硬碟。

成績單登錄

會議中出席者的轉錄語音片段。每個項目都包含參與者身分、時間戳記、說出的文字和語言代碼，並在會議結束後保留 30 天。