本指南說明如何使用 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}。詳情請參閱「結束進行中的會議」。