建立沒有成員的聊天室。可用於在 Import mode
中建立命名聊天室或群組通訊。不支援依主題分組的聊天室。如需範例,請參閱「建立聊天室」。
如果在建立聊天室時收到 ALREADY_EXISTS
錯誤訊息,請嘗試使用其他 displayName
。Google Workspace 機構內的現有聊天室可能已使用這個顯示名稱。
支援以下類型的驗證:
以應用程式進行驗證時,必須在要求中設定 space.customer
欄位。
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.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
詳情請參閱授權指南。