리소스: 스페이스
Google Chat의 스페이스 스페이스는 두 명 이상의 사용자 간의 대화 또는 사용자와 Chat 앱 간의 일대일 메시지입니다.
JSON 표현 |
---|
{ "name": string, "type": enum ( |
필드 | |
---|---|
name |
식별자. 공간의 리소스 이름입니다. 형식: 여기서 |
type |
출력 전용입니다. 지원 중단됨: 대신 |
space |
선택사항입니다. 스페이스 유형입니다. 스페이스를 만들거나 스페이스의 스페이스 유형을 업데이트할 때 필요합니다. 다른 용도에 대해서만 출력합니다. |
single |
선택사항입니다. 스페이스가 Chat 앱과 한 명의 사용자 간의 DM인지 여부입니다. |
threaded |
출력 전용입니다. 지원 중단됨: 대신 |
display |
선택사항입니다. 스페이스의 표시 이름입니다. 채팅 메시지의 경우 이 필드가 비어 있을 수 있습니다. 최대 128자(영문 기준)를 지원합니다. |
external |
선택사항입니다. 변경할 수 없습니다. 이 스페이스에서 Google Chat 사용자를 회원으로 허용하는지 여부입니다. Google Workspace 조직에서 스페이스를 만들 때 입력합니다. 다음과 같은 조건에서 스페이스를 만들 때 이 필드를 생략합니다.
기존 스페이스의 경우 이 필드는 출력 전용입니다. |
space |
출력 전용입니다. Chat 스페이스의 대화목록 상태입니다. |
space |
선택사항입니다. 설명 및 규칙을 포함한 스페이스에 관한 세부정보입니다. |
space |
선택사항입니다. 이 스페이스의 메시지 및 대화목록에 대한 메시지 기록 상태입니다. |
import |
선택사항입니다. 이 스페이스가 Google Workspace로의 데이터 이전의 일환으로
|
create |
선택사항입니다. 변경할 수 없습니다. Chat에서 만든 스페이스의 경우 스페이스가 생성된 시간입니다. 이 필드는 가져오기 모드 스페이스에서 사용되는 경우를 제외하고 출력 전용입니다. 가져오기 모드 스페이스의 경우 원래 생성 시간을 보존하려면 이 필드를 소스에서 스페이스가 생성된 이전 타임스탬프로 설정하세요.
|
last |
출력 전용입니다. 스페이스의 마지막 메시지의 타임스탬프입니다. |
admin |
출력 전용입니다. Chat 앱이 있는 채팅 메시지 (DM) 스페이스의 경우 Google Workspace 관리자가 스페이스를 만들었는지 여부입니다. 관리자는 조직의 사용자를 대신하여 Chat 앱을 설치하고 채팅 메시지를 설정할 수 있습니다. 관리자 설치를 지원하려면 Chat 앱에 채팅 메시지 기능이 있어야 합니다. |
membership |
출력 전용입니다. 회원 유형별로 그룹화된 가입 멤버십 수입니다. |
access |
선택사항입니다. 스페이스의 액세스 설정을 지정합니다. |
space |
출력 전용입니다. 사용자가 스페이스에 액세스할 수 있는 URI입니다. |
customer |
선택사항입니다. 변경할 수 없습니다. 스페이스의 도메인 고객 ID입니다. 앱 인증으로 스페이스를 만들고
DM의 경우 이 필드가 채워지지 않습니다. |
통합 필드 사용자 인증이 필요합니다. |
|
predefined |
선택사항입니다. 입력 전용입니다. 사전 정의된 스페이스 권한 설정으로, 스페이스를 만들 때만 입력합니다. 이 필드가 설정되지 않으면 공동작업 공간이 생성됩니다. 스페이스를 만든 후 설정이 |
permission |
선택사항입니다. 기존 스페이스의 스페이스 권한 설정 기존 권한 설정이 대체되는 정확한 스페이스 권한 설정을 업데이트하기 위한 입력입니다. 출력에 현재 권한 설정이 나열됩니다. |
유형
지원 중단됨: 대신 SpaceType
를 사용하세요.
열거형 | |
---|---|
TYPE_UNSPECIFIED |
예약됨 |
ROOM |
두 명 이상의 인간 간의 대화 |
DM |
모든 메시지가 평면인 사람과 Chat 앱 간의 1:1 채팅 메시지입니다. 사람 간의 채팅 메시지는 여기에 포함되지 않습니다. |
SpaceType
스페이스 유형입니다. 스페이스를 만들거나 업데이트할 때 필요합니다. 다른 용도에 대해서만 출력합니다.
열거형 | |
---|---|
SPACE_TYPE_UNSPECIFIED |
예약됨 |
SPACE |
사용자가 메시지를 보내고, 파일을 공유하고, 공동작업을 할 수 있는 공간입니다. SPACE 에는 Chat 앱이 포함될 수 있습니다. |
GROUP_CHAT |
3명 이상의 사용자 간의 그룹 대화 GROUP_CHAT 에는 Chat 앱이 포함될 수 있습니다. |
DIRECT_MESSAGE |
두 사람 또는 사람과 Chat 앱 간의 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 보관 규칙에 따라 메일 및 대화목록이 보관되는 기간이 지정됩니다. |
MembershipCount
스페이스의 멤버십 수를 카테고리별로 그룹화하여 나타냅니다.
JSON 표현 |
---|
{ "joinedDirectHumanUserCount": integer, "joinedGroupCount": integer } |
필드 | |
---|---|
joined |
출력 전용입니다. 스페이스에 직접 참여한 사람 수입니다. 참여 그룹의 멤버십을 통해 참여한 사용자는 포함되지 않습니다. |
joined |
출력 전용입니다. 스페이스에 직접 참여한 모든 그룹의 수입니다. |
AccessSettings
공간의 액세스 설정을 나타냅니다.
JSON 표현 |
---|
{
"accessState": enum ( |
필드 | |
---|---|
access |
출력 전용입니다. 스페이스의 액세스 상태를 나타냅니다. |
audience |
선택사항입니다. 스페이스를 검색하고, 스페이스에 참여하며, 스페이스의 메시지를 미리 볼 수 있는 공유 대상 그룹의 리소스 이름입니다. 이 옵션을 선택 해제하면 스페이스에 개별적으로 초대되거나 추가된 사용자 또는 Google 그룹만 스페이스에 액세스할 수 있습니다. 자세한 내용은 공유 스페이스를 공유 대상 그룹에 표시하기를 참고하세요. 형식: Google Workspace 조직의 기본 공유 대상 그룹을 사용하려면 공유 대상 그룹을 읽으면 다음 작업을 할 수 있습니다. 앱 인증과 함께 공유 대상 그룹을 설정하려면 사용자 인증이 필요합니다. |
AccessState
스페이스의 액세스 상태를 나타냅니다.
열거형 | |
---|---|
ACCESS_STATE_UNSPECIFIED |
액세스 상태를 알 수 없거나 이 API에서 지원되지 않습니다. |
PRIVATE |
다른 사용자 또는 Google Workspace 관리자가 개별적으로 추가하거나 초대한 사용자 또는 Google 그룹스만 스페이스를 검색하고 액세스할 수 있습니다. |
DISCOVERABLE |
스페이스 관리자가 공유 대상 그룹에 스페이스 액세스 권한을 부여했습니다. 스페이스에 개별적으로 추가되거나 초대된 사용자 또는 Google 그룹도 스페이스를 검색하고 액세스할 수 있습니다. 자세한 내용은 특정 사용자에게 스페이스를 검색 가능하도록 설정하기를 참고하세요. 검색 가능한 스페이스를 만들려면 사용자 인증이 필요합니다. |
PredefinedPermissionSettings
이름이 지정된 스페이스를 만들 때만 지정할 수 있는 사전 정의된 권한 설정입니다. 향후 더 많은 설정이 추가될 수 있습니다. 이름이 지정된 스페이스의 권한 설정에 관한 자세한 내용은 스페이스 알아보기를 참고하세요.
열거형 | |
---|---|
PREDEFINED_PERMISSION_SETTINGS_UNSPECIFIED |
지정되지 않았습니다. 사용하지 마세요. |
COLLABORATION_SPACE |
스페이스를 모든 구성원이 메시지를 게시할 수 있는 공동작업 스페이스로 설정하는 기능입니다. |
ANNOUNCEMENT_SPACE |
스페이스를 스페이스 관리자만 메시지를 게시할 수 있는 공지사항 스페이스로 설정합니다. |
PermissionSettings
기존 이름이 지정된 스페이스를 업데이트할 때 지정할 수 있는 권한 설정
스페이스를 만들 때 권한 설정을 지정하려면 요청에 PredefinedPermissionSettings
필드를 지정합니다.
JSON 표현 |
---|
{ "manageMembersAndGroups": { object ( |
필드 | |
---|---|
manage |
선택사항입니다. 스페이스에서 구성원 및 그룹을 관리하기 위한 설정입니다. |
modify |
선택사항입니다. 스페이스 이름, 아바타, 설명, 가이드라인을 업데이트하기 위한 설정입니다. |
toggle |
선택사항입니다. 스페이스 기록을 사용 설정 또는 사용 중지하는 설정입니다. |
use |
선택사항입니다. 스페이스에서 @all을 사용할 수 있는 설정입니다. |
manage |
선택사항입니다. 스페이스에서 앱을 관리하기 위한 설정입니다. |
manage |
선택사항입니다. 스페이스에서 웹훅을 관리하기 위한 설정입니다. |
post |
출력 전용입니다. 스페이스에 메시지를 게시하기 위한 설정입니다. |
reply |
선택사항입니다. 스페이스에서 메시지에 답장하기 위한 설정입니다. |
PermissionSetting
스페이스 권한 설정을 나타냅니다.
JSON 표현 |
---|
{ "managersAllowed": boolean, "membersAllowed": boolean } |
필드 | |
---|---|
managers |
선택사항입니다. 스페이스 관리자에게 이 권한이 있는지 여부입니다. |
members |
선택사항입니다. 관리자가 아닌 구성원에게 이 권한이 있는지 여부입니다. |
메서드 |
|
---|---|
|
지정된 스페이스의 가져오기 프로세스를 완료하고 사용자에게 표시합니다. |
|
스페이스를 만듭니다. |
|
이름이 지정된 스페이스를 삭제합니다. |
|
지정된 사용자와의 기존 채팅 메시지를 반환합니다. |
|
스페이스에 대한 세부정보를 반환합니다. |
|
호출자가 속한 스페이스를 나열합니다. |
|
스페이스를 업데이트합니다. |
|
관리자의 검색어를 기반으로 Google Workspace 조직의 스페이스 목록을 반환합니다. |
|
스페이스를 만들고 지정된 사용자를 추가합니다. |