Google Meet 會議空間簡介

Google Meet REST API
插圖

本指南說明如何使用 Google Meet REST API 建立及管理 Google Meet 會議。

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

如要使用會議空間,請參閱「建立及管理會議空間」。如要瞭解如何以程式輔助方式設定會議空間,請參閱「設定會議空間和成員」。

如何呼叫會議聊天室方法

下表詳細列出使用會議空間方法所需的會議角色:

方法 擁有者 參與者 其他
endActiveConference x
get x x x
     透過設定 x
     有進行中的會議 x x
patch x

Meet 如何識別會議空間

Google Meet REST API 會為每個會議空間產生 spaces 資源。spaces 資源提供多個加入會議的進入點。

下表說明如何識別及加入會議空間:

欄位名稱 說明
name 聊天室名稱。{space} 字串是聊天室的資源 ID,格式為 spaces/{space}。這是伺服器產生的專屬 ID,且會區分大小寫。例如:spaces/jQCFfuBOdN5z
meetingCode 聊天室名稱的別名。{meetingCode} 是可輸入的專屬字元字串,且不區分大小寫。格式為 spaces/{meetingCode}。例如:spaces/abc-mnop-xyz。長度上限為 128 個字元。 這是 meetingUri 的一部分: https://meet.google.com/abc-mnop-xyz
phoneAccess 這個會議空間的電話存取方式。phoneAccess 物件包含撥入電話會議所需的資訊,包括會議空間的區域電話號碼,以及該電話號碼專用的 PIN 碼。PIN 碼只包含十進位數字,長度可能不一。例如:"pin": 19707127300

與 Meet UI 類似,spaces 資源包含一組有限的撥入號碼。如要查看會議空間的其他電話號碼,請在下列網址中附加 {meetingCode}https://meet.google.com/tel/。例如:https://meet.google.com/tel/abc-mnop-xyz
gatewaySipAccess 這個會議空間的對話啟動協定 (SIP) 存取方法。SIP 位址詳細說明第三方視訊會議硬體如何尋找及加入 Meet 會議。gatewaySipAccess 物件包含 URI 和數字存取代碼。Meet 支援 SIP URI 配置

如要管理會議空間,請為 name 欄位使用下列值:

  • 如要取得會議空間的詳細資料,可以使用 spaces/{space} 或別名 spaces/{meetingCode}。詳情請參閱取得會議空間

  • 如要更新會議空間的詳細資料,只能使用 spaces/{space}。 詳情請參閱更新會議空間

  • 如要在會議空間中結束進行中的通話,只能使用 spaces/{space}。詳情請參閱「結束進行中的會議」。