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가 채워진 user(형식: users/{user})가 포함되어야 하며 type은 User.Type.HUMAN로 설정되어야 합니다. 스페이스를 설정할 때만 실제 사용자를 추가할 수 있습니다. 채팅 앱 추가는 통화 앱과의 채팅 메시지 설정에서만 지원됩니다. 사용자의 이메일을 {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로 설정할 때 멤버십 2개 이상과 함께 필요합니다.

Space.spaceType를 실제 사용자와 함께 DIRECT_MESSAGE로 설정할 때 정확히 하나의 멤버십과 함께 필요합니다.

사람과 통화 채팅 앱 간에 1:1 대화를 만드는 경우 (Space.spaceType를 DIRECT_MESSAGE로, Space.singleUserBotDm를 true로 설정하는 경우) 비어 있어야 합니다.