Method: spaces.create

建立沒有成員的聊天室。可用於建立具名聊天室。系統不支援依主題分組的聊天室。如需範例說明,請參閱「建立聊天室」。

如果在建立聊天室時收到 ALREADY_EXISTS 錯誤訊息,請嘗試其他displayName。Google Workspace 機構中的某個聊天室可能已使用這個顯示名稱。

如果您是開發人員預覽版計畫的成員,可以使用 spaceType.GROUP_CHAT 在匯入模式中建立群組通訊。

需要使用者驗證

HTTP 要求

POST https://chat.googleapis.com/v1/spaces

這個網址使用 gRPC 轉碼語法。

查詢參數

參數
requestId

string

選用設定。這項要求的專屬 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

詳情請參閱授權指南