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

可选。此请求的唯一标识符。建议使用随机 UUID。指定现有请求 ID 会返回使用该 ID 创建的聊天室，而不是创建新的聊天室。如果通过同一 Chat 应用向其他经过身份验证的用户指定现有请求 ID，系统就会返回错误。

object (Membership)

可选。受邀加入聊天室的 Google Chat 用户。省略发起调用的用户，因为系统会自动添加这些用户。

除调用方之外，该组目前最多允许 20 个成员。

Membership.member 字段必须包含一个填充了 name（格式：users/{user}）且 type 设置为 User.Type.HUMAN 的 user。您只能在设置聊天室时添加真人用户（只有在通过通话应用设置私信时，才能添加 Chat 应用）。您还可以将用户的电子邮件地址添加为 {user} 的别名。例如，user.name 可以是 users/example@gmail.com。如要邀请 Gmail 用户或外部 Google Workspace 网域中的用户，用户的电子邮件地址必须为 {user}。

将 Space.spaceType 设置为 SPACE 时，可自由选择是否提供此值。

将 Space.spaceType 设置为 GROUP_CHAT 以及至少两个成员时，必须提供。

如果您将真人用户（且有 1 个成员）的 Space.spaceType 设置为 DIRECT_MESSAGE，则必须提供此值。

在真人与发起调用的 Chat 应用之间创建 1 对 1 对话时，必须为空（将 Space.spaceType 设置为 DIRECT_MESSAGE 并将 Space.singleUserBotDm 设置为 true 时）。