리소스: Space
Google Chat의 스페이스 스페이스는 두 명 이상의 사용자 간의 대화 또는 사용자와 채팅 앱 간의 1:1 메시지입니다.
JSON 표현 |
---|
{ "name": string, "type": enum ( |
입력란 | |
---|---|
name |
스페이스의 리소스 이름입니다. 형식: |
type |
출력 전용. 지원 중단됨: 대신 |
spaceType |
공간 유형입니다. 스페이스를 만들거나 스페이스의 스페이스 유형을 업데이트할 때 필요합니다. 다른 용도의 경우에만 출력합니다. |
singleUserBotDm |
선택사항입니다. 스페이스가 채팅 앱과 단일 사용자 간의 DM인지 여부 |
threaded |
출력 전용. 지원 중단됨: 대신 |
displayName |
스페이스의 표시 이름입니다. 스페이스를 만들 때 필요합니다. 스페이스를 만들거나 채팅 메시지의 경우 이 필드가 비어 있을 수 있습니다. 최대 128자(영문 기준)까지 입력할 수 있습니다. |
externalUserAllowed |
변경할 수 없습니다. 이 스페이스가 Google Chat 사용자를 구성원으로 허용할지 여부입니다. Google Workspace 조직에서 스페이스를 만들 때 입력합니다. 다음 조건에서 스페이스를 만들 때는 이 필드를 생략합니다.
기존 스페이스의 경우 이 필드는 출력 전용입니다. |
spaceThreadingState |
출력 전용. Chat 스페이스의 대화목록 상태 |
spaceDetails |
설명 및 규칙을 포함한 스페이스에 관한 세부정보입니다. |
spaceHistoryState |
이 스페이스에 있는 메시지 및 대화목록의 메시지 기록 상태입니다. |
importMode |
선택사항입니다. 이 스페이스가 Google Workspace로 데이터 이전 시 |
createTime |
선택사항입니다. 변경할 수 없습니다. Chat에서 만든 스페이스의 경우 스페이스가 생성된 시간입니다. 이 필드는 가져오기 모드 공간에서 사용되는 경우를 제외하고 출력 전용입니다. 가져오기 모드 스페이스의 경우 원래 생성 시간을 유지하려면 이 필드를 소스에서 스페이스가 생성된 이전 타임스탬프로 설정합니다.
|
adminInstalled |
출력 전용. Google Workspace 관리자가 채팅 앱을 설치했는지 여부 관리자는 도메인, 조직 단위 또는 사용자 그룹에 Chat 앱을 설치할 수 있습니다. 관리자는 사용자와 앱 간의 채팅 메시지 전용 채팅 앱만 설치할 수 있습니다. 관리자 설치를 지원하려면 앱에 채팅 메시지 기능이 있어야 합니다. |
accessSettings |
선택사항입니다. 스페이스의 액세스 설정을 지정합니다. |
spaceUri |
출력 전용. 공간의 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 |
선택사항입니다. 스페이스에 관한 설명입니다. 예를 들어 스페이스의 토론 주제, 기능 목적, 참여자를 설명합니다. 최대 150자(영문 기준)까지 입력할 수 있습니다. |
guidelines |
선택사항입니다. 스페이스의 규칙, 기대치, 에티켓 최대 5,000자(영문 기준)까지 지원됩니다. |
HistoryState
메시지 및 스페이스의 기록 상태입니다. 생성 후 메일 및 대화목록이 보관되는 기간을 지정합니다.
열거형 | |
---|---|
HISTORY_STATE_UNSPECIFIED |
기본값 사용하지 않습니다. |
HISTORY_OFF |
기록이 사용 중지되었습니다. 메시지와 대화목록이 24시간 동안 보관됩니다. |
HISTORY_ON |
채팅 기록이 사용 설정되었습니다. 조직의 Vault 보관 규칙에 따라 메일 및 대화목록의 보관 기간이 지정됩니다. |
AccessSettings
스페이스의 액세스 설정을 나타냅니다.
JSON 표현 |
---|
{
"accessState": enum ( |
입력란 | |
---|---|
accessState |
출력 전용. 스페이스의 액세스 상태를 나타냅니다. |
audience |
선택사항입니다. 스페이스에 액세스할 수 있는 공유 대상 그룹의 리소스 이름입니다. 이 입력란을 유효한 공유 대상 그룹 ID로 설정하여 스페이스를 검색 가능하게 만들거나 |
AccessState
스페이스의 액세스 상태를 나타냅니다.
열거형 | |
---|---|
ACCESS_STATE_UNSPECIFIED |
액세스 상태를 알 수 없거나 이 API에서 지원되지 않습니다. |
PRIVATE |
추가되거나 초대된 구성원 또는 그룹이 스페이스를 검색할 수 있습니다. |
DISCOVERABLE |
선택된 공유 대상 그룹은 물론 추가되거나 초대된 구성원 또는 그룹이 스페이스를 검색할 수 있습니다. |
방법 |
|
---|---|
|
지정된 스페이스의 가져오기 프로세스를 완료하고 사용자에게 표시합니다. |
|
이름이 지정된 스페이스를 만듭니다. |
|
이름이 지정된 스페이스를 삭제합니다. |
|
지정된 사용자와의 기존 채팅 메시지를 반환합니다. |
|
스페이스에 관한 세부정보를 반환합니다. |
|
호출자가 속한 스페이스를 나열합니다. |
|
스페이스를 업데이트합니다. |
|
스페이스를 만들고 지정된 사용자를 스페이스에 추가합니다. |