會議空間代表虛擬地點或持續性物件 (例如會議室),用於舉辦會議。一個空間一次只能進行一場會議。會議空間也能協助使用者找到及尋找共用資源。
以下各節將詳細說明如何建立、取得及更新會議空間。
Meet 如何識別會議空間
Google Meet REST API 會為每個會議空間產生 spaces
資源。name
欄位是資源的資源名稱。
以下是使用 name
欄位識別會議空間的兩個重要方式:
space
是聊天室的資源 ID,格式為spaces/{space}
。這是由伺服器產生的不重複 ID,且會區分大小寫。例如:spaces/jQCFfuBOdN5z
。
。meetingCode
是聊天室的別名,格式為spaces/{meetingCode}
。這是可輸入的專屬字元字串,不區分大小寫。例如abc-mnop-xyz
。長度上限為 128 個半形字元。它會成為meetingUri
的一部分:https://meet.google.com/abc-mnop-xyz
。
如要管理會議空間,請為 {name}
欄位使用下列值:
如要取得會議空間的詳細資料,您可以使用
spaces/{space}
或別名spaces/{meetingCode}
。詳情請參閱「取得會議空間」一文。如要更新會議空間的詳細資料,您只能使用
spaces/{space}
。詳情請參閱「更新會議空間」。如要結束會議空間中的通話,您只能使用
spaces/{space}
。詳情請參閱「結束有效會議」。
建立會議聊天室
如要建立會議空間,請在 spaces
資源上使用 create
方法。
這個方法會傳回 spaces
資源的例項,其中包含會議空間的設定 SpaceConfig
物件。其中也包含 ActiveConference
物件,該物件是會議空間中目前 conferenceRecords
資源的連結。
以下程式碼範例說明如何建立會議空間:
Java
Node.js
Python
取得會議空間
如要取得會議空間的詳細資料,請在 spaces
資源上使用 get
方法,並指定 name
。詳情請參閱「Meet 如何識別會議空間」。
這個方法會傳回會議空間做為 space
資源的執行個體。
以下程式碼範例說明如何擷取會議空間:
Java
Node.js
Python
接著將聊天室名稱替換為伺服器產生的會議空間專屬 ID。
更新會議空間
如要更新會議空間的詳細資料,請使用 spaces
資源上的 patch
方法,並搭配指定的 name
。詳情請參閱「Meet 如何識別會議空間」。
patch
方法也會使用選用的 updateMask
參數。欄位的類型為 FieldMask
。這是您要在空格中更新的欄位清單 (以半形逗號分隔)。
這個方法會將會議空間傳回做為 spaces
資源的例項。
以下程式碼範例說明如何更新會議空間:
Java
Node.js
Python
將聊天室名稱替換為伺服器產生的不重複會議聊天室 ID。
結束正在進行的會議
如要在會議空間中結束進行中的會議,請在 spaces
資源上使用 spaces.endActiveConference
方法。要求和回應主體均為空白。詳情請參閱「Meet 如何識別會議空間」。
以下程式碼範例說明如何結束進行中的會議:
Java
Node.js
Python
將聊天室名稱替換為會議聊天室由伺服器產生的不重複 ID。