Method: spaces.create

建立已命名的聊天室。系統不支援依主題分組的聊天室。如需範例說明,請參閱「建立聊天室」。

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

必須完成使用者驗證

HTTP 要求

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

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

查詢參數

參數
requestId

string

選用設定。這項要求的專屬 ID。建議使用隨機 UUID。指定現有的要求 ID 會傳回以該 ID 建立的聊天室,而不會建立新聊天室。如果以不同的已驗證使用者指定相同的 Chat 應用程式,指定現有的要求 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

詳情請參閱授權指南