REST Resource: spaces

리소스: Space

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

JSON 표현 
{
  "name": string,
  "type": enum (Type),
  "spaceType": enum (SpaceType),
  "singleUserBotDm": boolean,
  "threaded": boolean,
  "displayName": string,
  "spaceThreadingState": enum (SpaceThreadingState),
  "spaceDetails": {
    object (SpaceDetails)
  },
  "spaceHistoryState": enum (HistoryState),
  "adminInstalled": boolean
}
필드
name

string

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

형식: spaces/{space}
type
(deprecated)

enum (Type)

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

enum (SpaceType)

스페이스 유형입니다. 스페이스를 만들거나 스페이스의 스페이스 유형을 업데이트할 때 필요합니다. 다른 사용 시에만 출력합니다.
singleUserBotDm

boolean

선택사항입니다. 스페이스가 Chat 앱과 단일 사용자 간의 채팅 메시지인지 여부
threaded
(deprecated)

boolean

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

string

스페이스의 표시 이름입니다. 스페이스를 만들 때 필요합니다.

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

최대 128자(영문 기준)를 지원합니다.
spaceThreadingState

enum (SpaceThreadingState)

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

object (SpaceDetails)

설명, 규칙 등 스페이스에 관한 세부정보입니다.
spaceHistoryState

enum (HistoryState)

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

boolean

출력 전용. Google Workspace 관리자가 Chat 앱을 설치했는지 여부 관리자는 도메인, 조직 단위 또는 사용자 그룹에 Chat 앱을 설치할 수 있습니다.

관리자는 사용자와 앱 간의 채팅 메시지를 통해서만 Chat 앱을 설치할 수 있습니다. 관리자 설치를 지원하려면 앱에 채팅 메시지가 있어야 합니다.

유형

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

열거형
TYPE_UNSPECIFIED
ROOM 두 명 이상의 사람이 나누는 대화입니다.
DM 모든 메시지가 평면인 인간과 Chat 앱 간의 1:1 채팅 메시지 두 사용자 간의 채팅 메시지는 여기에 포함되지 않습니다.

스페이스 유형

스페이스 유형입니다. 스페이스를 만들거나 업데이트할 때 필요합니다. 다른 사용 시에만 출력합니다.

열거형
SPACE_TYPE_UNSPECIFIED 예약됨.
SPACE 메시지 전송, 파일 공유, 공동작업이 이루어지는 공간입니다. SPACE에는 채팅 앱이 포함될 수 있습니다.
GROUP_CHAT 3명 이상의 사용자가 참여한 그룹 대화 GROUP_CHAT에는 채팅 앱이 포함될 수 있습니다.
DIRECT_MESSAGE 두 사람 또는 인간과 Chat 앱 사이의 1:1 메시지

스페이스 스레드 상태

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

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

스페이스 세부정보

설명, 규칙 등 스페이스에 관한 세부정보입니다.

JSON 표현 
{
  "description": string,
  "guidelines": string
}
필드
description

string

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

최대 150자(영문 기준)가 지원됩니다.
guidelines

string

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

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

기록 상태

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

열거형
HISTORY_STATE_UNSPECIFIED 기본값 사용하지 마세요.
HISTORY_OFF 기록이 사용 중지되어 있습니다. 메시지 및 대화목록은 24시간 동안 보관됩니다.
HISTORY_ON 채팅 기록을 사용 설정합니다. 조직의 Vault 보관 규칙에 메일 및 대화목록의 보관 기간이 지정됩니다.

방법

create

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

delete

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

findDirectMessage

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

get

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

list

 발신자가 속한 스페이스를 나열합니다.

patch

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

setup

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