建立沒有成員的聊天室。可用於建立具名聊天室。系統不支援依主題分組的聊天室。如需範例說明,請參閱「建立聊天室」。
如果在建立聊天室時收到 ALREADY_EXISTS
錯誤訊息,請嘗試其他displayName
。Google Workspace 機構中的某個聊天室可能已使用這個顯示名稱。
如果您是開發人員預覽版計畫的成員,可以使用 spaceType.GROUP_CHAT
在匯入模式中建立群組通訊。
需要使用者驗證。
HTTP 要求
POST https://chat.googleapis.com/v1/spaces
這個網址使用 gRPC 轉碼語法。
查詢參數
參數 | |
---|---|
requestId |
選用設定。這項要求的專屬 ID。建議隨機產生 UUID。指定現有的要求 ID 時,系統會傳回使用該 ID 建立的聊天室,而不會建立新空間。在同一個 Chat 應用程式中指定現有要求 ID,且該要求 ID 與不同驗證的使用者相同,系統會傳回錯誤。 |
要求主體
要求主體包含 Space
的例項。
回應主體
如果成功,回應主體會包含新建立的 Space
例項。
授權範圍
需要下列其中一種 OAuth 範圍:
https://www.googleapis.com/auth/chat.import
https://www.googleapis.com/auth/chat.spaces
https://www.googleapis.com/auth/chat.spaces.create
詳情請參閱授權指南。