Method: spaces.create

建立沒有成員的聊天室。可用於在 Import mode 中建立命名聊天室或群組通訊。不支援依主題分組的聊天室。如需範例,請參閱「建立聊天室」。

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

支援以下類型的驗證

以應用程式進行驗證時,必須在要求中設定 space.customer 欄位。

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.app.spaces.create
  • https://www.googleapis.com/auth/chat.app.spaces
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.create

詳情請參閱授權指南