Method: spaces.setup

{
  "space": {
    object (Space)
  },
  "requestId": string,
  "memberships": [
    {
      object (Membership)
    }
  ]
}

object (Space)

必要欄位。Space.spaceType 為必填欄位。

如要建立聊天室，請將 Space.spaceType 設為 SPACE，並設定 Space.displayName。如果在設定聊天室時收到 ALREADY_EXISTS 錯誤訊息，請嘗試使用其他 displayName。Google Workspace 機構中的現有聊天室可能已使用這個顯示名稱。

如要建立群組通訊，請將 Space.spaceType 設為 GROUP_CHAT。請勿設定 Space.displayName。

如要在真人之間建立 1:1 對話，請將 Space.spaceType 設為 DIRECT_MESSAGE，並將 Space.singleUserBotDm 設為 false。請勿設定 Space.displayName 或 Space.spaceDetails。

如要建立人與呼叫 Chat 應用程式之間的 1:1 對話，請將 Space.spaceType 設為 DIRECT_MESSAGE，並將 Space.singleUserBotDm 設為 true。請勿設定 Space.displayName 或 Space.spaceDetails。

如果 DIRECT_MESSAGE 聊天室已存在，系統會傳回該聊天室，而不會建立新聊天室。

string

選用設定。這項要求的專屬 ID。建議使用隨機 UUID。指定現有的要求 ID 時，系統會傳回使用該 ID 建立的聊天室，而不會建立新空間。使用不同的已驗證使用者，指定相同 Chat 應用程式中的現有要求 ID 會傳回錯誤。

object (Membership)

選用設定。邀請加入聊天室的 Google Chat 使用者或群組。請省略呼叫使用者，因為系統會自動加入該使用者。

目前此集合允許最多 20 個會員 (除了呼叫端)。

針對人類會員，Membership.member 欄位必須包含 user，並填入 name (格式：users/{user})，且 type 設為 User.Type.HUMAN。您只能在設定聊天室時新增使用者 (只有在透過通話應用程式設定即時訊息時，才能新增 Chat 應用程式)。您也可以使用使用者的電子郵件地址做為 {user} 的別名，新增成員。例如，user.name 可以是 users/example@gmail.com。如要邀請 Gmail 使用者或外部 Google Workspace 網域的使用者，必須使用使用者的電子郵件地址來邀請 {user}。

針對 Google 群組成員資格，Membership.group_member 欄位必須包含已填入 name 的 group (格式為 groups/{group})。您只能在將 Space.spaceType 設為 SPACE 時新增 Google 群組。

將 Space.spaceType 設為 SPACE 時可選用。

將 Space.spaceType 設為 GROUP_CHAT，且至少有兩個成員時，此為必要欄位。

當您將 Space.spaceType 設為 DIRECT_MESSAGE 並與真人使用者連結時，必須使用這項屬性，且只能連結一個會員資格。

為真人和發出呼叫的 Chat 應用程式進行 1:1 對話 (將 Space.spaceType 設為 DIRECT_MESSAGE，並將 Space.singleUserBotDm 設為 true 時)，這個欄位必須留空。