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 和 smartNotes。 構件會儲存在會議發起人的雲端硬碟中。通常在會議結束後不久即可擷取。
日曆活動
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 配置。

智慧附註

Gemini 生成的會議重點和待辦事項摘要，並以 Google 文件檔案的形式匯出至會議主辦人的雲端硬碟。

轉錄稿

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

成績單登錄

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