會議空間代表舉辦會議的虛擬地點或永久物件 (例如會議室)。一次只能在一個聊天室中舉辦一場進行中的會議。會議空間也能協助使用者找到及尋找共用資源。
以下各節詳細說明如何建立、取得及更新會議空間。
Meet 如何識別會議空間
Google Meet REST API 會為每個會議空間產生 spaces
資源。name
欄位是資源的資源名稱。
以下是使用 name
欄位識別會議空間的兩個重要方式:
space
是聊天室的資源 ID,格式為spaces/{space}
。這個 ID 是伺服器產生的不重複 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。