建立聊天室。可用於在 Import mode 中建立命名聊天室或群組通訊。如需範例，請參閱「建立聊天室」。
支援下列類型的驗證：
以應用程式身分進行驗證時，請務必在要求中設定 space.customer 欄位。
建立聊天室時的聊天室成員資格，取決於聊天室是在 Import mode 中建立：
- 匯入模式：不會建立任何成員。
- 所有其他模式：系統會將呼叫端使用者新增為成員。如下：
- 使用應用程式驗證時的應用程式本身。
- 使用者驗證功能時的使用者。
如果在建立聊天室時收到 ALREADY_EXISTS 錯誤訊息，請嘗試使用其他 displayName。Google Workspace 機構中現有的聊天室可能已使用這個顯示名稱。
HTTP 要求
POST https://chat.googleapis.com/v1/spaces
這個網址使用 gRPC 轉碼語法。
查詢參數
| 參數 | |
|---|---|
request |
選用設定。此要求的專屬 ID。建議使用隨機 UUID。指定現有要求 ID 會傳回使用該 ID 建立的聊天室，而不是建立新的聊天室。使用不同的已驗證使用者，指定相同 Chat 應用程式中的現有要求 ID 會傳回錯誤。 |
要求主體
要求主體包含 Space 的例項。
回應主體
如果成功，回應主體會包含新建立的 Space 例項。
授權範圍
需要下列其中一種 OAuth 範圍：
https://www.googleapis.com/auth/chat.app.spaces.createhttps://www.googleapis.com/auth/chat.app.spaceshttps://www.googleapis.com/auth/chat.importhttps://www.googleapis.com/auth/chat.spaceshttps://www.googleapis.com/auth/chat.spaces.create
詳情請參閱授權指南。