리소스: 공간
Google Chat의 스페이스 스페이스는 두 명 이상의 사용자 간의 대화 또는 사용자와 Chat 앱 간의 1:1 메시지입니다.
JSON 표현 |
---|
{ "name": string, "type": enum ( |
필드 | |
---|---|
name |
스페이스의 리소스 이름입니다. 형식: 여기서 |
type |
출력 전용입니다. 지원 중단됨: 대신 |
spaceType |
공간 유형입니다. 스페이스를 만들거나 스페이스의 스페이스 유형을 업데이트할 때 필요합니다. 다른 용도의 경우에만 출력 |
singleUserBotDm |
선택사항입니다. 스페이스가 Chat 앱과 한 사람 간의 DM인지 여부입니다. |
threaded |
출력 전용입니다. 지원 중단됨: 대신 |
displayName |
스페이스의 표시 이름입니다. 채팅 메시지의 경우 이 필드가 비어 있을 수 있습니다. 최대 128자(영문 기준)까지 지원됩니다. |
externalUserAllowed |
변경할 수 없습니다. 이 스페이스에 Google Chat 사용자가 구성원으로 허용되는지 여부입니다. Google Workspace 조직에서 스페이스를 만들 때 입력합니다. 다음 조건에서 스페이스를 만들 때는 이 필드를 생략합니다.
기존 스페이스의 경우 이 필드는 출력 전용입니다. |
spaceThreadingState |
출력 전용입니다. Chat 스페이스의 대화목록 상태입니다. |
spaceDetails |
설명 및 규칙을 포함한 스페이스 세부정보입니다. |
spaceHistoryState |
이 스페이스에 있는 메시지 및 대화목록의 메시지 기록 상태입니다. |
importMode |
선택사항입니다. Google Workspace로의 데이터 이전 과정에서 이 스페이스가 |
createTime |
선택사항입니다. 변경할 수 없습니다. Chat에서 만든 스페이스의 경우 스페이스가 생성된 시간입니다. 이 필드는 가져오기 모드 공간에서 사용되는 경우를 제외하고 출력 전용입니다. 가져오기 모드 스페이스의 경우 원래 생성 시간을 보존하기 위해 이 필드를 소스에서 스페이스가 생성된 이전 타임스탬프로 설정합니다.
|
lastActiveTime |
출력 전용입니다. 스페이스에 있는 마지막 메시지의 타임스탬프입니다. |
adminInstalled |
출력 전용입니다. Chat 앱을 사용한 채팅 메시지 (DM) 스페이스의 경우, 스페이스가 Google Workspace 관리자가 만들었는지 여부 관리자는 조직의 사용자를 대신하여 Chat 앱을 통한 채팅 메시지를 설치하고 설정할 수 있습니다. 관리자 설치를 지원하려면 채팅 앱에 채팅 메시지 기능이 있어야 합니다. |
membershipCount |
출력 전용입니다. 구성원 유형별로 그룹화된 가입된 멤버십 수입니다. |
accessSettings |
선택사항입니다. 스페이스의 액세스 설정을 지정합니다. |
spaceUri |
출력 전용입니다. 사용자가 스페이스에 액세스하는 데 사용하는 URI입니다. |
통합 필드 space_permission_settings . 스페이스의 권한 설정을 나타냅니다. space_type 이 SPACE 인 경우에만 채워집니다. space_permission_settings 는 다음 중 하나여야 합니다. |
|
predefinedPermissionSettings |
선택사항입니다. 입력 전용입니다. 스페이스 권한 설정 스페이스 만들기를 위한 입력. 이 필드가 설정되지 않으면 공동작업 스페이스가 생성됩니다. 스페이스를 만들면 |
permissionSettings |
선택사항입니다. 스페이스를 업데이트하기 위해 설정할 수 있는 정확한 권한 설정 스페이스 업데이트를 위한 입력입니다. 그렇지 않으면 출력 전용입니다. 스페이스를 만들려면 |
유형
지원 중단됨: 대신 SpaceType
를 사용하세요.
열거형 | |
---|---|
TYPE_UNSPECIFIED |
예약되었습니다. |
ROOM |
둘 이상의 사람이 나누는 대화입니다. |
DM |
사람과 채팅 앱 간의 1:1 채팅 메시지로, 모든 메시지가 평면입니다. 두 사람 간의 채팅 메시지는 여기에 포함되지 않습니다. |
SpaceType
공간 유형입니다. 스페이스를 만들거나 업데이트할 때 필요합니다. 다른 용도의 경우에만 출력
열거형 | |
---|---|
SPACE_TYPE_UNSPECIFIED |
예약되었습니다. |
SPACE |
메시지를 보내고 파일을 공유하며 공동작업할 수 있는 공간입니다. SPACE 에는 Chat 앱이 포함될 수 있습니다. |
GROUP_CHAT |
3명 이상의 사용자 간 그룹 대화 GROUP_CHAT 에는 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 보관 규칙에 따라 지정됩니다. |
MembershipCount
JSON 표현 |
---|
{ "joinedDirectHumanUserCount": integer, "joinedGroupCount": integer } |
필드 | |
---|---|
joinedDirectHumanUserCount |
스페이스에 직접 참여한 실제 사용자 수로, 참여한 그룹의 멤버십으로 참여한 사용자는 포함되지 않습니다. |
joinedGroupCount |
스페이스에 직접 참여한 모든 그룹의 수입니다. |
AccessSettings
스페이스의 액세스 설정을 나타냅니다.
JSON 표현 |
---|
{
"accessState": enum ( |
필드 | |
---|---|
accessState |
출력 전용입니다. 스페이스의 액세스 상태를 나타냅니다. |
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 ( |
필드 | |
---|---|
manageMembersAndGroups |
스페이스에서 멤버 및 그룹을 관리하기 위한 설정 |
modifySpaceDetails |
스페이스 이름, 아바타, 설명, 가이드라인을 업데이트하기 위한 설정 |
toggleHistory |
스페이스 기록을 사용 또는 사용 중지하도록 설정하는 설정입니다. |
useAtMentionAll |
스페이스에서 @all을 사용하기 위한 설정 |
manageApps |
스페이스에서 앱을 관리하기 위한 설정 |
manageWebhooks |
스페이스에서 웹훅을 관리하기 위한 설정 |
postMessages |
출력 전용입니다. 스페이스에서 메시지를 게시하기 위한 설정 |
replyMessages |
스페이스에서 메시지에 답장하기 위한 설정입니다. |
PermissionSetting
스페이스 권한 설정을 나타냅니다.
JSON 표현 |
---|
{ "managersAllowed": boolean, "membersAllowed": boolean } |
필드 | |
---|---|
managersAllowed |
스페이스 관리자에게 이 권한이 있는지 여부입니다. |
membersAllowed |
관리자가 아닌 구성원이 이 권한을 가지고 있는지 여부입니다. |
메서드 |
|
---|---|
|
지정된 스페이스에 대한 가져오기 프로세스를 완료하고 사용자에게 표시합니다. |
|
멤버가 없는 스페이스를 만듭니다. |
|
이름이 지정된 스페이스를 삭제합니다. |
|
지정된 사용자와의 기존 채팅 메시지를 반환합니다. |
|
스페이스에 관한 세부정보를 반환합니다. |
|
발신자가 속한 스페이스를 나열합니다. |
|
스페이스를 업데이트합니다. |
|
|
|
스페이스를 만들고 지정된 사용자를 추가합니다. |