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 機構中現有的聊天室可能已使用這個顯示名稱。