REST Resource: spaces

리소스: Space

Google Chat의 스페이스 스페이스는 두 명 이상의 사용자 간의 대화 또는 사용자와 채팅 앱 간의 1:1 메시지입니다.

JSON 표현
{
  "name": string,
  "type": enum (Type),
  "spaceType": enum (SpaceType),
  "singleUserBotDm": boolean,
  "threaded": boolean,
  "displayName": string,
  "externalUserAllowed": boolean,
  "spaceThreadingState": enum (SpaceThreadingState),
  "spaceDetails": {
    object (SpaceDetails)
  },
  "spaceHistoryState": enum (HistoryState),
  "importMode": boolean,
  "createTime": string,
  "lastActiveTime": string,
  "adminInstalled": boolean,
  "membershipCount": {
    object (MembershipCount)
  },
  "accessSettings": {
    object (AccessSettings)
  },
  "spaceUri": string
}
입력란
name

string

스페이스의 리소스 이름입니다.

형식: spaces/{space}

type
(deprecated)

enum (Type)

출력 전용입니다. 지원 중단됨: 대신 spaceType를 사용하세요. 스페이스의 유형입니다.

spaceType

enum (SpaceType)

공간 유형입니다. 스페이스를 만들거나 스페이스의 스페이스 유형을 업데이트할 때 필요합니다. 다른 용도의 경우에만 출력합니다.

singleUserBotDm

boolean

선택사항입니다. 스페이스가 채팅 앱과 단일 사용자 간의 DM인지 여부

threaded
(deprecated)

boolean

출력 전용입니다. 지원 중단됨: 대신 spaceThreadingState를 사용하세요. 이 스페이스의 대화목록 표시 여부

displayName

string

스페이스의 표시 이름입니다. 스페이스를 만들 때 필요합니다. 스페이스를 만들거나 displayName을 업데이트할 때 ALREADY_EXISTS 오류 메시지가 표시되면 다른 displayName를 사용해 보세요. Google Workspace 조직 내의 기존 스페이스에서 이 표시 이름을 이미 사용하고 있을 수 있습니다.

채팅 메시지의 경우 이 필드가 비어 있을 수 있습니다.

최대 128자(영문 기준)까지 입력할 수 있습니다.

externalUserAllowed

boolean

변경할 수 없습니다. 이 스페이스가 Google Chat 사용자를 구성원으로 허용할지 여부입니다. Google Workspace 조직에서 스페이스를 만들 때 입력합니다. 다음 조건에서 스페이스를 만들 때는 이 필드를 생략합니다.

  • 인증된 사용자가 일반 계정 (비관리 사용자 계정)을 사용합니다. 기본적으로 일반 계정으로 만든 스페이스는 모든 Google Chat 사용자에게 허용됩니다.

  • 가져오기 모드 스페이스에서는 동일한 Google Workspace 조직의 멤버만 허용해야 하므로 이 스페이스는 Google Chat으로 데이터를 가져오는 데 사용됩니다. 하지만 Google Workspace 개발자 프리뷰 프로그램의 일환으로 가져오기 모드 스페이스에서는 모든 Google Chat 사용자를 허용할 수 있으므로 가져오기 모드 스페이스에 이 필드를 설정할 수 있습니다.

기존 스페이스의 경우 이 필드는 출력 전용입니다.

spaceThreadingState

enum (SpaceThreadingState)

출력 전용입니다. Chat 스페이스의 대화목록 상태

spaceDetails

object (SpaceDetails)

설명 및 규칙을 포함한 스페이스에 관한 세부정보입니다.

spaceHistoryState

enum (HistoryState)

이 스페이스에 있는 메시지 및 대화목록의 메시지 기록 상태입니다.

importMode

boolean

선택사항입니다. 이 스페이스가 Google Workspace로 데이터 이전 시 Import Mode에 생성되는지 여부 스페이스를 가져오는 동안에는 가져오기가 완료될 때까지 사용자에게 표시되지 않습니다.

createTime

string (Timestamp format)

선택사항입니다. 변경할 수 없습니다. Chat에서 만든 스페이스의 경우 스페이스가 생성된 시간입니다. 이 필드는 가져오기 모드 공간에서 사용되는 경우를 제외하고 출력 전용입니다.

가져오기 모드 스페이스의 경우 원래 생성 시간을 유지하려면 이 필드를 소스에서 스페이스가 생성된 이전 타임스탬프로 설정합니다.

spaceTypeGROUP_CHAT 또는 SPACE인 경우에만 출력에 채워집니다.

lastActiveTime

string (Timestamp format)

출력 전용입니다. 스페이스에 있는 마지막 메시지의 타임스탬프입니다.

adminInstalled

boolean

출력 전용입니다. 채팅 앱이 있는 채팅 메시지 (DM) 스페이스의 경우, 스페이스를 Google Workspace 관리자가 만들었는지 여부 관리자는 조직의 사용자를 대신하여 채팅 앱을 사용하여 채팅 메시지를 설치하고 설정할 수 있습니다.

관리자 설치를 지원하려면 채팅 앱에 채팅 메시지 기능이 있어야 합니다.

membershipCount

object (MembershipCount)

출력 전용입니다. 회원 유형별로 그룹화된 가입 멤버십 수입니다. spaceTypeSPACE, DIRECT_MESSAGE 또는 GROUP_CHAT일 때 채워집니다.

accessSettings

object (AccessSettings)

선택사항입니다. 스페이스의 액세스 설정을 지정합니다. spaceTypeSPACE인 경우에만 채워집니다.

spaceUri

string

출력 전용입니다. 공간의 URI입니다.

유형

지원 중단됨: 대신 SpaceType를 사용하세요.

열거형
TYPE_UNSPECIFIED 예약됨.
ROOM 두 명 이상의 사람이 나누는 대화입니다.
DM 사람과 채팅 앱 간의 1:1 채팅 메시지이며 모든 메시지가 수평적입니다. 두 사람 간의 채팅 메시지는 포함되지 않습니다.

SpaceType

공간 유형입니다. 스페이스를 만들거나 업데이트할 때 필요합니다. 다른 용도의 경우에만 출력합니다.

열거형
SPACE_TYPE_UNSPECIFIED 예약됨.
SPACE 사용자가 메시지를 보내고 파일을 공유하며 공동작업할 수 있는 공간입니다. SPACE에는 채팅 앱이 포함될 수 있습니다.
GROUP_CHAT 3명 이상의 사용자 간의 그룹 대화 GROUP_CHAT에는 채팅 앱이 포함될 수 있습니다.
DIRECT_MESSAGE 두 사람 또는 사람과 채팅 앱 간의 1:1 메시지

SpaceThreadingState

Chat 스페이스의 대화목록 상태 유형을 지정합니다.

열거형
SPACE_THREADING_STATE_UNSPECIFIED 예약됨.
THREADED_MESSAGES 메시지 대화목록을 지원하는 이름이 지정된 스페이스 사용자는 메시지에 응답할 때 대화목록 내에서 응답할 수 있으며, 원래 메시지의 맥락에서 응답을 유지합니다.
GROUPED_MESSAGES 대화가 주제별로 정리된 이름이 지정된 스페이스 주제와 해당 답글은 함께 그룹화됩니다.
UNTHREADED_MESSAGES 두 사용자 간의 채팅 메시지 (DM) 및 3명 이상 간의 그룹 대화

SpaceDetails

설명 및 규칙을 포함한 스페이스에 관한 세부정보입니다.

JSON 표현
{
  "description": string,
  "guidelines": string
}
입력란
description

string

선택사항입니다. 스페이스에 관한 설명입니다. 예를 들어 스페이스의 토론 주제, 기능 목적, 참여자를 설명합니다.

최대 150자(영문 기준)까지 입력할 수 있습니다.

guidelines

string

선택사항입니다. 스페이스의 규칙, 기대치, 에티켓

최대 5,000자(영문 기준)까지 지원됩니다.

HistoryState

메시지 및 스페이스의 기록 상태입니다. 생성 후 메일 및 대화목록이 보관되는 기간을 지정합니다.

열거형
HISTORY_STATE_UNSPECIFIED 기본값 사용하지 않습니다.
HISTORY_OFF 기록이 사용 중지되었습니다. 메시지와 대화목록이 24시간 동안 보관됩니다.
HISTORY_ON 채팅 기록이 사용 설정되었습니다. 조직의 Vault 보관 규칙에 따라 메일 및 대화목록의 보관 기간이 지정됩니다.

MembershipCount

카테고리로 그룹화된 스페이스의 멤버십 수를 나타냅니다.

JSON 표현
{
  "joinedDirectHumanUserCount": integer,
  "joinedGroupCount": integer
}
입력란
joinedDirectHumanUserCount

integer

스페이스에 직접 참여한 실제 사용자 수로, 참여한 그룹의 멤버십을 통해 참여한 사용자는 포함되지 않습니다.

joinedGroupCount

integer

스페이스에 직접 참여한 모든 그룹의 수입니다.

AccessSettings

스페이스의 액세스 설정을 나타냅니다.

JSON 표현
{
  "accessState": enum (AccessState),
  "audience": string
}
입력란
accessState

enum (AccessState)

출력 전용입니다. 스페이스의 액세스 상태를 나타냅니다.

audience

string

선택사항입니다. 스페이스에 액세스할 수 있는 공유 대상 그룹의 리소스 이름입니다. 이 입력란을 유효한 공유 대상 그룹 ID로 설정하여 스페이스를 검색 가능하게 만들거나 audiences/default 별칭을 사용하여 관리 콘솔의 기본 액세스 설정으로 스페이스를 설정합니다. 자세한 내용은 공유 대상 그룹이 검색 가능한 스페이스 만들기를 참고하세요. 스페이스를 제한하려면 이 필드를 설정 해제합니다. 스페이스를 검색할 수 있는 경우에만 채워집니다. 형식: audiences/{audience}, audiences/default을(를) 기본 Chat 공유 설정의 별칭으로 사용할 수 있습니다.

AccessState

스페이스의 액세스 상태를 나타냅니다.

열거형
ACCESS_STATE_UNSPECIFIED 액세스 상태를 알 수 없거나 이 API에서 지원되지 않습니다.
PRIVATE 추가되거나 초대된 구성원 또는 그룹이 스페이스를 검색할 수 있습니다.
DISCOVERABLE 선택된 공유 대상 그룹은 물론 추가되거나 초대된 구성원 또는 그룹이 스페이스를 검색할 수 있습니다.

메서드

completeImport

지정된 스페이스의 가져오기 프로세스를 완료하고 사용자에게 표시합니다.

create

이름이 지정된 스페이스를 만듭니다.

delete

이름이 지정된 스페이스를 삭제합니다.

findDirectMessage

지정된 사용자와의 기존 채팅 메시지를 반환합니다.

get

스페이스에 관한 세부정보를 반환합니다.

list

호출자가 속한 스페이스를 나열합니다.

patch

스페이스를 업데이트합니다.

setup

스페이스를 만들고 지정된 사용자를 스페이스에 추가합니다.