Method: spaces.create

建立聊天室。可用於在 Import mode 中建立命名聊天室或群組通訊。如需範例，請參閱「建立聊天室」。

支援下列類型的驗證：

  • 在開發人員預覽版中，使用管理員核准的應用程式驗證功能，以及下列授權範圍之一：

    • https://www.googleapis.com/auth/chat.app.spaces.create
    • https://www.googleapis.com/auth/chat.app.spaces

  • 使用下列其中一個授權範圍進行使用者驗證：

    • https://www.googleapis.com/auth/chat.spaces.create
    • https://www.googleapis.com/auth/chat.spaces
    • https://www.googleapis.com/auth/chat.import (僅限匯入模式聊天室)

以應用程式身分進行驗證時，請務必在要求中設定 space.customer 欄位。

以應用程式身分進行驗證時，Chat 應用程式會新增為聊天室的成員。不過，與人為驗證不同的是，Chat 應用程式不會新增為聊天室管理員。根據預設，所有聊天室成員都能從聊天室中移除 Chat 應用程式。如要只允許聊天室管理員從聊天室中移除應用程式，請將 space.permission_settings.manage_apps 設為 managersAllowed。

建立聊天室時，聊天室成員的組成會視聊天室是否在 Import mode 中建立而定：

  • 匯入模式：不會建立任何成員。
  • 所有其他模式：系統會將呼叫端使用者新增為成員。如下：
    • 使用應用程式驗證時的應用程式本身。
    • 使用者驗證功能時的使用者。

如果在建立聊天室時收到錯誤訊息 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.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

詳情請參閱授權指南。