Package google.chat.v1

가져오기 모드 스페이스입니다.

ContextualAddOnMarkup

이 유형에는 필드가 없습니다.

개발자가 컨텍스트 부가기능의 콘텐츠를 지정하는 마크업입니다.

카드

카드는 텍스트 및 이미지와 같은 UI 위젯을 포함할 수 있는 UI 요소입니다.

필드
`header`	`CardHeader` 카드의 헤더입니다. 헤더에는 일반적으로 제목과 이미지가 포함됩니다.
`sections[]`	`Section` 섹션은 선 구분자로 구분됩니다.
`card_actions[]`	`CardAction` 이 카드의 작업입니다.
`name`	`string` 카드 이름입니다.

CardAction

카드 작업은 카드와 연결된 작업입니다. 인보이스 카드의 경우 일반적인 작업은 인보이스 삭제, 인보이스 이메일 전송 또는 브라우저에서 인보이스 열기입니다.

Google Chat 앱에서 지원되지 않습니다.

필드

action_label

string

작업 메뉴 항목에 표시되는 라벨입니다.

on_click

OnClick

이 작업 항목의 onclick 작업입니다.

CardHeader

필드
`title`	`string` 제목을 지정해야 합니다. 헤더의 높이는 고정되어 있습니다. 제목과 부제목이 모두 지정된 경우 각각 한 줄을 차지합니다. 제목만 지정하면 두 줄을 모두 차지합니다.
`subtitle`	`string` 카드 헤더의 부제목입니다.
`image_style`	`ImageStyle` 이미지 유형 (예: 정사각형 테두리 또는 원형 테두리)입니다.
`image_url`	`string` 카드 헤더에 있는 이미지의 URL입니다.

ImageStyle

열거형
`IMAGE_STYLE_UNSPECIFIED`
`IMAGE`	정사각형 테두리
`AVATAR`	원형 테두리입니다.

섹션

섹션에는 지정된 순서대로 (세로로) 렌더링되는 위젯 모음이 포함됩니다. 모든 플랫폼에서 카드의 너비는 좁고 고정되어 있으므로 현재 레이아웃 속성 (예: float)이 필요하지 않습니다.

필드

header

string

섹션의 헤더입니다. 형식이 지정된 텍스트가 지원됩니다. 텍스트 서식 지정에 관한 자세한 내용은 Google Chat 앱의 텍스트 서식 지정 및 Google Workspace 부가기능의 텍스트 서식 지정을 참고하세요.

widgets[]

WidgetMarkup

섹션에는 위젯이 하나 이상 포함되어야 합니다.

CreateCustomEmojiRequest

맞춤 이모티콘을 만드는 요청입니다.

필드

custom_emoji

필수 항목입니다. 만들 맞춤 이모티콘입니다.

CreateMembershipRequest

멤버십을 만들기 위한 요청 메시지입니다.

필드

parent

string

필수 항목입니다. 멤버십을 만들 스페이스의 리소스 이름입니다.

형식: spaces/{space}

membership

필수 항목입니다. 만들 멤버십 관계입니다.

memberType 필드에는 user.name 및 user.type 필드가 채워진 사용자가 포함되어야 합니다. 서버는 리소스 이름을 할당하고 지정된 모든 항목을 덮어씁니다.

Chat 앱이 사람 사용자의 멤버십 관계를 만들 때는 특정 승인 범위를 사용하고 특정 필드에 특정 값을 설정해야 합니다.

사용자로 인증할 때는 chat.memberships 승인 범위가 필요합니다.
앱으로 인증할 때는 chat.app.memberships 승인 범위가 필요합니다.
user.type를 HUMAN로 설정하고 user.name를 users/{user} 형식으로 설정합니다. 여기서 {user}는 사용자의 이메일 주소일 수 있습니다. 동일한 Workspace 조직의 사용자의 경우 {user}는 People API의 사용자 id 또는 Directory API의 사용자 id일 수도 있습니다. 예를 들어 user@example.com의 People API 개인 프로필 ID가 123456789인 경우 membership.member.name를 users/user@example.com 또는 users/123456789로 설정하여 사용자를 스페이스에 추가할 수 있습니다.

스페이스를 소유한 Workspace 조직 외부의 사용자를 초대하려면 사용자 인증이 필요합니다.

Chat 앱이 자체 멤버십 관계를 만들 때는 사용자로 인증하고 chat.memberships.app 범위를 사용하고 user.type를 BOT로 설정하고 user.name를 users/app로 설정해야 합니다.

use_admin_access

bool

선택사항입니다. true인 경우 메서드는 사용자의 Google Workspace 관리자 권한을 사용하여 실행됩니다.

호출하는 사용자는 채팅 및 스페이스 대화 관리 권한이 있는 Google Workspace 관리자여야 합니다.

chat.admin.memberships OAuth 2.0 범위가 필요합니다.

관리 액세스 권한을 사용하여 앱 멤버십을 만들거나 관리자의 Google Workspace 조직 외부 사용자의 멤버십을 만드는 것은 지원되지 않습니다.

CreateMessageNotificationOptions

메시지가 게시될 때의 알림 동작 옵션입니다.

필드

notification_type

NotificationType

메시지의 알림 유형입니다.

NotificationType

메시지의 알림 유형 옵션입니다.

열거형

NOTIFICATION_TYPE_NONE 기본 동작입니다. 알림 동작은 사용자가 Chat UI를 사용하여 메시지를 보낼 때와 유사합니다. 사용자 발신자에게는 알림이 전송되지 않습니다.

NOTIFICATION_TYPE_FORCE_NOTIFY

수신자에게 강제로 알림을 보냅니다. 이렇게 하면 사용자의 스페이스 알림 설정과 Chat 방해 금지 모드 설정이 무시됩니다. 이 옵션은 기기 수준의 방해 금지 모드 설정을 우회하지 않습니다.

앱 인증이 필요합니다.

NOTIFICATION_TYPE_SILENT

수신자에게 알림을 보내지 않고 메일을 읽지 않음으로 표시하지 않습니다. 이는 사용자가 대화를 음소거하거나 Chat 방해 금지 모드를 사용 설정하는 것과 유사하게 작동합니다.

앱 인증이 필요합니다.

CreateMessagePinRequest

메시지 고정을 만들기 위한 요청 메시지입니다.

필드

parent

string

필수 항목입니다. 메시지 고정을 만들 상위 스페이스입니다. 형식: spaces/{space}

message_pin

MessagePin

필수 항목입니다. 만들 MessagePin입니다.

CreateMessageRequest

메시지를 만듭니다.

필드
`parent`	`string` 필수 항목입니다. 메시지를 만들 스페이스의 리소스 이름입니다. 형식: `spaces/{space}`
`message`	`Message` 필수 항목입니다. 메일 본문입니다.
`thread_key (deprecated)`	`string` 이 항목은 지원 중단되었습니다. 선택사항입니다. 지원 중단됨: 대신 `thread.thread_key`를 사용하세요. 대화목록의 ID입니다. 최대 4,000자(영문 기준)까지 지원됩니다. 대화목록을 시작하거나 대화목록에 추가하려면 메시지를 만들고 `threadKey` 또는 `thread.name`를 지정합니다. 사용 예시는 메시지 대화목록 시작 또는 답장을 참고하세요.
`request_id`	`string` 선택사항입니다. 이 요청의 고유 ID입니다. 임의의 UUID를 사용하는 것이 좋습니다. 요청 ID를 지정하면 요청이 멱등성을 갖게 되므로 동일한 요청 ID를 가진 여러 개의 동일한 요청으로 인해 하나의 메시지만 생성됩니다. 요청된 세부정보가 현재 상태와 다르더라도 동일한 요청 ID를 사용하는 후속 요청은 기존 메시지를 반환하고 메시지를 업데이트하지 않습니다. 이 필드를 효과적으로 사용하려면 다음 안내를 따르세요. 후속 요청이 원래 요청과 동일하고 동일한 사용자 인증 정보를 사용하는지 확인합니다. 제공된 요청 ID로 메시지가 이미 생성된 경우 요청은 해당 메시지를 반환합니다. 반환된 메시지가 완전히 채워지지 않을 수 있습니다. API는 시스템에서 할당한 리소스 이름이 채워진 요청의 메시지를 에코합니다. 메시지의 최신 메타데이터를 가져오려면 `GetMessage`를 호출합니다. 인증된 다른 사용자와 함께 기존 요청 ID를 재사용하면 오류가 발생합니다.
`message_reply_option`	`MessageReplyOption` 선택사항입니다. 메시지가 대화목록을 시작하는지 아니면 대화목록에 답장하는지 지정합니다. 이름이 지정된 스페이스에서만 지원됩니다. 사용자 상호작용에 응답할 때는 이 필드가 무시됩니다. 대화목록 내 상호작용의 경우 답장은 동일한 대화목록에 생성됩니다. 그렇지 않으면 답장이 새 대화목록으로 생성됩니다.
`message_id`	`string` 선택사항입니다. 메시지의 커스텀 ID입니다. Chat 앱이 메시지의 리소스 이름 (메시지 `name` 필드에 표시됨)에 시스템 할당 ID를 저장하지 않고도 메시지를 가져오거나 업데이트하거나 삭제할 수 있습니다. 이 필드의 값은 다음 요구사항을 충족해야 합니다. `client-`로 시작합니다. 예를 들어 `client-custom-name`는 유효한 커스텀 ID이지만 `custom-name`는 그렇지 않습니다. 최대 63자(영문 기준)이며 소문자, 숫자, 하이픈만 포함합니다. 스페이스 내에서 고유합니다. Chat 앱은 서로 다른 메시지에 동일한 커스텀 ID를 사용할 수 없습니다. 자세한 내용은 메시지 이름 지정을 참고하세요.
`create_message_notification_options`	`CreateMessageNotificationOptions` 선택사항입니다. 메시지가 게시될 때 알림 동작을 제어합니다. 자세한 내용은 알림 강제 전송 또는 무음 메시지 전송을 참고하세요.

MessageReplyOption

메시지에 답장하는 방법을 지정합니다. 향후 더 많은 상태가 추가될 수 있습니다.

열거형
`MESSAGE_REPLY_OPTION_UNSPECIFIED`	기본값입니다. 새 대화목록을 시작합니다. 이 옵션을 사용하면 포함된 `thread ID` 또는 `thread_key`가 무시됩니다.
`REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD`	`thread ID` 또는 `thread_key`로 지정된 대화목록에 대한 답장으로 메시지를 만듭니다. 실패하면 메시지가 새 대화목록을 시작합니다.
`REPLY_MESSAGE_OR_FAIL`	`thread ID` 또는 `thread_key`로 지정된 대화목록에 대한 답장으로 메시지를 만듭니다. 새 `thread_key`가 사용되면 새 스레드가 생성됩니다. 메시지 생성이 실패하면 `NOT_FOUND` 오류가 대신 반환됩니다.

CreateReactionRequest

메시지에 대한 반응을 만듭니다.

필드

parent

string

필수 항목입니다. 반응이 생성된 메시지입니다.

형식: spaces/{space}/messages/{message}

reaction

필수 항목입니다. 만들 반응입니다.

CreateSectionRequest

섹션을 만들기 위한 요청 메시지입니다.

필드

parent

string

필수 항목입니다. 섹션이 생성되는 상위 리소스 이름입니다.

형식: users/{user}

section

필수 항목입니다. 만들 섹션입니다.

CreateSpaceRequest

구성원이 없는 이름이 지정된 스페이스를 만드는 요청입니다.

필드

space

필수 항목입니다. displayName 및 spaceType 필드를 입력해야 합니다. SpaceType.SPACE 및 SpaceType.GROUP_CHAT만 지원됩니다. SpaceType.GROUP_CHAT는 importMode가 true로 설정된 경우에만 사용할 수 있습니다.

ALREADY_EXISTS 오류 메시지가 표시되면 다른 displayName를 사용해 보세요. Google Workspace 조직 내의 기존 스페이스에서 이미 이 표시 이름을 사용하고 있을 수 있습니다.

name 공간은 서버에서 할당되므로 이 필드에 지정된 모든 항목은 무시됩니다.

request_id

string

선택사항입니다. 이 요청의 고유 ID입니다. 임의의 UUID를 사용하는 것이 좋습니다. 요청 ID를 지정하면 요청이 멱등성을 갖게 되므로 동일한 요청 ID를 가진 여러 개의 동일한 요청으로 인해 하나의 스페이스만 생성됩니다. 요청된 세부정보가 현재 상태와 다르더라도 동일한 요청 ID를 사용하는 후속 요청은 기존 스페이스를 반환하고 스페이스를 업데이트하지 않습니다.

이 필드를 효과적으로 사용하려면 다음 안내를 따르세요.

후속 요청이 원래 요청과 동일하고 동일한 사용자 인증 정보를 사용하는지 확인합니다.
제공된 요청 ID로 스페이스가 이미 생성된 경우 요청은 해당 스페이스를 반환합니다. 반환된 스페이스가 완전히 채워지지 않을 수 있습니다. API는 시스템에서 할당한 리소스 이름이 채워진 요청의 스페이스를 에코합니다. 스페이스의 최신 메타데이터를 가져오려면 GetSpace를 호출합니다.
인증된 다른 사용자와 함께 기존 요청 ID를 재사용하면 오류가 발생합니다.

CustomEmoji

맞춤 이모티콘을 나타냅니다.

필드
`name`	`string` 식별자. 서버에서 할당한 맞춤 이모티콘의 리소스 이름입니다. 형식: `customEmojis/{customEmoji}`
`uid`	`string` 출력 전용입니다. 맞춤 이모티콘 리소스의 고유 키입니다.
`emoji_name`	`string` 선택사항입니다. 변경할 수 없습니다. 사용자가 제공한 맞춤 이모티콘의 이름으로, 조직 내에서 고유합니다. 맞춤 이모티콘이 생성될 때 필요하며, 그 외의 경우에는 출력 전용입니다. 이모티콘 이름은 콜론으로 시작하고 끝나야 하며, 소문자여야 하고, 영숫자 문자, 하이픈, 밑줄만 포함할 수 있습니다. 하이픈 및 밑줄은 단어를 구분할 때 사용할 수 있으며 연속으로 사용할 수 없습니다. 예: `:valid-emoji-name:`
`temporary_image_uri`	`string` 출력 전용입니다. 맞춤 이모티콘의 임시 이미지 URL로, 최소 10분 동안 유효합니다. 맞춤 이모티콘이 생성될 때 응답에 이 필드가 채워지지 않습니다.
`payload`	`CustomEmojiPayload` 선택사항입니다. 입력 전용입니다. 페이로드 데이터입니다. 맞춤 이모티콘을 만들 때 필요합니다.

CustomEmojiPayload

맞춤 이모티콘의 페이로드 데이터입니다.

필드

file_content

bytes

필수 항목입니다. 입력 전용입니다. 맞춤 이모티콘에 사용되는 이미지입니다.

페이로드는 256KB 미만이어야 하며 이미지 크기는 정사각형이고 64~500픽셀 사이여야 합니다. 제한사항은 변경될 수 있습니다.

filename

string

필수 항목입니다. 입력 전용입니다. 이미지 파일 이름입니다.

지원되는 파일 확장자: .png, .jpg, .gif

CustomEmojiMetadata

맞춤 이모티콘의 주석 메타데이터입니다.

필드

custom_emoji

맞춤 이모티콘입니다.

CustomStatus

Google Chat에서 사용자의 맞춤 상태를 나타냅니다. 여기에는 사용자가 자신의 연락 가능 여부에 관한 추가 정보를 제공하기 위해 설정하는 짧은 문자 메시지와 이모티콘(선택사항)이 포함됩니다.

필드
`text`	`string` 필수 항목입니다. 맞춤 상태의 텍스트입니다. 최대 길이가 64인 문자열입니다.
`emoji`	`Emoji` 필수 항목입니다. 맞춤 상태의 그림 이모티콘입니다. 유니코드 그림 이모티콘만 지원되며 맞춤 그림 이모티콘은 지원되지 않습니다.
통합 필드 `expiration`. 맞춤 상태의 만료 시간입니다. 절대 타임스탬프 또는 TTL(수명) 기간으로 지정할 수 있습니다. `expiration`은 다음 중 하나여야 합니다.
`expire_time`	`Timestamp` 맞춤 상태가 만료되는 시점의 타임스탬프입니다.
`ttl`	`Duration` 입력 전용입니다. 커스텀 상태가 만료되는 TTL(수명) 기간입니다.

DeleteCustomEmojiRequest

맞춤 이모티콘 삭제 요청입니다.

필드

name

string

필수 항목입니다. 삭제할 맞춤 그림 이모티콘의 리소스 이름입니다.

형식: customEmojis/{customEmoji}

그림 이모티콘 이름을 {customEmoji}의 별칭으로 사용할 수 있습니다. 예를 들어 customEmojis/:example-emoji:에서 :example-emoji:은 맞춤 이모티콘의 이모티콘 이름입니다.

DeleteMembershipRequest

스페이스의 멤버십 삭제 요청입니다.

필드

name

string

필수 항목입니다. 삭제할 멤버십의 리소스 이름입니다. 채팅 앱은 사용자 또는 자체 멤버십을 삭제할 수 있습니다. 채팅 앱은 다른 앱의 멤버십을 삭제할 수 없습니다.

사용자 멤버십을 삭제할 때는 사용자 인증이 포함된 chat.memberships 범위 또는 앱 인증 및 spaces/{space}/members/{member} 형식이 포함된 chat.memberships.app 범위가 필요합니다. 이 이메일을 {member}의 별칭으로 사용할 수 있습니다. 예를 들어 spaces/{space}/members/example@gmail.com에서 example@gmail.com은 Google Chat 사용자의 이메일입니다.

앱 멤버십을 삭제할 때 chat.memberships.app 범위와 spaces/{space}/members/app 형식이 필요합니다.

형식: spaces/{space}/members/{member} 또는 spaces/{space}/members/app

use_admin_access

bool

선택사항입니다. true인 경우 메서드는 사용자의 Google Workspace 관리자 권한을 사용하여 실행됩니다.

호출하는 사용자는 채팅 및 스페이스 대화 관리 권한이 있는 Google Workspace 관리자여야 합니다.

chat.admin.memberships OAuth 2.0 범위가 필요합니다.

관리 액세스 권한을 사용하여 스페이스의 앱 멤버십을 삭제할 수 없습니다.

DeleteMessagePinRequest

메시지 고정을 삭제하기 위한 요청 메시지입니다.

필드

name

string

필수 항목입니다. 삭제할 메시지 고정의 리소스 이름입니다. 형식: spaces/{space}/messagePins/{message_pin}

DeleteMessageRequest

메시지 삭제 요청입니다.

필드

name

string

필수 항목입니다. 메시지의 리소스 이름입니다.

형식: spaces/{space}/messages/{message}

메시지에 커스텀 ID를 설정한 경우 clientAssignedMessageId 필드의 값을 {message}에 사용할 수 있습니다. 자세한 내용은 메시지 이름 지정하기를 참고하세요.

force

bool

선택사항입니다. true인 경우 메시지를 삭제하면 대화목록 답장도 삭제됩니다. false인 경우 메시지에 대화목록 답장이 있으면 삭제가 실패합니다.

사용자로 인증하는 경우에만 적용됩니다. Chat 앱으로 인증하는 경우에는 영향을 미치지 않습니다.

DeleteReactionRequest

메시지에 대한 반응을 삭제합니다.

필드

name

string

필수 항목입니다. 삭제할 반응의 이름입니다.

형식: spaces/{space}/messages/{message}/reactions/{reaction}

DeleteSectionRequest

섹션 삭제 요청 메시지입니다.

필드

name

string

필수 항목입니다. 삭제할 섹션의 이름입니다.

형식: users/{user}/sections/{section}

DeleteSpaceRequest

스페이스 삭제 요청입니다.

필드

name

string

필수 항목입니다. 삭제할 스페이스의 리소스 이름입니다.

형식: spaces/{space}

use_admin_access

bool

선택사항입니다. true인 경우 메서드는 사용자의 Google Workspace 관리자 권한을 사용하여 실행됩니다.

호출하는 사용자는 채팅 및 스페이스 대화 관리 권한이 있는 Google Workspace 관리자여야 합니다.

chat.admin.delete OAuth 2.0 범위가 필요합니다.

DeletionMetadata

삭제된 메시지에 관한 정보입니다. delete_time가 설정되면 메시지가 삭제됩니다.

필드

deletion_type

DeletionType

메시지를 삭제한 사용자를 나타냅니다.

DeletionType

메시지를 삭제한 사용자 및 삭제 방법 향후 더 많은 값이 추가될 수 있습니다. 메시지를 삭제할 수 있는 경우에 관한 자세한 내용은 Google Chat에서 메시지 수정 또는 삭제하기를 참고하세요.

열거형
`DELETION_TYPE_UNSPECIFIED`	이 값은 사용되지 않습니다.
`CREATOR`	사용자가 자신의 메시지를 삭제했습니다.
`SPACE_OWNER`	소유자 또는 관리자가 메시지를 삭제했습니다.
`ADMIN`	Google Workspace 관리자가 메시지를 삭제했습니다. 관리자는 스페이스 참여자 또는 Chat 앱에서 보낸 메시지를 포함하여 스페이스의 모든 메시지를 삭제할 수 있습니다.
`APP_MESSAGE_EXPIRY`	채팅 앱이 만료 시 자체 메시지를 삭제했습니다.
`CREATOR_VIA_APP`	Chat 앱이 작성자를 대신하여 메시지를 삭제했습니다 (사용자 인증 사용).
`SPACE_OWNER_VIA_APP`	Chat 앱이 스페이스 관리자를 대신하여 메시지를 삭제했습니다 (사용자 인증 사용).
`SPACE_MEMBER`	스페이스 멤버가 메시지를 삭제했습니다. 사용자는 앱에서 보낸 메시지를 삭제할 수 있습니다.

Dialog

대화상자의 카드 본문을 둘러싼 래퍼입니다.

필드

body

Card

입력 전용입니다. 모달로 렌더링되는 대화상자의 본문입니다. Google Chat 앱은 DateTimePicker, OnChangeAction 카드 항목을 지원하지 않습니다.

DialogAction

대화 및 요청 상태 코드를 포함합니다.

필드

action_status

ActionStatus

입력 전용입니다. 대화상자를 호출하거나 제출하는 요청의 상태입니다. 필요한 경우 사용자에게 상태 및 메시지를 표시합니다. 예를 들어 오류가 발생하거나 성공한 경우입니다.

통합 필드 action. 수행할 작업입니다. action은 다음 중 하나여야 합니다.

dialog

Dialog

입력 전용입니다. 요청에 대한 대화상자입니다.

DoNotDisturbMetadata

DO_NOT_DISTURB 사용 가능 상태와 연결된 메타데이터로, 상태가 만료되는 시점을 지정합니다.

필드

expiration_time

Timestamp

출력 전용입니다. 사용자가 DO_NOT_DISTURB로 표시되어야 하는 타임스탬프입니다. 향후 최대 1년까지 가능합니다.

DriveDataRef

Drive 첨부파일의 데이터에 대한 참조입니다.

필드

drive_file_id

string

Drive 파일의 ID입니다. Drive API와 함께 사용합니다.

DriveLinkData

Google Drive 링크의 데이터입니다.

필드

drive_data_ref

DriveDataRef

Google Drive 파일을 참조하는 DriveDataRef입니다.

mime_type

string

연결된 Google Drive 리소스의 MIME 유형입니다.

요소

요소는 메시지 생성 중에 제공된 메시지 텍스트와 연결될 수도 있고 연결되지 않을 수도 있는 추가 구성요소입니다.

필드

cited_sources[]

CitedSource

메시지 아래에 바닥글 링크로 표시할 소스 목록입니다. 이러한 항목은 인라인으로 참조되지 않습니다. 인라인 참조의 경우 citations를 사용합니다.

citations[]

Citation

메시지 텍스트 내에서 참조되는 인라인 인용 목록 (<chat-citation> 태그를 통해)으로, 상호작용형 호버 카드로 렌더링됩니다.

ElementsImage

이미지를 표현하는 다양한 방법을 캡슐화하는 객체입니다. 현재 지원되는 표현: - URI에서 가져온 이미지 향후 추가 표현이 지원될 수 있습니다.

필드

통합 필드 image. 필수 항목입니다. 지원되는 이미지 표현 중 하나입니다. image은 다음 중 하나여야 합니다.

image_uri

string

필수 항목입니다. 이미지의 공개적으로 액세스할 수 있는 URI입니다.

그림 이모티콘

메시지에 대한 반응으로 사용되는 그림 이모티콘입니다.

필드

통합 필드 content. 필수 항목입니다. 그림 이모티콘의 콘텐츠입니다. content은 다음 중 하나여야 합니다.

unicode

string

선택사항입니다. 유니코드 문자열로 표현되는 기본 이모티콘입니다.

custom_emoji

맞춤 이모티콘입니다.

EmojiReactionSummary

특정 이모티콘으로 메시지에 반응한 사용자 수입니다.

필드

emoji

Emoji

출력 전용입니다. 반응과 연결된 이모티콘입니다.

reaction_count

int32

출력 전용입니다. 연결된 이모티콘을 사용한 총 반응 수입니다.

FindDirectMessageRequest

사용자 리소스를 기반으로 채팅 메시지 스페이스를 가져오라는 요청입니다.

필드

name

string

필수 항목입니다. 채팅 메시지를 찾을 사용자의 리소스 이름입니다.

형식: users/{user}. 여기서 {user}은 People API의 사용자에 대한 id 또는 Directory API의 사용자에 대한 id입니다. 예를 들어 People API 프로필 ID가 123456789인 경우 users/123456789를 name로 사용하여 해당 사용자와의 채팅 메시지를 찾을 수 있습니다. 사용자로 인증되면 이메일을 {user}의 별칭으로 사용할 수 있습니다. 예를 들어 users/example@gmail.com에서 example@gmail.com은 Google Chat 사용자의 이메일입니다.

FindGroupChatsRequest

사용자 리소스를 기반으로 그룹 채팅 스페이스를 가져오라는 요청입니다.

필드
`users[]`	`string` 선택사항입니다. 호출 사용자와의 그룹 채팅에 참여하는 모든 사람 사용자의 리소스 이름입니다. 요청에 Chat 앱을 포함할 수 없습니다. 단일 요청에서 지정할 수 있는 최대 사용자 수는 `49`명입니다. 형식: `users/{user}`. 여기서 `{user}`은 People API의 사용자에 대한 `id`이거나 Directory API의 사용자에 대한 `id`입니다. 예를 들어 호출하는 사용자와 다른 두 사용자(People API 프로필 ID가 `123456789` 및 `987654321`인 사용자)가 참여하는 모든 그룹 채팅을 찾으려면 `users/123456789` 및 `users/987654321`를 사용하면 됩니다. 이 이메일을 `{user}`의 별칭으로 사용할 수도 있습니다. 예를 들어 `users/example@gmail.com`에서 `example@gmail.com`은 Google Chat 사용자의 이메일입니다.
`page_size`	`int32` 선택사항입니다. 반환할 최대 스페이스 수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 지정하지 않으면 최대 10개의 스페이스가 반환됩니다. 최댓값은 30입니다. 30을 초과하는 값을 사용하면 자동으로 30으로 변경됩니다. 음수 값은 `INVALID_ARGUMENT` 오류를 반환합니다.
`page_token`	`string` 선택사항입니다. 그룹 채팅을 찾기 위한 이전 호출에서 수신된 페이지 토큰입니다. 후속 페이지를 검색하려면 이 매개변수를 제공합니다. 페이지로 나누는 경우 제공된 다른 모든 매개변수가 토큰을 제공한 호출과 일치해야 합니다. 다른 값을 전달하면 예기치 않은 결과가 발생할 수 있습니다.
`space_view`	`SpaceView` 요청된 스페이스 뷰 유형입니다. 설정하지 않으면 기본값은 `SPACE_VIEW_RESOURCE_NAME_ONLY`입니다. `SPACE_VIEW_EXPANDED`를 지정하는 요청에는 스페이스 데이터 읽기를 허용하는 범위(예: https://www.googleapis.com/auth/chat.spaces 또는 https://www.googleapis.com/auth/chat.spaces.readonly)가 포함되어야 합니다.

FindGroupChatsResponse

호출한 사용자와 요청된 사용자가 정확히 포함된 그룹 채팅 스페이스가 포함된 응답입니다.

필드

spaces[]

요청된 (또는 첫 번째) 페이지의 스페이스 목록입니다.

next_page_token

string

결과의 다음 페이지를 검색하기 위해 pageToken으로 전송할 수 있는 토큰입니다. 비어 있으면 후속 페이지가 표시되지 않습니다.

ForwardedMetadata

메시지가 전달된 소스 스페이스에 관한 메타데이터입니다.

필드

space

string

출력 전용입니다. 원본 스페이스의 리소스 이름입니다. 형식: spaces/{space}

space_display_name

string

출력 전용입니다. 전달 시점의 원본 스페이스 또는 채팅 메시지의 표시 이름입니다. SPACE의 경우 스페이스 이름입니다. DIRECT_MESSAGE의 경우 다른 참여자의 이름입니다 (예: '사용자 A'). GROUP_CHAT의 경우 구성원의 이름을 기반으로 생성된 이름이며 크리에이터를 포함하여 최대 5명으로 제한됩니다 (예: '사용자 A, 사용자 B').

GetAttachmentRequest

첨부파일 가져오기 요청입니다.

필드

name

string

필수 항목입니다. spaces/{space}/messages/{message}/attachments/{attachment} 형식의 첨부파일 리소스 이름입니다.

GetAvailabilityRequest

GetAvailability 메서드에 대한 요청 메시지입니다.

필드

name

string

필수 항목입니다. 검색할 사용 가능 여부의 리소스 이름입니다.

형식: users/{user}/availability

{user}는 People API 또는 Admin SDK Directory API의 사용자 ID입니다. 예를 들면 다음과 같습니다. users/123456789

사용자의 이메일 주소 또는 me를 호출자를 참조하는 별칭으로 사용할 수도 있습니다. 예를 들어 users/user@example.com 또는 users/me입니다.

GetCustomEmojiRequest

단일 맞춤 그림 이모티콘을 반환하는 요청입니다.

필드

name

string

필수 항목입니다. 맞춤 이모티콘의 리소스 이름입니다.

형식: customEmojis/{customEmoji}

GetMembershipRequest

스페이스의 멤버십을 가져오기 위한 요청입니다.

필드

name

string

필수 항목입니다. 검색할 멤버십의 리소스 이름입니다.

사용자 인증을 사용하여 앱의 자체 멤버십을 가져오려면 원하는 경우 spaces/{space}/members/app를 사용하면 됩니다.

형식: spaces/{space}/members/{member} 또는 spaces/{space}/members/app

사용자의 이메일을 {member}의 별칭으로 사용할 수 있습니다. 예를 들어 spaces/{space}/members/example@gmail.com에서 example@gmail.com은 Google Chat 사용자의 이메일입니다.

use_admin_access

bool

선택사항입니다. true인 경우 메서드는 사용자의 Google Workspace 관리자 권한을 사용하여 실행됩니다.

호출하는 사용자는 채팅 및 스페이스 대화 관리 권한이 있는 Google Workspace 관리자여야 합니다.

chat.admin.memberships 또는 chat.admin.memberships.readonly OAuth 2.0 범위가 필요합니다.

관리 액세스를 사용하는 경우 스페이스에서 앱 멤버십을 가져올 수 없습니다.

GetMessageRequest

메시지 가져오기 요청입니다.

필드

name

string

필수 항목입니다. 메시지의 리소스 이름입니다.

형식: spaces/{space}/messages/{message}

markup_syntax

MarkupSyntax

선택사항입니다. 채팅 메시지 formatted_text 필드에 원하는 출력 문법을 지정합니다.

GetSpaceEventRequest

스페이스 이벤트를 가져오기 위한 요청 메시지입니다.

필드

name

string

필수 항목입니다. 스페이스 이벤트의 리소스 이름입니다.

형식: spaces/{space}/spaceEvents/{spaceEvent}

GetSpaceNotificationSettingRequest

스페이스 알림 설정을 가져오는 요청 메시지입니다. 호출 사용자의 알림 설정 가져오기만 지원합니다.

필드

name

string

필수 항목입니다. 형식: users/{user}/spaces/{space}/spaceNotificationSetting

users/me/spaces/{space}/spaceNotificationSetting 또는
users/user@example.com/spaces/{space}/spaceNotificationSetting 또는
users/123456789/spaces/{space}/spaceNotificationSetting. 참고: 경로에는 호출자의 사용자 ID 또는 이메일만 허용됩니다.

GetSpaceReadStateRequest

GetSpaceReadState API의 요청 메시지입니다.

필드

name

string

필수 항목입니다. 검색할 스페이스 읽기 상태의 리소스 이름입니다.

호출 사용자의 읽기 상태 가져오기만 지원합니다.

호출 사용자를 참조하려면 다음 중 하나를 설정합니다.

me 별칭입니다. 예를 들면 다음과 같습니다. users/me/spaces/{space}/spaceReadState
Workspace 이메일 주소 예를 들면 users/user@example.com/spaces/{space}/spaceReadState입니다.
사용자 ID 예를 들면 users/123456789/spaces/{space}/spaceReadState입니다.

형식: users/{user}/spaces/{space}/spaceReadState

GetSpaceRequest

단일 스페이스를 반환하는 요청입니다.

필드

name

string

필수 항목입니다. spaces/{space} 형식의 스페이스 리소스 이름입니다.

형식: spaces/{space}

use_admin_access

bool

선택사항입니다. true인 경우 메서드는 사용자의 Google Workspace 관리자 권한을 사용하여 실행됩니다.

호출하는 사용자는 채팅 및 스페이스 대화 관리 권한이 있는 Google Workspace 관리자여야 합니다.

chat.admin.spaces 또는 chat.admin.spaces.readonly OAuth 2.0 범위가 필요합니다.

GetThreadReadStateRequest

GetThreadReadStateRequest API의 요청 메시지입니다.

필드

name

string

필수 항목입니다. 검색할 대화목록 읽음 상태의 리소스 이름입니다.

호출 사용자의 읽기 상태 가져오기만 지원합니다.

호출 사용자를 참조하려면 다음 중 하나를 설정합니다.

me 별칭입니다. 예를 들면 다음과 같습니다. users/me/spaces/{space}/threads/{thread}/threadReadState
Workspace 이메일 주소 예를 들면 users/user@example.com/spaces/{space}/threads/{thread}/threadReadState입니다.
사용자 ID 예를 들면 users/123456789/spaces/{space}/threads/{thread}/threadReadState입니다.

형식: users/{user}/spaces/{space}/threads/{thread}/threadReadState

그룹

Google Chat의 Google 그룹스

필드

name

string

Google 그룹의 리소스 이름입니다.

Cloud Identity Groups API의 그룹을 나타냅니다.

형식: groups/{group}

HistoryState

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

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

ListCustomEmojisRequest

맞춤 이모티콘 목록을 반환하는 요청입니다.

필드

page_size

int32

선택사항입니다. 반환되는 맞춤 이모티콘의 최대 개수입니다. 서비스는 이 값보다 적은 수의 맞춤 그림 이모티콘을 반환할 수 있습니다. 지정하지 않으면 기본값은 25입니다. 최댓값은 200이며 200을 초과하는 값은 200으로 변경됩니다.

page_token

string

선택사항입니다. (이전 쿼리에서 재개하는 경우)

이전 맞춤 이모티콘 나열 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다.

페이지로 나누는 경우 필터 값이 페이지 토큰을 제공한 호출과 일치해야 합니다. 다른 값을 전달하면 예기치 않은 결과가 발생할 수 있습니다.

filter

string

선택사항입니다. 쿼리 필터입니다.

크리에이터별 필터링을 지원합니다.

작성자로 필터링하려면 유효한 값을 지정해야 합니다. 현재는 creator("users/me") 및 NOT creator("users/me")만 허용되어 호출 사용자가 만들었는지 여부에 따라 맞춤 이모티콘을 필터링합니다.

예를 들어 다음 쿼리는 호출자가 만든 맞춤 이모티콘을 반환합니다.

creator("users/me")

잘못된 쿼리는 INVALID_ARGUMENT 오류와 함께 거부됩니다.

ListCustomEmojisResponse

맞춤 이모티콘을 나열하는 응답입니다.

필드

custom_emojis[]

순서가 지정되지 않은 목록 맞춤 이모티콘 목록입니다.

next_page_token

string

결과의 다음 페이지를 검색하기 위해 pageToken으로 전송할 수 있는 토큰입니다. 비어 있으면 후속 페이지가 표시되지 않습니다.

ListMembershipsRequest

멤버십 나열 요청 메시지입니다.

필드
`parent`	`string` 필수 항목입니다. 멤버십 목록을 가져올 스페이스의 리소스 이름입니다. 형식: spaces/{space}
`page_size`	`int32` 선택사항입니다. 반환할 최대 멤버십 수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 지정하지 않으면 멤버십이 최대 100개 반환됩니다. 최댓값은 1,000입니다. 1,000보다 큰 값을 사용하면 자동으로 1,000으로 변경됩니다. 음수 값은 `INVALID_ARGUMENT` 오류를 반환합니다.
`page_token`	`string` 선택사항입니다. 멤버십을 나열하기 위한 이전 호출에서 수신된 페이지 토큰입니다. 후속 페이지를 검색하려면 이 매개변수를 제공합니다. 페이지로 나누는 경우 제공된 다른 모든 매개변수가 페이지 토큰을 제공한 호출과 일치해야 합니다. 다른 매개변수에 다른 값을 전달하면 예기치 않은 결과가 발생할 수 있습니다.
`filter`	`string` 선택사항입니다. 쿼리 필터입니다. 구성원의 역할 (`role`) 및 유형 (`member.type`)별로 멤버십을 필터링할 수 있습니다. 역할별로 필터링하려면 `role`을 `ROLE_MEMBER` 또는 `ROLE_MANAGER`로 설정합니다. 유형별로 필터링하려면 `member.type`를 `HUMAN` 또는 `BOT`로 설정합니다. `!=` 연산자를 사용하여 `member.type`를 필터링할 수도 있습니다. 역할과 유형을 모두 기준으로 필터링하려면 `AND` 연산자를 사용합니다. 역할 또는 유형으로 필터링하려면 `OR` 연산자를 사용합니다. `use_admin_access`가 true로 설정된 경우 `member.type = "HUMAN"` 또는 `member.type != "BOT"`가 필요합니다. 다른 회원 유형 필터는 거부됩니다. 예를 들어 다음 쿼리는 유효합니다. `role = "ROLE_MANAGER" OR role = "ROLE_MEMBER" member.type = "HUMAN" AND role = "ROLE_MANAGER" member.type != "BOT"` 다음 쿼리는 유효하지 않습니다. `member.type = "HUMAN" AND member.type = "BOT" role = "ROLE_MANAGER" AND role = "ROLE_MEMBER"` 잘못된 쿼리는 서버에서 `INVALID_ARGUMENT` 오류와 함께 거부됩니다.
`show_groups`	`bool` 선택사항입니다. `true`인 경우 다른 유형의 멤버십 외에도 `Google Group`와 연결된 멤버십을 반환합니다. `filter`가 설정된 경우 필터 기준과 일치하지 않는 `Google Group` 멤버십은 반환되지 않습니다.
`show_invited`	`bool` 선택사항입니다. `true`인 경우 다른 유형의 멤버십 외에도 `invited` 구성원과 연결된 멤버십도 반환합니다. 필터가 설정된 경우 필터 기준과 일치하지 않는 `invited` 멤버십은 반환되지 않습니다. 현재 사용자 인증이 필요합니다.
`use_admin_access`	`bool` 선택사항입니다. `true`인 경우 메서드는 사용자의 Google Workspace 관리자 권한을 사용하여 실행됩니다. 호출하는 사용자는 채팅 및 스페이스 대화 관리 권한이 있는 Google Workspace 관리자여야 합니다. `chat.admin.memberships.readonly` 또는 `chat.admin.memberships` OAuth 2.0 범위가 필요합니다. 관리 액세스를 사용하는 경우 스페이스의 앱 멤버십을 나열하는 기능은 지원되지 않습니다.

ListMembershipsResponse

스페이스의 멤버십을 나열하는 응답입니다.

필드

memberships[]

순서가 지정되지 않은 목록 요청된 (또는 첫 번째) 페이지의 멤버십 목록입니다.

next_page_token

string

결과의 다음 페이지를 검색하기 위해 pageToken으로 전송할 수 있는 토큰입니다. 비어 있으면 후속 페이지가 표시되지 않습니다.

ListMessagePinsRequest

메시지 고정 목록을 표시하기 위한 요청 메시지입니다.

필드

parent

string

필수 항목입니다. 고정된 항목 컬렉션을 소유한 상위 스페이스입니다. 형식: spaces/{space}

page_size

int32

선택사항입니다. 반환되는 최대 메시지 고정 수입니다. 서비스가 이 값보다 더 적은 메시지를 반환할 수 있습니다. 최댓값은 100입니다. 100을 초과하는 값을 사용하면 자동으로 100으로 변경됩니다. 지정하지 않으면 최대 100개의 메시지 고정이 반환됩니다. 음수 값은 INVALID_ARGUMENT 오류를 반환합니다.

page_token

string

선택사항입니다. 이전 메시지 고정 목록 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이 매개변수를 제공합니다.

페이지로 나누는 경우 제공된 다른 모든 매개변수가 페이지 토큰을 제공한 호출과 일치해야 합니다. 다른 매개변수에 다른 값을 전달하면 예기치 않은 결과가 발생할 수 있습니다.

ListMessagePinsResponse

메시지 고정을 나열하기 위한 응답 메시지입니다.

필드

message_pins[]

MessagePin

지정된 스페이스의 고정된 메시지입니다.

next_page_token

string

토큰을 pageToken으로 전송하여 결과의 다음 페이지를 검색할 수 있습니다. 비어 있으면 후속 페이지가 표시되지 않습니다.

ListMessagesRequest

사용자가 속한 지정된 스페이스의 메시지를 나열합니다.

필드
`parent`	`string` 필수 항목입니다. 메시지를 나열할 스페이스의 리소스 이름입니다. 형식: `spaces/{space}`
`page_size`	`int32` 선택사항입니다. 반환되는 최대 메시지 수입니다. 서비스가 이 값보다 더 적은 메시지를 반환할 수 있습니다. 지정하지 않으면 최대 25개가 반환됩니다. 최댓값은 1,000입니다. 1,000보다 큰 값을 사용하면 자동으로 1,000으로 변경됩니다. 음수 값은 `INVALID_ARGUMENT` 오류를 반환합니다.
`page_token`	`string` 선택사항입니다. 이전 메시지 목록 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이 매개변수를 제공합니다. 페이지로 나누는 경우 제공된 다른 모든 매개변수가 페이지 토큰을 제공한 호출과 일치해야 합니다. 다른 매개변수에 다른 값을 전달하면 예기치 않은 결과가 발생할 수 있습니다.
`filter`	`string` 선택사항입니다. 쿼리 필터입니다. 날짜 (`create_time`) 및 대화목록 (`thread.name`)별로 메시지를 필터링할 수 있습니다. 생성된 날짜를 기준으로 메시지를 필터링하려면 RFC-3339 형식의 타임스탬프와 큰따옴표를 사용하여 `create_time`를 지정합니다. 예를 들면 `"2023-04-21T11:30:00-04:00"`입니다. 보다 큼 연산자 `>`를 사용하여 타임스탬프 이후에 생성된 메시지를 나열하거나 보다 작음 연산자 `<`를 사용하여 타임스탬프 이전에 생성된 메시지를 나열할 수 있습니다. 시간 간격 내에서 메시지를 필터링하려면 두 타임스탬프 사이에 `AND` 연산자를 사용합니다. 대화목록별로 필터링하려면 `thread.name`를 `spaces/{space}/threads/{thread}` 형식으로 지정합니다. 쿼리당 하나의 `thread.name`만 지정할 수 있습니다. 대화목록과 날짜를 모두 기준으로 필터링하려면 쿼리에 `AND` 연산자를 사용합니다. 예를 들어 다음 쿼리는 유효합니다. `create_time > "2012-04-21T11:30:00-04:00" create_time > "2012-04-21T11:30:00-04:00" AND thread.name = spaces/AAAAAAAAAAA/threads/123 create_time > "2012-04-21T11:30:00+00:00" AND create_time < "2013-01-01T00:00:00+00:00" AND thread.name = spaces/AAAAAAAAAAA/threads/123 thread.name = spaces/AAAAAAAAAAA/threads/123` 잘못된 쿼리는 서버에서 `INVALID_ARGUMENT` 오류와 함께 거부됩니다.
`order_by`	`string` 선택사항입니다. 메시지 목록의 정렬 방식입니다. 정렬 작업으로 정렬할 값을 지정합니다. 유효한 정렬 작업 값은 다음과 같습니다. 오름차순의 경우 `ASC` 내림차순의 경우 `DESC` 기본 순서는 `create_time ASC`입니다.
`show_deleted`	`bool` 선택사항입니다. 삭제된 메시지를 포함할지 여부입니다. 삭제된 메시지에는 삭제된 시간과 삭제에 관한 메타데이터가 포함되지만 메시지 콘텐츠는 사용할 수 없습니다.
`markup_syntax`	`MarkupSyntax` 선택사항입니다. 채팅 메시지 `formatted_text` 필드에 원하는 출력 문법을 지정합니다.

ListMessagesResponse

메시지 나열에 대한 응답 메시지입니다.

필드

messages[]

메시지 목록입니다.

next_page_token

string

토큰을 pageToken으로 전송하여 결과의 다음 페이지를 검색할 수 있습니다. 비어 있으면 후속 페이지가 표시되지 않습니다.

ListReactionsRequest

메시지에 대한 반응을 나열합니다.

필드
`parent`	`string` 필수 항목입니다. 사용자가 반응한 메시지입니다. 형식: `spaces/{space}/messages/{message}`
`page_size`	`int32` 선택사항입니다. 반환되는 최대 반응 수입니다. 서비스는 이 값보다 적은 반응을 반환할 수 있습니다. 지정하지 않으면 기본값은 25입니다. 최댓값은 200이며 200을 초과하는 값은 200으로 변경됩니다.
`page_token`	`string` 선택사항입니다. (이전 쿼리에서 재개하는 경우) 이전 list reactions 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다. 페이지로 나누는 경우 필터 값이 페이지 토큰을 제공한 호출과 일치해야 합니다. 다른 값을 전달하면 예기치 않은 결과가 발생할 수 있습니다.
`filter`	`string` 선택사항입니다. 쿼리 필터입니다. 이모티콘 (`emoji.unicode` 또는 `emoji.custom_emoji.uid`) 및 사용자 (`user.name`)별로 반응을 필터링할 수 있습니다. 여러 이모티콘 또는 사용자의 반응을 필터링하려면 `OR` 연산자를 사용하여 유사한 필드를 조인합니다(예: `emoji.unicode = "🙂" OR emoji.unicode = "👍"` 및 `user.name = "users/AAAAAA" OR user.name = "users/BBBBBB"`). 이모티콘 및 사용자로 반응을 필터링하려면 `AND` 연산자(예: `emoji.unicode = "🙂" AND user.name = "users/AAAAAA"`)를 사용합니다. 쿼리에서 `AND`와 `OR`를 모두 사용하는 경우 괄호로 그룹화합니다. 예를 들어 다음 쿼리는 유효합니다. `user.name = "users/{user}" emoji.unicode = "🙂" emoji.custom_emoji.uid = "{uid}" emoji.unicode = "🙂" OR emoji.unicode = "👍" emoji.unicode = "🙂" OR emoji.custom_emoji.uid = "{uid}" emoji.unicode = "🙂" AND user.name = "users/{user}" (emoji.unicode = "🙂" OR emoji.custom_emoji.uid = "{uid}") AND user.name = "users/{user}"` 다음 쿼리는 유효하지 않습니다. `emoji.unicode = "🙂" AND emoji.unicode = "👍" emoji.unicode = "🙂" AND emoji.custom_emoji.uid = "{uid}" emoji.unicode = "🙂" OR user.name = "users/{user}" emoji.unicode = "🙂" OR emoji.custom_emoji.uid = "{uid}" OR user.name = "users/{user}" emoji.unicode = "🙂" OR emoji.custom_emoji.uid = "{uid}" AND user.name = "users/{user}"` 잘못된 쿼리는 `INVALID_ARGUMENT` 오류와 함께 거부됩니다.

ListReactionsResponse

반응 나열 요청에 대한 응답입니다.

필드

reactions[]

요청된 (또는 첫 번째) 페이지의 반응 목록입니다.

next_page_token

string

결과의 다음 페이지를 검색하는 연속 토큰입니다. 결과의 마지막 페이지는 비어 있습니다.

ListSectionItemsRequest

섹션 항목을 나열하기 위한 요청 메시지입니다.

필드
`parent`	`string` 필수 항목입니다. 이 섹션 항목 컬렉션을 소유한 섹션 리소스 이름인 상위 항목입니다. 호출 사용자의 섹션 항목 나열만 지원합니다. 스페이스로 필터링할 때 와일드 카드 `-`를 사용하여 모든 섹션을 검색합니다. 예를 들면 다음과 같습니다. `users/{user}/sections/-` 형식: `users/{user}/sections/{section}`
`page_size`	`int32` 선택사항입니다. 반환할 최대 섹션 항목 수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 지정하지 않으면 최대 10개의 섹션 항목이 반환됩니다. 최댓값은 100입니다. 100을 초과하는 값을 사용하면 자동으로 100으로 변경됩니다. 음수 값은 `INVALID_ARGUMENT` 오류를 반환합니다.
`page_token`	`string` 선택사항입니다. 이전 섹션 항목 나열 호출에서 수신한 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다. 페이지로 나누는 경우 제공된 다른 모든 매개변수가 페이지 토큰을 제공한 호출과 일치해야 합니다. 다른 매개변수에 다른 값을 전달하면 예기치 않은 결과가 발생할 수 있습니다.
`filter`	`string` 선택사항입니다. 쿼리 필터입니다. 현재는 스페이스별 필터링만 지원됩니다. 예를 들면 `space = spaces/{space}`입니다. 잘못된 쿼리는 `INVALID_ARGUMENT` 오류와 함께 거부됩니다.

ListSectionItemsResponse

섹션 항목 나열에 대한 응답 메시지입니다.

필드

section_items[]

SectionItem

지정된 섹션의 섹션 항목입니다.

next_page_token

string

다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

ListSectionsRequest

섹션 나열 요청 메시지입니다.

필드

parent

string

필수 항목입니다. 이 섹션 컬렉션을 소유한 사용자 리소스 이름인 상위 항목입니다. 호출 사용자의 섹션 나열만 지원합니다. 호출 사용자를 참조하려면 다음 중 하나를 설정합니다.

me 별칭입니다. 예를 들면 다음과 같습니다. users/me
Workspace 이메일 주소 예를 들면 users/user@example.com입니다.
사용자 ID 예를 들면 users/123456789입니다.

형식: users/{user}

page_size

int32

선택사항입니다. 반환할 최대 섹션 수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다.

지정하지 않으면 최대 10개의 섹션이 반환됩니다.

최댓값은 100입니다. 100을 초과하는 값을 사용하면 자동으로 100으로 변경됩니다.

음수 값은 INVALID_ARGUMENT 오류를 반환합니다.

page_token

string

선택사항입니다. 이전 섹션 나열 호출에서 수신된 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다.

ListSectionsResponse

섹션 나열에 대한 응답 메시지입니다.

필드

sections[]

지정된 사용자의 섹션입니다.

next_page_token

string

다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

ListSpaceEventsRequest

스페이스 이벤트를 나열하는 요청 메시지입니다.

필드
`parent`	`string` 필수 항목입니다. 이벤트가 발생한 Google Chat 스페이스의 리소스 이름입니다. 형식은 `spaces/{space}`입니다.
`page_size`	`int32` 선택사항입니다. 반환되는 최대 스페이스 이벤트 수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 음수 값은 `INVALID_ARGUMENT` 오류를 반환합니다.
`page_token`	`string` 선택사항입니다. 이전 스페이스 이벤트 목록 호출에서 수신한 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다. 페이지로 나누는 경우 스페이스 이벤트 목록에 제공하는 다른 모든 매개변수가 페이지 토큰을 제공한 호출과 일치해야 합니다. 다른 매개변수에 다른 값을 전달하면 예기치 않은 결과가 발생할 수 있습니다.
`filter`	`string` 필수 항목입니다. 쿼리 필터입니다. `:` 연산자를 사용하여 이벤트 유형 (`event_type`)을 하나 이상 지정해야 합니다. 여러 이벤트 유형으로 필터링하려면 `OR` 연산자를 사용합니다. 필터에서 일괄 이벤트 유형을 생략합니다. 요청은 관련 일괄 이벤트를 자동으로 반환합니다. 예를 들어 새 반응 (`google.workspace.chat.reaction.v1.created`)으로 필터링하면 서버는 일괄 새 반응 이벤트 (`google.workspace.chat.reaction.v1.batchCreated`)도 반환합니다. 지원되는 이벤트 유형 목록은 `SpaceEvents` 참고 문서를 확인하세요. 원하는 경우 시작 시간 (`start_time`) 및 종료 시간 (`end_time`)으로 필터링할 수도 있습니다. `start_time`: 스페이스 이벤트를 나열하기 시작하는 배타적 타임스탬프입니다. 최대 28일 전에 발생한 이벤트를 나열할 수 있습니다. 지정하지 않으면 지난 28일 동안의 스페이스 이벤트를 나열합니다. `end_time`: 스페이스 이벤트가 나열되는 타임스탬프입니다(해당 타임스탬프 포함). 지정하지 않으면 요청 시간까지의 일정이 나열됩니다. 시작 시간 또는 종료 시간을 지정하려면 같음 `=` 연산자를 사용하고 RFC-3339 형식으로 지정합니다. `start_time` 및 `end_time`로 모두 필터링하려면 `AND` 연산자를 사용합니다. 예를 들어 다음 쿼리는 유효합니다. `start_time="2023-08-23T19:20:33+00:00" AND end_time="2023-08-23T19:21:54+00:00"` `start_time="2023-08-23T19:20:33+00:00" AND (event_types:"google.workspace.chat.space.v1.updated" OR event_types:"google.workspace.chat.message.v1.created")` 다음 쿼리는 유효하지 않습니다. `start_time="2023-08-23T19:20:33+00:00" OR end_time="2023-08-23T19:21:54+00:00"` `event_types:"google.workspace.chat.space.v1.updated" AND event_types:"google.workspace.chat.message.v1.created"` 잘못된 쿼리는 서버에서 `INVALID_ARGUMENT` 오류와 함께 거부됩니다.

ListSpaceEventsResponse

스페이스 이벤트 목록에 대한 응답 메시지입니다.

필드

space_events[]

SpaceEvent

결과는 시간순으로 반환됩니다 (가장 오래된 이벤트가 먼저 표시됨). 참고: permissionSettings 필드는 목록 요청의 스페이스 객체에서 반환되지 않습니다.

next_page_token

string

더 많은 이벤트를 가져오는 데 사용되는 연속 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

ListSpacesRequest

호출자가 멤버인 스페이스를 나열하는 요청입니다.

필드

page_size

int32

선택사항입니다. 반환할 최대 스페이스 수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다.

지정하지 않으면 최대 100개의 스페이스가 반환됩니다.

최댓값은 1,000입니다. 1,000보다 큰 값을 사용하면 자동으로 1,000으로 변경됩니다.

음수 값은 INVALID_ARGUMENT 오류를 반환합니다.

page_token

string

선택사항입니다. 이전 스페이스 목록 호출에서 수신한 페이지 토큰입니다. 후속 페이지를 검색하려면 이 매개변수를 제공합니다.

페이지로 나누는 경우 필터 값이 페이지 토큰을 제공한 호출과 일치해야 합니다. 다른 값을 전달하면 예기치 않은 결과가 발생할 수 있습니다.

filter

string

선택사항입니다. 쿼리 필터입니다.

스페이스 유형 (space_type)별로 스페이스를 필터링할 수 있습니다.

스페이스 유형으로 필터링하려면 SPACE 또는 GROUP_CHAT와 같은 유효한 enum 값을 지정해야 합니다 (space_type는 SPACE_TYPE_UNSPECIFIED일 수 없음). 여러 스페이스 유형을 쿼리하려면 OR 연산자를 사용합니다.

예를 들어 다음 쿼리는 유효합니다.

space_type = "SPACE"
spaceType = "GROUP_CHAT" OR spaceType = "DIRECT_MESSAGE"

잘못된 쿼리는 서버에서 INVALID_ARGUMENT 오류와 함께 거부됩니다.

ListSpacesResponse

스페이스 목록 요청에 대한 응답입니다.

필드

spaces[]

MembershipCreatedEventData

요청된 (또는 첫 번째) 페이지의 스페이스 목록입니다. 참고: permissionSettings 필드는 목록 요청의 스페이스 객체에서 반환되지 않습니다.

next_page_token

string

토큰을 pageToken으로 전송하여 결과의 다음 페이지를 검색할 수 있습니다. 비어 있으면 후속 페이지가 표시되지 않습니다.

MarkAsActiveRequest

MarkAsActive 메서드에 대한 요청 메시지입니다.

필드
`name`	`string` 필수 항목입니다. 활성 상태로 표시할 사용 가능 여부의 리소스 이름입니다. 형식: users/{user}/availability `{user}`는 People API 또는 Admin SDK Directory API의 사용자 ID입니다. 예를 들면 다음과 같습니다. `users/123456789` 사용자의 이메일 주소 또는 `me`를 호출자를 참조하는 별칭으로 사용할 수도 있습니다. 예를 들어 `users/user@example.com` 또는 `users/me`입니다.
통합 필드 `expiration`. ACTIVE 사용 가능 상태의 만료 시간입니다. 만료 후 사용자가 부재중으로 표시됩니다. 만료 시간이 제공되지 않으면 ACTIVE 상태는 현재 시간으로부터 30분 후에 만료됩니다. `expiration`은 다음 중 하나여야 합니다.
`expire_time`	`Timestamp` ACTIVE 상태가 만료되는 절대 타임스탬프입니다.
`ttl`	`Duration` 현재 시간부터 ACTIVE 상태가 만료될 때까지의 기간입니다. 짧은 TTL을 사용하면 이 짧은 시간 후의 활동을 기반으로 사용자의 상태를 효과적으로 재설정할 수 있습니다.

MarkAsAwayRequest

MarkAsAway 메서드에 대한 요청 메시지입니다.

필드

name

string

필수 항목입니다. 부재중으로 표시할 참석 가능 여부의 리소스 이름입니다. 형식: users/{user}/availability

{user}는 People API 또는 Admin SDK Directory API의 사용자 ID입니다. 예를 들면 다음과 같습니다. users/123456789

사용자의 이메일 주소 또는 me를 호출자를 참조하는 별칭으로 사용할 수도 있습니다. 예를 들어 users/user@example.com 또는 users/me입니다.

MarkAsDoNotDisturbRequest

MarkAsDoNotDisturb 메서드에 대한 요청 메시지입니다.

필드
`name`	`string` 필수 항목입니다. 방해 금지 모드로 표시할 참석 가능 여부의 리소스 이름입니다. 형식: users/{user}/availability `{user}`는 People API 또는 Admin SDK Directory API의 사용자 ID입니다. 예를 들면 다음과 같습니다. `users/123456789` 사용자의 이메일 주소 또는 `me`를 호출자를 참조하는 별칭으로 사용할 수도 있습니다. 예를 들어 `users/user@example.com` 또는 `users/me`입니다.
통합 필드 `expiration`. 필수 항목입니다. 방해 금지 모드 사용 가능 상태의 만료 시간입니다. 만료 후 사용자가 부재중으로 표시됩니다. 현재 시간으로부터 최대 1년까지 가능합니다. `expiration`은 다음 중 하나여야 합니다.
`expire_time`	`Timestamp` 방해 금지 모드 상태가 만료되는 절대 타임스탬프입니다.
`ttl`	`Duration` 현재 시간부터 방해 금지 모드 상태가 만료될 때까지의 기간입니다.

MarkupSyntax

채팅 메시지 텍스트의 형식을 지정하는 데 사용되는 마크업 문법을 지정합니다. Message 리소스의 text 필드에 적용됩니다.

열거형
`MARKUP_SYNTAX_UNSPECIFIED`	지정되지 않은 값을 나타냅니다.
`MARKUP_SYNTAX_CHAT`	Google Chat의 마크업 문법을 사용합니다. 자세한 내용은 https://developers.google.com/workspace/chat/format-messages#format-texts를 참고하세요.
`MARKUP_SYNTAX_MARKDOWN`	마크다운 문법을 사용합니다. 이 문법은 CommonMark 사양을 기반으로 하며 추가 확장 프로그램이 있습니다. 자세한 내용은 https://developers.google.com/workspace/chat/format-messages#format-texts를 참고하세요.

MatchedUrl

채팅 메시지에서 일치하는 URL입니다. 채팅 앱은 일치하는 URL을 미리 볼 수 있습니다. 자세한 내용은 링크 미리보기를 참고하세요.

필드

url

string

출력 전용입니다. 일치하는 URL입니다.

MeetSpaceLinkData

Meet 스페이스 링크의 데이터입니다.

필드

meeting_code

string

연결된 Meet 스페이스의 회의 코드입니다.

type

Type

Meet 스페이스의 유형을 나타냅니다.

huddle_status

HuddleStatus

선택사항입니다. 출력 전용입니다. Meet이 허들인 경우 허들의 상태를 나타냅니다. 그렇지 않으면 설정되지 않습니다.

HuddleStatus

허들 상태

열거형
`HUDDLE_STATUS_UNSPECIFIED`	enum의 기본값입니다. 사용하지 마세요.
`STARTED`	허들이 시작되었습니다.
`ENDED`	허들이 종료되었습니다. 이 경우 Meet 스페이스 URI 및 식별자가 더 이상 유효하지 않습니다.
`MISSED`	허들이 부재중입니다. 이 경우 Meet 스페이스 URI 및 식별자가 더 이상 유효하지 않습니다.

유형

Meet 스페이스의 유형입니다.

열거형
`TYPE_UNSPECIFIED`	enum의 기본값입니다. 사용하지 마세요.
`MEETING`	Meet 스페이스는 회의입니다.
`HUDDLE`	Meet 공간은 허들입니다.

멤버십

사용자 또는 Chat 앱이 스페이스에 초대되었는지, 스페이스에 참여 중인지, 스페이스에 없는지 등 Google Chat의 멤버십 관계를 나타냅니다.

필드
`name`	`string` 식별자. 서버에서 할당한 멤버십의 리소스 이름입니다. 형식: `spaces/{space}/members/{member}`
`state`	`MembershipState` 출력 전용입니다. 멤버십 상태입니다.
`role`	`MembershipRole` 선택사항입니다. Chat 스페이스 내 사용자의 역할로, 스페이스에서 허용되는 작업을 결정합니다. 이 필드는 `UpdateMembership`에서 입력으로만 사용할 수 있습니다.
`create_time`	`Timestamp` 선택사항입니다. 변경할 수 없습니다. 멤버십이 생성된 시간입니다(예: 멤버가 스페이스에 참여하거나 참여하도록 초대된 시간). 이 필드는 가져오기 모드 스페이스에서 이전 멤버십을 가져오는 데 사용되는 경우를 제외하고 출력 전용입니다.
`delete_time`	`Timestamp` 선택사항입니다. 변경할 수 없습니다. 멤버가 스페이스에서 나가거나 삭제된 시간과 같은 멤버십 삭제 시간입니다. 이 필드는 가져오기 모드 스페이스에서 이전 멤버십을 가져오는 데 사용되는 경우를 제외하고 출력 전용입니다.
`affiliation`	`Affiliation` 출력 전용입니다. 스페이스를 소유한 Workspace 조직과 사용자의 관계입니다. 일반 계정이 소유한 스페이스에서 모든 참여자의 소속은 `EXTERNAL`입니다.
통합 필드 `memberType`. 이 멤버십과 연결된 회원입니다. 향후 다른 구성원 유형이 지원될 수 있습니다. `memberType`은 다음 중 하나여야 합니다.
`member`	`User` 선택사항입니다. 멤버십에 해당하는 Google Chat 사용자 또는 앱입니다. Chat 앱이 사용자로 인증하는 경우, 스페이스의 멤버이거나 호출 사용자와 채팅 메시지 (DM) 대화와 같은 이전 친밀도가 있는 경우가 아니면 내부 및 외부 사용자 모두에 대해 사용자 `name` 및 `type` 필드만 채웁니다.
`group_member`	`Group` 선택사항입니다. 멤버십이 해당하는 Google 그룹입니다. Google 그룹스의 멤버십을 읽거나 변경하려면 사용자 인증이 필요합니다.

제휴

스페이스를 소유한 Google Workspace 조직에 대한 사용자의 소속을 나타냅니다. 이 enum에는 향후 더 많은 값이 추가될 수 있습니다.

열거형
`AFFILIATION_UNSPECIFIED`	기본값 이 값은 사용되지 않습니다.
`INTERNAL`	스페이스를 소유한 동일한 Google Workspace 조직에서 관리하는 계정입니다.
`EXTERNAL`	스페이스를 소유한 Google Workspace 조직 외부의 계정 (예: 일반 계정 또는 다른 Workspace 조직에서 관리하는 계정)
`MANAGED_EXTERNAL`	스페이스를 소유한 Workspace 조직에서 관리하지만 조직 외부의 사용자 (예: 게스트 사용자)를 위해 프로비저닝된 계정입니다. 게스트에 대해 자세히 알아보려면 https://support.google.com/chat/answer/16997417를 참고하세요.

MembershipRole

Chat 스페이스에서 사용자가 허용하는 작업을 나타냅니다. 향후 더 많은 enum 값이 추가될 수 있습니다.

열거형
`MEMBERSHIP_ROLE_UNSPECIFIED`	기본값 `users`: 스페이스의 멤버가 아니지만 초대할 수 있습니다. `Google Groups`: 항상 이 역할이 할당됩니다 (향후 다른 enum 값이 사용될 수 있음).
`ROLE_MEMBER`	스페이스의 구성원입니다. Chat UI에서 이 역할은 멤버라고 합니다. 사용자에게 스페이스에 메시지를 보내는 등의 기본 권한이 있습니다. 관리자와 소유자는 스페이스에서 멤버에게 다음과 같은 추가 권한을 부여할 수 있습니다. 회원을 추가하거나 삭제합니다. 스페이스 세부정보 수정 대화 기록 사용 설정 또는 사용 중지 `@all`를 사용하여 스페이스의 모든 사용자를 멘션합니다. 스페이스에 설치된 Chat 앱 및 웹훅을 관리합니다. 채팅 메시지 및 이름이 지정되지 않은 그룹 대화에서는 모든 사용자가 이 역할을 갖습니다.
`ROLE_MANAGER`	스페이스 소유자 Chat UI에서 이 역할은 소유자라고 합니다. 사용자는 다음을 포함하여 스페이스를 관리할 수 있는 전체 스페이스 권한을 갖습니다. 스페이스에 있는 다른 멤버의 역할을 멤버, 관리자 또는 소유자로 변경합니다. 스페이스 삭제 `SpaceType.SPACE` (이름이 지정된 스페이스)에서만 지원됩니다. 자세한 내용은 스페이스 소유자 또는 관리자 역할 자세히 알아보기를 참고하세요.
`ROLE_ASSISTANT_MANAGER`	스페이스 관리자 Chat UI에서 이 역할은 관리자라고 합니다. 사용자는 `ROLE_MEMBER`의 모든 기본 권한을 가지며 소유자로부터 관리 권한의 하위 집합을 부여받을 수 있습니다. 기본적으로 관리자는 다음 기능을 제외하고 소유자와 동일한 권한을 갖습니다. 스페이스 삭제 다른 스페이스 멤버를 소유자로 지정합니다. 소유자의 역할을 변경합니다. 기본적으로 관리자 권한에는 다음이 포함되지만 이에 국한되지는 않습니다. 다른 멤버를 관리자로 지정합니다. 스페이스에서 메시지를 삭제합니다. 스페이스 권한 관리 관리자가 스페이스 설정에서 '멤버 관리' 권한을 가지고 있는 경우 스페이스 참여 요청에 대한 알림을 받습니다. 스페이스를 검색 가능하게 설정합니다. `SpaceType.SPACE` (이름이 지정된 스페이스)에서만 지원됩니다. 자세한 내용은 스페이스 설정 관리하기를 참고하세요.

MembershipState

스페이스와 구성원의 관계를 지정합니다. 향후 다른 멤버십 상태가 지원될 수 있습니다.

열거형
`MEMBERSHIP_STATE_UNSPECIFIED`	기본값 사용하지 마세요.
`JOINED`	사용자가 스페이스에 추가되고 스페이스에 참여할 수 있습니다.
`INVITED`	사용자가 스페이스에 초대되었지만 참여하지 않았습니다.
`NOT_A_MEMBER`	사용자가 스페이스에 속해 있지 않으며 스페이스 참여를 위한 대기 중인 초대가 없습니다.

MembershipBatchCreatedEventData

여러 신규 멤버십의 이벤트 페이로드입니다.

이벤트 유형: google.workspace.chat.membership.v1.batchCreated

필드

memberships[]

새 멤버십 목록입니다.

MembershipBatchDeletedEventData

삭제된 멤버십 여러 개의 이벤트 페이로드입니다.

이벤트 유형: google.workspace.chat.membership.v1.batchDeleted

필드

memberships[]

MembershipDeletedEventData

삭제된 멤버십 목록입니다.

MembershipBatchUpdatedEventData

업데이트된 여러 멤버십의 이벤트 페이로드입니다.

이벤트 유형: google.workspace.chat.membership.v1.batchUpdated

필드

memberships[]

MembershipUpdatedEventData

업데이트된 멤버십 목록입니다.

MembershipCreatedEventData

새 멤버십의 이벤트 페이로드입니다.

이벤트 유형: google.workspace.chat.membership.v1.created

필드

membership

새 멤버십입니다.

MembershipDeletedEventData

삭제된 멤버십의 이벤트 페이로드입니다.

이벤트 유형: google.workspace.chat.membership.v1.deleted

필드

membership

삭제된 멤버십입니다. name 및 state 필드만 채워집니다.

MembershipUpdatedEventData

업데이트된 멤버십의 이벤트 페이로드입니다.

이벤트 유형: google.workspace.chat.membership.v1.updated

필드

membership

MessageCreatedEventData

업데이트된 멤버십입니다.

메시지

Google Chat 스페이스의 메시지입니다.

필드
`name`	`string` 식별자. 메시지의 리소스 이름입니다. 형식: `spaces/{space}/messages/{message}` 여기서 `{space}`는 메시지가 게시된 스페이스의 ID이고 `{message}`는 메시지의 시스템 할당 ID입니다. 예를 들면 `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`입니다. 메시지를 만들 때 커스텀 ID를 설정하면 이 ID를 사용하여 `{message}`를 `clientAssignedMessageId` 필드의 값으로 대체하여 요청에서 메시지를 지정할 수 있습니다. 예를 들면 `spaces/AAAAAAAAAAA/messages/client-custom-name`입니다. 자세한 내용은 메시지 이름 지정을 참고하세요.
`sender`	`User` 출력 전용입니다. 메시지를 만든 사용자입니다. Chat 앱이 사용자로 인증하는 경우, 스페이스의 멤버이거나 호출 사용자와 채팅 메시지 (DM) 대화와 같은 이전 친밀도가 있는 경우가 아니면 내부 및 외부 사용자 모두에 대해 사용자 `name` 및 `type` 필드만 채웁니다.
`create_time`	`Timestamp` 선택사항입니다. 변경할 수 없습니다. Chat에서 만든 스페이스의 경우 메시지가 생성된 시간입니다. 이 필드는 가져오기 모드 스페이스에서 사용되는 경우를 제외하고 출력 전용입니다. 가져오기 모드 스페이스의 경우 원래 생성 시간을 보존하기 위해 이 필드를 소스에서 메시지가 생성된 이전 타임스탬프로 설정합니다.
`last_update_time`	`Timestamp` 출력 전용입니다. 사용자가 메시지를 마지막으로 수정한 시간입니다. 메시지가 수정된 적이 없으면 이 필드는 비어 있습니다.
`delete_time`	`Timestamp` 출력 전용입니다. Google Chat에서 메시지가 삭제된 시간입니다. 메시지가 삭제되지 않으면 이 필드는 비어 있습니다.
`text`	`string` 선택사항입니다. 메시지의 일반 텍스트 본문입니다. 이미지, 동영상 또는 웹페이지의 첫 번째 링크는 미리보기 칩을 생성합니다. Google Chat 사용자를 @멘션하거나 스페이스의 모든 사용자를 @멘션할 수도 있습니다. 문자 메시지를 만드는 방법을 알아보려면 메시지 보내기를 참고하세요.
`formatted_text`	`string` 출력 전용입니다. 형식을 전달하기 위해 마크업이 추가된 `text` 메시지를 포함합니다. 이 필드는 UI에 표시되는 모든 형식을 캡처하지는 않지만 다음을 포함합니다. 굵게, 기울임꼴, 취소선, 고정폭, 고정폭 블록, 글머리기호 목록, 블록 인용의 마크업 문법 `<users/{user}>` 형식을 사용하는 사용자 멘션 `<{url}\|{rendered_text}>` 형식을 사용하는 맞춤 하이퍼링크. 여기서 첫 번째 문자열은 URL이고 두 번째 문자열은 렌더링된 텍스트입니다(예: `<http://example.com\|custom text>`). `:{emoji_name}:` 형식을 사용하는 맞춤 그림 이모티콘(예: `:smile:`) 이는 유니코드 그림 이모티콘(예: 활짝 웃는 얼굴 그림 이모티콘의 경우 `U+1F600`)에는 적용되지 않습니다. 별표(``)를 사용하여 목록 항목에 글머리기호를 지정합니다(예: ` item`). 자세한 내용은 메시지로 전송된 텍스트 서식 보기를 참고하세요.
`cards[] (deprecated)`	`Card` 이 항목은 지원 중단되었습니다. 지원 중단됨: 대신 `cards_v2`를 사용하세요. 서식 있는 텍스트, 버튼, 클릭 가능한 이미지와 같은 UI 요소를 표시하는 데 사용할 수 있는 서식 있는 대화형 카드입니다. 카드는 일반적으로 메시지의 일반 텍스트 본문 아래에 표시됩니다. `cards` 및 `cards_v2`의 최대 크기는 32KB입니다.
`cards_v2[]`	`CardWithId` 선택사항입니다. 카드 배열입니다. 채팅 앱은 앱 인증을 사용하여 카드를 만들 수 있습니다. 개발자 프리뷰 프로그램의 일환으로 Chat 앱이 사용자로 인증하는 경우 카드 메시지를 만들 수 있습니다. Chat 앱이 개발자 프리뷰 프로그램에 속하지 않는 경우 사용자 인증이 있는 카드를 만들 수 없습니다. 카드가 포함된 메시지를 만드는 방법은 메시지 보내기를 참고하세요. 카드 빌더로 카드를 디자인하고 미리 봅니다. 카드 빌더 열기
`annotations[]`	`Annotation` 출력 전용입니다. 주석은 메시지의 일반 텍스트 본문 또는 `start_index` 및 `length`이 0인 Google Docs 또는 Sheets와 같은 Google Workspace 리소스에 연결되는 칩과 연결할 수 있습니다.
`thread`	`Thread` 메일이 속한 대화목록입니다. 사용 예시는 메시지 대화목록 시작 또는 답장을 참고하세요.
`space`	`Space` 출력 전용입니다. Chat 앱이 사용자로 인증하는 경우 출력은 스페이스 `name`만 채웁니다.
`fallback_text`	`string` 선택사항입니다. 실제 카드를 표시할 수 없는 경우(예: 모바일 알림)에 사용되는 메시지 카드의 일반 텍스트 설명입니다.
`action_response`	`ActionResponse` 입력 전용입니다. Chat 앱에서 응답 게시 방법을 구성하는 데 사용할 수 있는 매개변수입니다.
`argument_text`	`string` 출력 전용입니다. 모든 Chat 앱 언급이 삭제된 메시지의 일반 텍스트 본문입니다.
`slash_command`	`SlashCommand` 출력 전용입니다. 슬래시 명령어 정보(해당하는 경우)
`attachment[]`	`Attachment` 선택사항입니다. 사용자가 업로드한 첨부파일입니다.
`matched_url`	`MatchedUrl` 출력 전용입니다. 링크 미리보기 패턴과 일치하는 채팅 메시지 `text` 필드의 URL입니다. 자세한 내용은 미리보기 링크를 참고하세요.
`thread_reply`	`bool` 출력 전용입니다. `true`인 경우 메시지는 답장 대화목록의 응답입니다. `false`인 경우 메시지는 스페이스의 최상위 대화에 대화목록의 첫 번째 메시지 또는 대화목록 답장이 없는 메시지로 표시됩니다. 스페이스에서 대화목록 답장을 지원하지 않는 경우 이 필드는 항상 `false`입니다.
`silent`	`bool` 출력 전용입니다. 무음 메시지인지 여부입니다. 무음 메시지는 Chat에서 수신자에게 푸시 알림을 표시하지 않는 메시지입니다.
`client_assigned_message_id`	`string` 선택사항입니다. 메시지의 커스텀 ID입니다. 필드를 사용하여 메시지를 식별하거나 메시지를 가져오거나 삭제하거나 업데이트할 수 있습니다. 커스텀 ID를 설정하려면 메시지를 만들 때 `messageId` 필드를 지정합니다. 자세한 내용은 메시지 이름 지정을 참고하세요.
`emoji_reaction_summaries[]`	`EmojiReactionSummary` 출력 전용입니다. 메시지의 이모티콘 반응 요약 목록입니다.
`private_message_viewer`	`User` 선택사항입니다. 변경할 수 없습니다. 메시지를 만들기 위한 입력입니다. 그렇지 않으면 출력 전용입니다. 메시지를 볼 수 있는 사용자입니다. 설정하면 메시지가 비공개로 설정되며 지정된 사용자와 Chat 앱에만 표시됩니다. 요청에 이 필드를 포함하려면 앱 인증을 사용하여 Chat API를 호출하고 다음을 생략해야 합니다. 첨부파일 자세한 내용은 비공개 메시지 보내기를 참고하세요.
`deletion_metadata`	`DeletionMetadata` 출력 전용입니다. 삭제된 메시지에 관한 정보입니다. `delete_time`가 설정되면 메시지가 삭제됩니다.
`quoted_message_metadata`	`QuotedMessageMetadata` 선택사항입니다. 다른 메시지에서 인용하는 메시지에 관한 정보입니다. 메시지를 만들 때 동일한 대화목록 내의 메시지를 인용하거나 루트 메시지를 인용하여 새 루트 메시지를 만들 수 있습니다. 하지만 다른 대화목록의 메시지 답장은 인용할 수 없습니다. 메시지를 업데이트할 때 `quotedMessageMetadata` 필드를 추가하거나 바꿀 수는 없지만 삭제할 수는 있습니다. 사용 예시는 다른 메시지 인용을 참고하세요.
`attached_gifs[]`	`AttachedGif` 출력 전용입니다. 메일에 첨부된 GIF 이미지입니다.
`accessory_widgets[]`	`AccessoryWidget` 선택사항입니다. 메시지 하단에 표시되는 하나 이상의 대화형 위젯입니다. 텍스트, 카드 또는 텍스트와 카드가 모두 포함된 메시지에 액세서리 위젯을 추가할 수 있습니다. 대화가 포함된 메시지에는 지원되지 않습니다. 자세한 내용은 메시지 하단에 대화형 위젯 추가하기를 참고하세요. 액세서리 위젯이 있는 메시지를 만들려면 앱 인증이 필요합니다.
`elements`	`Elements` 선택사항입니다. 요소는 메시지 작성 중에 제공되는 추가 구성요소로, 메시지 텍스트의 특정 부분과 연결될 수도 있고 연결되지 않을 수도 있습니다. 이는 출력 전용이며 메시지 조각 또는 전체 메시지 텍스트와 관련된 보조 정보를 제공하는 주석과 다릅니다. 개발자 프리뷰: 특정 기능에 대한 사전 체험판을 제공하는 Google Workspace 개발자 프리뷰 프로그램의 일부로 제공됩니다.
`markup_syntax`	`MarkupSyntax` 선택사항입니다. 서버가 메시지 `text` 필드 콘텐츠를 해석하는 방법을 지정합니다.

MessageBatchCreatedEventData

여러 새 메시지의 이벤트 페이로드입니다.

이벤트 유형: google.workspace.chat.message.v1.batchCreated

필드

messages[]

새 메시지 목록입니다.

MessageBatchDeletedEventData

삭제된 여러 메시지의 이벤트 페이로드입니다.

이벤트 유형: google.workspace.chat.message.v1.batchDeleted

필드

messages[]

MessageDeletedEventData

삭제된 메시지 목록입니다.

MessageBatchUpdatedEventData

업데이트된 여러 메시지의 이벤트 페이로드입니다.

이벤트 유형: google.workspace.chat.message.v1.batchUpdated

필드

messages[]

MessageUpdatedEventData

업데이트된 메시지 목록입니다.

MessageCreatedEventData

새 메시지의 이벤트 페이로드입니다.

이벤트 유형: google.workspace.chat.message.v1.created

필드

message

새 메시지입니다.

MessageDeletedEventData

삭제된 메시지의 이벤트 페이로드입니다.

이벤트 유형: google.workspace.chat.message.v1.deleted

필드

message

삭제된 메시지입니다. name, createTime, deletionMetadata 필드만 채워집니다.

MessagePin

채팅 메시지의 고정 자세한 내용은 메시지 고정하기를 참고하세요.

필드

name

string

식별자. 메시지 고정의 리소스 이름입니다. 형식: spaces/{space}/messagePins/{message_pin} 리소스 ID 구성요소는 메시지의 리소스 ID 구성요소와 일치합니다. 예를 들어 spaces/AAA/messages/bbb.ccc가 있는 메시지는 리소스 이름이 spaces/AAA/messagePins/bbb.ccc인 메시지 고정에 해당합니다.

message

string

필수 항목입니다. 변경할 수 없습니다. 고정된 메시지의 리소스 이름입니다. 형식: spaces/{space}/messages/{message}

MessageUpdatedEventData

업데이트된 메시지의 이벤트 페이로드입니다.

이벤트 유형: google.workspace.chat.message.v1.updated

필드

message

업데이트된 메시지입니다.

MoveSectionItemRequest

섹션 간에 섹션 항목을 이동하기 위한 요청 메시지입니다.

필드

name

string

필수 항목입니다. 이동할 섹션 항목의 리소스 이름입니다.

형식: users/{user}/sections/{section}/items/{item}

target_section

string

필수 항목입니다. 섹션 항목을 이동할 섹션의 리소스 이름입니다.

형식: users/{user}/sections/{section}

MoveSectionItemResponse

섹션 항목 이동에 대한 응답 메시지입니다.

필드

section_item

SectionItem

업데이트된 섹션 항목입니다.

PositionSectionRequest

섹션 위치를 지정하는 요청 메시지입니다.

필드
`name`	`string` 필수 항목입니다. 위치를 지정할 섹션의 리소스 이름입니다. 형식: `users/{user}/sections/{section}`
통합 필드 `position`. 필수 항목입니다. 섹션의 새 위치입니다. `position`은 다음 중 하나여야 합니다.
`sort_order`	`int32` 선택사항입니다. 섹션 목록에서 섹션의 절대 위치입니다. 위치는 0보다 커야 합니다. 위치가 섹션 수보다 크면 섹션이 목록 끝에 추가됩니다. 이 작업은 지정된 위치에 섹션을 삽입하고 해당 위치의 원래 섹션과 그 아래의 섹션을 다음 위치로 이동합니다.
`relative_position`	`Position` 선택사항입니다. 섹션 목록에서 섹션의 상대적 위치입니다.

직위

섹션의 위치입니다.

열거형
`POSITION_UNSPECIFIED`	지정되지 않은 위치입니다.
`START`	섹션 목록의 시작입니다.
`END`	섹션 목록 끝

PositionSectionResponse

섹션 위치 지정에 대한 응답 메시지입니다.

필드

section

ReactionCreatedEventData

업데이트된 섹션입니다.

QuotedMessageMetadata

다른 메시지에서 인용하는 메시지에 관한 정보입니다.

메시지를 업데이트할 때 quotedMessageMetadata 필드를 추가하거나 바꿀 수는 없지만 삭제할 수는 있습니다.

사용 예시는 다른 메시지 인용을 참고하세요.

필드
`name`	`string` 필수 항목입니다. 인용된 메시지의 리소스 이름입니다. 형식: `spaces/{space}/messages/{message}`
`last_update_time`	`Timestamp` 필수 항목입니다. 인용된 메시지가 생성된 시점 또는 인용된 메시지가 마지막으로 업데이트된 시점의 타임스탬프입니다. 메시지가 수정된 경우 이 필드(`last_update_time`)를 사용합니다. 메시지가 수정되지 않은 경우 `create_time`를 사용합니다. `last_update_time`가 인용된 메시지의 최신 버전과 일치하지 않으면 요청이 실패합니다.
`quote_type`	`QuoteType` 선택사항입니다. 견적 유형을 지정합니다. 설정하지 않으면 이전 버전과의 호환성을 위해 메시지 읽기/쓰기 경로에서 REPLY가 기본값으로 사용됩니다.
`quoted_message_snapshot`	`QuotedMessageSnapshot` 출력 전용입니다. 인용된 메시지 콘텐츠의 스냅샷입니다.
`forwarded_metadata`	`ForwardedMetadata` 출력 전용입니다. 인용된 메시지의 소스 스페이스에 관한 메타데이터입니다. FORWARD 견적 유형에만 채워집니다.

QuoteType

인용된 메시지의 인용 유형입니다.

열거형

QUOTE_TYPE_UNSPECIFIED Reserved. 이 값은 사용되지 않습니다.

REPLY

quote_type가 REPLY인 경우 다음을 수행할 수 있습니다.

대화목록에서 답장하는 경우 해당 대화목록의 다른 메시지를 인용할 수 있습니다.
루트 메시지를 만드는 경우 해당 스페이스의 다른 루트 메시지를 인용할 수 있습니다.

FORWARD

quote_type이 FORWARD인 경우 다음을 인용할 수 있습니다.

다른 스페이스의 메시지입니다.
동일한 스페이스의 다른 대화목록에서 메시지 답장

QuotedMessageSnapshot

인용 또는 전달 시 인용된 메시지 내용의 스냅샷을 제공합니다.

필드
`sender`	`string` 출력 전용입니다. 인용된 메시지의 작성자 이름입니다. REPLY 및 FORWARD 인용 유형 모두에 채워집니다.
`text`	`string` 출력 전용입니다. 인용된 메시지의 텍스트 콘텐츠 스냅샷입니다.
`formatted_text`	`string` 출력 전용입니다. 하이퍼링크, 맞춤 그림 이모티콘, 마크업 등 서식 있는 텍스트를 지원하기 위해 마크업이 추가된 인용 메시지 `text`가 포함됩니다. FORWARD 인용 유형에만 채워집니다.
`annotations[]`	`Annotation` 출력 전용입니다. 인용된 메시지의 텍스트 본문에서 파싱된 주석입니다. FORWARD 견적 유형에만 채워집니다.
`attachments[]`	`Attachment` 출력 전용입니다. 인용된 메일에 포함된 첨부파일입니다. 인용된 메시지의 첨부파일 메타데이터 사본입니다. FORWARD 견적 유형에만 채워집니다.

반응

메시지에 대한 반응입니다.

필드

name

string

식별자. 반응의 리소스 이름입니다.

형식: spaces/{space}/messages/{message}/reactions/{reaction}

user

User

출력 전용입니다. 반응을 만든 사용자입니다.

emoji

Emoji

필수 항목입니다. 반응에 사용된 그림 이모티콘입니다.

ReactionBatchCreatedEventData

여러 개의 새로운 반응에 대한 이벤트 페이로드입니다.

이벤트 유형: google.workspace.chat.reaction.v1.batchCreated

필드

reactions[]

새로운 반응 목록입니다.

ReactionBatchDeletedEventData

삭제된 여러 반응의 이벤트 페이로드입니다.

이벤트 유형: google.workspace.chat.reaction.v1.batchDeleted

필드

reactions[]

ReactionDeletedEventData

삭제된 반응 목록입니다.

ReactionCreatedEventData

새 반응의 이벤트 페이로드입니다.

이벤트 유형: google.workspace.chat.reaction.v1.created

필드

reaction

새로운 반응입니다.

ReactionDeletedEventData

삭제된 반응의 이벤트 페이로드입니다.

유형: google.workspace.chat.reaction.v1.deleted

필드

reaction

삭제된 반응입니다.

ReplaceMessageCardsRequest

ReplaceMessageCards API 메서드의 요청 메시지입니다.

필드

name

string

필수 항목입니다. 메시지의 리소스 이름입니다.

형식: spaces/{space}/messages/{message}

cards_v2[]

CardWithId

선택사항입니다. 메시지에 포함할 카드 배열입니다. 이 카드는 메시지의 기존 카드를 대체합니다. 비어 있으면 메시지에 포함된 원본 카드가 삭제됩니다.

ReplaceMessageCardsResponse

이 유형에는 필드가 없습니다.

ReplaceMessageCards API의 응답 메시지입니다.

RichLinkMetadata

리소스에 대한 리치 링크입니다. 리치 링크는 메시지의 일반 텍스트 본문과 연결되거나 start_index 및 length가 0인 Google Docs 또는 Sheets와 같은 Google Workspace 리소스에 연결되는 칩을 나타낼 수 있습니다.

필드
`uri`	`string` 이 링크의 URI입니다.
`rich_link_type`	`RichLinkType` 리치 링크 유형입니다.
통합 필드 `data`. 연결된 리소스의 데이터입니다. `data`은 다음 중 하나여야 합니다.
`drive_link_data`	`DriveLinkData` Drive 링크의 데이터입니다.
`chat_space_link_data`	`ChatSpaceLinkData` Chat 스페이스 링크의 데이터입니다.
`meet_space_link_data`	`MeetSpaceLinkData` Meet 스페이스 링크의 데이터입니다.
`calendar_event_link_data`	`CalendarEventLinkData` 캘린더 일정 링크의 데이터입니다.

RichLinkType

리치 링크 유형입니다. 향후 더 많은 유형이 추가될 수 있습니다.

열거형
`RICH_LINK_TYPE_UNSPECIFIED`	enum의 기본값입니다. 사용하지 마세요.
`DRIVE_FILE`	Google Drive 리치 링크 유형입니다.
`CHAT_SPACE`	Chat 스페이스 리치 링크 유형입니다. 예를 들어 스페이스 스마트 칩이 있습니다.
`GMAIL_MESSAGE`	Gmail 메일 리치 링크 유형입니다. 구체적으로는 Chat에 공유의 Gmail 칩입니다. API는 GMAIL_MESSAGE 리치 링크가 있는 메시지 읽기만 지원합니다.
`MEET_SPACE`	Meet 메시지 리치 링크 유형입니다. 예를 들어 Meet 칩이 있습니다.
`CALENDAR_EVENT`	Calendar 메시지 리치 링크 유형입니다. 예를 들어 캘린더 칩이 있습니다.

SearchMessageResult

메시지 검색의 단일 결과 항목입니다.

필드

message

일치하는 메시지입니다.

space_mute_setting

MuteSetting

메시지가 게시된 스페이스의 호출 사용자의 음소거 설정입니다. 호출자 앱은 이 정보를 사용하여 사용자에 대해 스페이스가 숨겨져 있는지 여부에 따라 메시지를 처리하는 방법을 결정할 수 있습니다.

요청 뷰가 SEARCH_MESSAGES_VIEW_FULL이고 호출 사용자 인증 정보에 다음 승인 범위가 포함된 경우에만 반환됩니다.

https://www.googleapis.com/auth/chat.users.spacesettings

read

bool

호출 사용자가 일치하는 메시지를 읽었는지 여부를 나타냅니다.

요청 뷰가 SEARCH_MESSAGES_VIEW_FULL이고 호출 사용자 인증 정보에 다음 승인 범위 중 하나가 포함된 경우에만 반환됩니다.

https://www.googleapis.com/auth/chat.users.readstate.readonly
https://www.googleapis.com/auth/chat.users.readstate

SearchMessagesRequest

메시지 검색을 위한 요청 메시지입니다.

필드
`parent`	`string` 필수 항목입니다. 검색할 스페이스의 리소스 이름입니다. 사용자가 액세스할 수 있는 모든 스페이스를 검색하려면 이 필드를 `spaces/-`로 설정합니다. `parent`에 다른 값을 사용하면 `INVALID_ARGUMENT` 오류가 발생합니다. 검색을 하나 이상의 스페이스로 제한하려면 `filter`에서 `space.name` 또는 `space.display_name`를 사용합니다.
`filter`	`string` 필수 항목입니다. 검색어입니다. 쿼리는 결과를 필터링하는 데 사용되는 하나 이상의 검색 키워드를 지정할 수 있습니다. 다음 메시지 필드를 사용하여 결과를 필터링할 수도 있습니다. `create_time`: RFC-3339 형식의 타임스탬프를 허용하며 지원되는 비교 연산자는 `<` 및 `>=`입니다. `sender.name`: 발신자의 리소스 이름 (`users/{user}`)입니다. `=`만 지원합니다. 이 이메일을 `{user}`의 별칭으로 사용할 수 있습니다. 예를 들어 `users/example@gmail.com`입니다. 여기서 `example@gmail.com`은 Google Chat 사용자의 이메일입니다. `space.name`: 메시지가 게시된 스페이스의 리소스 이름입니다. (`spaces/{space}`). `=`만 지원합니다. 이 필터를 설정하지 않으면 사용자가 스페이스 회원으로서 액세스할 수 있는 모든 채팅 메시지와 스페이스에서 검색이 수행됩니다. `space.display_name`: `:` (포함) 연산자를 지원하며 표시 이름의 부분 일치를 기준으로 스페이스를 필터링합니다. 결과는 상위 5개 스페이스 일치 항목으로 제한됩니다. 예를 들어 `space.display_name:Project`은 표시 이름에 'Project'라는 단어가 포함된 상위 5개 스페이스의 메시지를 검색합니다. `space.space_type`: 스페이스의 유형입니다. `=`만 지원합니다. 예를 들어 `space.space_type="DIRECT_MESSAGE"`는 채팅 메시지만 반환합니다. 지정할 수 있는 값은 `DIRECT_MESSAGE`, `GROUP_CHAT`, `SPACE`입니다. `attachment`: 첨부파일이 있는지 확인하는 연산자 `:` (has any)를 지원합니다. `attachment:`를 지정하면 첨부파일이 하나 이상 있는 메일만 반환됩니다. `annotations.user_mentions.user.name`: 멘션된 사용자 (`users/{user}`)의 리소스 이름입니다. `:` (포함)만 지원합니다. 예를 들어 `annotations.user_mentions.user.name:"users/1234567890"`는 지정된 사용자에 대한 멘션이 포함된 메시지만 반환합니다. 또는 별칭 `me`을 사용하여 호출자 사용자를 언급하는 메시지를 필터링할 수 있습니다(예: `annotations.user_mentions.user.name:users/me`). 이메일을 `{user}`의 별칭으로 사용할 수도 있습니다(예: `users/example@gmail.com`). 고급 필터링의 경우 다음 함수도 사용할 수 있습니다. `has_link()`: 메시지 텍스트에 하이퍼링크가 하나 이상 있는 메시지만 반환합니다. `is_unread()`: 호출 사용자가 읽은 메시지를 필터링합니다. `space.display_name` 또는 `space.space_type` 필터를 사용하려면 호출 사용자 인증 정보에 다음 승인 범위 중 하나가 포함되어야 합니다. `https://www.googleapis.com/auth/chat.spaces.readonly` `https://www.googleapis.com/auth/chat.spaces` `is_unread()` 필터를 사용하려면 호출 사용자 인증 정보에 다음 승인 범위 중 하나가 포함되어야 합니다. `https://www.googleapis.com/auth/chat.users.readstate.readonly` `https://www.googleapis.com/auth/chat.users.readstate` 여러 필드에서 `AND` 연산자만 지원됩니다. 유효한 예시는 `sender.name = "users/1234567890" AND is_unread()`입니다. `AND` 단어는 선택사항이며 생략하면 암시됩니다. 예를 들어 `sender.name = "users/1234567890" is_unread()`는 유효하며 이전 예시와 동일합니다. `OR`는 서로 다른 필드 간에 지원되지 않으므로 `sender.name = "users/1234567890" OR is_unread()`는 잘못된 예시입니다. 동일한 필드 중: `create_time`는 `AND`만 지원하며 `create_time >= "2022-01-01T00:00:00+00:00" AND create_time < "2023-01-01T00:00:00+00:00"`와 같은 간격을 나타내는 데만 사용할 수 있습니다. `sender.name`는 `OR` 연산자만 지원합니다(예: `sender.name = "users/1234567890" OR sender.name = "users/0987654321"`). `space.name`는 `OR` 연산자만 지원합니다(예: `space.name = "spaces/ABCDEFGH" OR space.name = "spaces/QWERTYUI"`). `space.display_name`는 `AND` 및 `OR` 연산자를 지원하지만 두 연산자를 혼합하여 사용할 수는 없습니다. 예를 들어 `space.display_name:Project AND space.display_name:Tasks`는 표시 이름에 `Project`와 `Tasks`가 모두 포함된 스페이스의 메시지를 반환하는 반면, `space.display_name:Project OR space.display_name:Tasks`는 표시 이름에 `Project` 또는 `Tasks` 중 하나 또는 둘 다 포함된 스페이스의 메시지를 반환합니다. `space.space_type`는 `OR` 연산자만 지원합니다(예: `space.space_type = "DIRECT_MESSAGE" OR space.space_type = "GROUP_CHAT"`). `annotations.user_mentions.user.name`는 `AND` 및 `OR` 연산자를 지원하지만 두 연산자를 혼합하여 사용할 수는 없습니다. 예를 들어 `annotations.user_mentions.user.name:"users/1234567890" AND annotations.user_mentions.user.name:"users/0987654321"`는 두 사용자를 모두 멘션하는 메시지만 반환하는 반면 `annotations.user_mentions.user.name:"users/1234567890" OR annotations.user_mentions.user.name:"users/0987654321"`는 두 사용자 중 한 명 또는 둘 다를 멘션하는 메시지를 반환합니다. 동일한 쿼리에서 `AND` 및 `OR` 연산자를 결합할 때 연산자 우선순위를 명확히 하려면 괄호가 필요합니다. 예를 들면 `(sender.name="users/me" OR sender.name="users/123456") AND is_unread()`입니다. 그 외의 경우에는 괄호가 선택사항입니다. 다음 쿼리 예시는 유효합니다. `"Pending reports" AND create_time >= "2023-01-01T00:00:00Z" sender.name = "users/example@gmail.com" annotations.user_mentions.user.name:"users/0987654321" attachment:* AND space.name = "spaces/ABCDEFGH" tasks AND is_unread() AND sender.name = "users/1234567890" "things to do" "urgent" (sender.name = "users/1234567890") AND (create_time < "2023-05-01T00:00:00Z") tasks AND space.name = "spaces/ABCDEFGH" AND has_link() "project one" is_unread() space.display_name:Project tasks` 최대 쿼리 길이는 1,000자(영문 기준)입니다. 잘못된 쿼리는 서버에서 `INVALID_ARGUMENT` 오류와 함께 거부됩니다.
`page_size`	`int32` 선택사항입니다. 반환할 최대 결과 수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 지정하지 않으면 최대 25개가 반환됩니다. 최댓값은 100입니다. 100을 초과하는 값을 사용하면 자동으로 100으로 변경됩니다.
`page_token`	`string` 선택사항입니다. 이전 검색 메시지 호출에서 수신된 토큰입니다. 후속 페이지를 검색하려면 이 매개변수를 제공합니다. 페이지로 나누는 경우 제공된 다른 모든 매개변수가 페이지 토큰을 제공한 호출과 일치해야 합니다. 다른 매개변수에 다른 값을 전달하면 예기치 않은 결과가 발생할 수 있습니다.
`order_by`	`string` 선택사항입니다. 결과 목록이 정렬되는 방식입니다. 정렬 기준으로 지원되는 속성은 다음과 같습니다. `create_time`: 메시지 생성 시간을 기준으로 결과를 정렬합니다. 기본값 `relevance`: 관련성을 기준으로 결과를 정렬합니다. ( 개발자 프리뷰) 기본 순서는 `create_time desc`입니다. 쿼리당 하나의 순서 (`create_time` 또는 `relevance`)만 지원됩니다. 내림차순 (`desc`)만 지원되며 순서 속성 뒤에 지정해야 합니다.
`markup_syntax`	`MarkupSyntax` 선택사항입니다. 채팅 메시지 `formatted_text` 필드에 원하는 출력 문법을 지정합니다.
`view`	`SearchMessagesView` 선택사항입니다. 반환할 검색 결과 뷰의 종류를 지정합니다. 기본값은 `SEARCH_MESSAGES_VIEW_BASIC`입니다.

SearchMessagesView

부분 검색 결과에 지원되는 뷰 종류입니다.

열거형
`SEARCH_MESSAGES_VIEW_UNSPECIFIED`	기본값 / 설정되지 않은 값입니다. API는 BASIC 뷰로 기본 설정됩니다.
`SEARCH_MESSAGES_VIEW_BASIC`	결과에 일치하는 메시지만 포함되고 추가 메타데이터는 포함되지 않습니다. 기본값입니다.
`SEARCH_MESSAGES_VIEW_FULL`	일치하는 메시지와 추가 메타데이터 등 결과의 모든 항목이 포함됩니다.

SearchMessagesResponse

메시지 검색에 대한 응답 메시지입니다.

필드

results[]

SearchMessageResult

쿼리와 일치하는 검색 결과 목록입니다.

next_page_token

string

다음 페이지를 가져오는 데 사용할 수 있는 토큰입니다. 이 필드가 비어 있으면 후속 페이지가 표시되지 않습니다.

SearchSpacesRequest

쿼리를 기반으로 스페이스 목록을 검색하는 요청입니다.

필드
`use_admin_access`	`bool` `true`인 경우 이 메서드는 사용자의 Google Workspace 관리자 권한을 사용하여 실행됩니다. 호출하는 사용자는 채팅 및 스페이스 대화 관리 권한이 있는 Google Workspace 관리자여야 합니다. `chat.admin.spaces.readonly` 또는 `chat.admin.spaces` OAuth 2.0 범위가 필요합니다.
`page_size`	`int32` 반환할 최대 스페이스 수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 지정하지 않으면 최대 100개의 스페이스가 반환됩니다. `useAdminAccess`가 `true`로 설정된 경우 최댓값은 1,000입니다. 그렇지 않으면 최댓값은 100입니다. 최댓값을 초과하는 값을 사용하면 자동으로 최댓값으로 변경됩니다.
`page_token`	`string` 이전 검색 공간 호출에서 수신된 토큰입니다. 후속 페이지를 검색하려면 이 매개변수를 제공합니다. 페이지로 나누는 경우 제공된 다른 모든 매개변수가 페이지 토큰을 제공한 호출과 일치해야 합니다. 다른 매개변수에 다른 값을 전달하면 예기치 않은 결과가 발생할 수 있습니다.
`query`	`string` 필수 항목입니다. 검색어입니다. `useAdminAccess`가 `true`로 설정된 경우 다음 매개변수를 사용하여 검색할 수 있습니다. `create_time` `customer` `display_name` `external_user_allowed` `last_active_time` `space_history_state` `space_type` `useAdminAccess`가 `false`로 설정된 경우: `display_name` `external_user_allowed` `space_type` `create_time` 및 `last_active_time`는 RFC-3339 형식의 타임스탬프를 허용하며 지원되는 비교 연산자는 `=`, `<`, `>`, `<=`, `>=`입니다. `customer`는 `useAdminAccess`가 `true`로 설정된 경우에 필요하며, 스페이스를 가져올 고객을 나타내는 데 사용됩니다. 유일하게 지원되는 값은 `customers/my_customer`입니다. `display_name`은 `HAS` (`:`) 연산자만 허용합니다. 일치시킬 텍스트는 먼저 토큰으로 토큰화되고 각 토큰은 스페이스의 `display_name` 내에서 하위 문자열로 대소문자를 구분하지 않고 독립적으로 프리픽스 일치됩니다. 예를 들어 `Fun Eve`는 `Fun event` 또는 `The evening was fun`과 일치하지만 `notFun event` 또는 `even`과는 일치하지 않습니다. `useAdminAccess`가 `false`로 설정된 경우 의미 있는 결과를 검색하려면 `display_name`가 필요합니다. 그렇지 않으면 기본 동작은 빈 응답을 반환하는 것입니다. `external_user_allowed`는 `true` 또는 `false`를 허용합니다. `space_history_state`은 `space` 리소스의 `historyState` 필드 값만 허용합니다. `space_type`는 필수이며 유일하게 유효한 값은 `SPACE`입니다. 여러 필드에서 `AND` 연산자만 지원됩니다. 유효한 예는 `space_type = "SPACE" AND display_name:"Hello"`이고 잘못된 예는 `space_type = "SPACE" OR display_name:"Hello"`입니다. 동일한 필드에서 `space_type`는 `AND` 또는 `OR` 연산자를 지원하지 않습니다. `display_name`, 'space_history_state', 'external_user_allowed'는 `OR` 연산자만 지원합니다. `last_active_time` 및 `create_time`는 `AND` 및 `OR` 연산자를 모두 지원합니다. `AND`는 `last_active_time < "2022-01-01T00:00:00+00:00" AND last_active_time > "2023-01-01T00:00:00+00:00"`와 같은 간격을 나타내는 데만 사용할 수 있습니다. 다음 예시 쿼리는 `useAdminAccess`가 `true`로 설정된 경우에 유효합니다. customer = "customers/my_customer" AND space_type = "SPACE" customer = "customers/my_customer" AND space_type = "SPACE" AND display_name:"Hello World" customer = "customers/my_customer" AND space_type = "SPACE" AND (last_active_time < "2020-01-01T00:00:00+00:00" OR last_active_time > "2022-01-01T00:00:00+00:00") customer = "customers/my_customer" AND space_type = "SPACE" AND (display_name:"Hello World" OR display_name:"Fun event") AND (last_active_time > "2020-01-01T00:00:00+00:00" AND last_active_time < "2022-01-01T00:00:00+00:00") customer = "customers/my_customer" AND space_type = "SPACE" AND (create_time > "2019-01-01T00:00:00+00:00" AND create_time < "2020-01-01T00:00:00+00:00") AND (external_user_allowed = "true") AND (space_history_state = "HISTORY_ON" OR space_history_state = "HISTORY_OFF") 다음 예시 쿼리는 `useAdminAccess`가 `false`로 설정된 경우에 유효합니다. `display_name:"Hello World" AND space_type = "SPACE" (display_name:"Hello" OR display_name:"Fun") AND space_type = "SPACE" (external_user_allowed = "true" AND space_type = "SPACE") // Returns an empty response. (external_user_allowed = "true" AND display_name:"Hello" AND space_type = "SPACE")` 최대 쿼리 길이는 1,000자(영문 기준)입니다. 잘못된 쿼리는 서버에서 `INVALID_ARGUMENT` 오류와 함께 거부됩니다.
`order_by`	`string` 선택사항입니다. 스페이스 목록이 정렬되는 방식입니다. 정렬 기준으로 지원되는 속성은 다음과 같습니다. `membership_count.joined_direct_human_user_count`: 스페이스에 직접 참여한 사용자 수를 나타냅니다. `last_active_time` — 이 스페이스의 주제에 마지막으로 적격한 항목이 추가된 시간을 나타냅니다. `create_time` — 스페이스가 생성된 시간을 나타냅니다. `useAdminAccess`가 `false`인 경우 `create_time` 및 `relevance`만 정렬에 지원됩니다. 관리자가 아닌 검색에서는 이러한 필드에 `DESC`만 지원됩니다. 유효한 순서 지정 작업 값은 다음과 같습니다. 오름차순의 경우 `ASC` 기본값 내림차순의 경우 `DESC` 지원되는 문법은 `useAdminAccess`이 `true`로 설정된 경우입니다. `membership_count.joined_direct_human_user_count DESC` `membership_count.joined_direct_human_user_count ASC` `last_active_time DESC` `last_active_time ASC` `create_time DESC` `create_time ASC` `useAdminAccess`가 `false`로 설정된 경우: `create_time DESC` `relevance DESC` ( 개발자 프리뷰)

SearchSpacesResponse

스페이스 검색 요청에 해당하는 스페이스 목록이 포함된 응답입니다.

필드
`spaces[] (deprecated)`	`Space` 이 항목은 지원 중단되었습니다. 지원 중단됨: 대신 새 `results` 필드를 사용하세요. 요청된 스페이스의 페이지입니다. 이 필드는 `useAdminAccess`가 `true`로 설정된 경우에만 채워지며 새로운 `results` 필드로 인해 지원 중단됩니다.
`next_page_token`	`string` 다음 페이지를 가져오는 데 사용할 수 있는 토큰입니다. 이 필드가 비어 있으면 후속 페이지가 표시되지 않습니다. `useAdminAccess`가 `true`로 설정된 경우에만 채워집니다.
`total_size`	`int32` 모든 페이지에서 쿼리와 일치하는 총 스페이스 수입니다. 결과가 10,000개를 초과하는 경우 이 값은 추정치입니다. `useAdminAccess`가 `true`로 설정된 경우에만 채워집니다.
`results[]`	`SearchSpaceResult` 출력 전용입니다. 쿼리와 일치하는 검색 결과 목록입니다.

SearchSpaceResult

스페이스 검색의 단일 결과 항목입니다.

필드

space

출력 전용입니다. 일치하는 스페이스입니다.

섹션

Google Chat의 섹션을 나타냅니다. 섹션은 사용자가 스페이스를 정리하는 데 도움이 됩니다. 섹션에는 두 가지 유형이 있습니다.

시스템 섹션: Google Chat에서 관리하는 사전 정의된 섹션입니다. 리소스 이름은 고정되어 있으며, 만들거나 삭제하거나 display_name를 수정할 수 없습니다. 예를 들면 다음과 같습니다.
- users/{user}/sections/default-direct-messages
- users/{user}/sections/default-spaces
- users/{user}/sections/default-apps
맞춤 섹션: 사용자가 만들고 관리하는 섹션입니다. CreateSection를 사용하여 맞춤 섹션을 만들려면 display_name가 필요합니다. 맞춤 섹션은 UpdateSection를 사용하여 업데이트하고 DeleteSection를 사용하여 삭제할 수 있습니다.

필드
`name`	`string` 식별자. 섹션의 리소스 이름입니다. 시스템 섹션의 경우 섹션 ID는 상수 문자열입니다. DEFAULT_DIRECT_MESSAGES: `users/{user}/sections/default-direct-messages` DEFAULT_SPACES: `users/{user}/sections/default-spaces` DEFAULT_APPS: `users/{user}/sections/default-apps` 형식: `users/{user}/sections/{section}`
`display_name`	`string` 선택사항입니다. 섹션의 표시 이름입니다. `CUSTOM_SECTION` 유형의 섹션에만 채워집니다. 최대 80자(영문 기준)까지 지원됩니다. `CUSTOM_SECTION`를 만들 때 필요합니다.
`sort_order`	`int32` 출력 전용입니다. 다른 섹션과 관련된 섹션의 순서입니다. `sort_order` 값이 낮은 섹션이 값이 높은 섹션보다 먼저 표시됩니다.
`type`	`SectionType` 필수 항목입니다. 섹션의 유형입니다.

SectionType

섹션 유형입니다.

열거형
`SECTION_TYPE_UNSPECIFIED`	지정되지 않은 섹션 유형입니다.
`CUSTOM_SECTION`	맞춤 섹션
`DEFAULT_DIRECT_MESSAGES`	두 사용자 간의 DIRECT_MESSAGE 또는 맞춤 섹션에 속하지 않는 GROUP_CHAT 스페이스가 포함된 기본 섹션입니다.
`DEFAULT_SPACES`	맞춤 섹션에 속하지 않는 기본 스페이스입니다.
`DEFAULT_APPS`	사용자가 설치한 앱이 포함된 기본 섹션입니다.

SectionItem

사용자가 정의한 섹션 항목입니다. 섹션 아래에 그룹화된 섹션 항목(예: 스페이스)을 나타내는 데 사용됩니다.

필드

name

string

식별자. 섹션 항목의 리소스 이름입니다.

형식: users/{user}/sections/{section}/items/{item}

통합 필드 item. 필수 항목입니다. 섹션 항목입니다. item은 다음 중 하나여야 합니다.

space

string

선택사항입니다. 스페이스 리소스 이름입니다.

형식: spaces/{space}

SetUpSpaceRequest

스페이스를 만들고 지정된 사용자를 추가하도록 요청합니다.

필드

space

필수 항목입니다. Space.spaceType 필드는 필수 입력란입니다.

스페이스를 만들려면 Space.spaceType를 SPACE로 설정하고 Space.displayName를 설정합니다. 스페이스를 설정할 때 ALREADY_EXISTS 오류 메시지가 표시되면 다른 displayName를 사용해 보세요. Google Workspace 조직 내의 기존 스페이스에서 이미 이 표시 이름을 사용하고 있을 수 있습니다.

그룹 채팅을 만들려면 Space.spaceType를 GROUP_CHAT로 설정합니다. Space.displayName 설정 안 함

사람 간의 1:1 대화를 만들려면 Space.spaceType를 DIRECT_MESSAGE로 설정하고 Space.singleUserBotDm를 false로 설정합니다. Space.displayName 또는 Space.spaceDetails를 설정하지 않습니다.

사용자와 호출하는 Chat 앱 간에 1:1 대화를 만들려면 Space.spaceType를 DIRECT_MESSAGE로, Space.singleUserBotDm를 true로 설정합니다. Space.displayName 또는 Space.spaceDetails를 설정하지 않습니다.

DIRECT_MESSAGE 스페이스가 이미 있으면 새 스페이스를 만드는 대신 해당 스페이스가 반환됩니다.

request_id

string

이 필드를 효과적으로 사용하려면 다음 안내를 따르세요.

후속 요청이 원래 요청과 동일하고 동일한 사용자 인증 정보를 사용하는지 확인합니다.
제공된 요청 ID로 스페이스가 이미 생성된 경우 요청은 해당 스페이스를 반환합니다. 반환된 스페이스가 완전히 채워지지 않을 수 있습니다. API는 시스템에서 할당한 리소스 이름이 채워진 요청의 스페이스를 에코합니다. 스페이스의 최신 메타데이터를 가져오려면 GetSpace를 호출합니다.
인증된 다른 사용자와 함께 기존 요청 ID를 재사용하면 오류가 발생합니다.

memberships[]

AccessPermissionSetting

선택사항입니다. 스페이스에 참여하도록 초대할 Google Chat 사용자 또는 그룹입니다. 호출 사용자는 자동으로 추가되므로 생략합니다.

이 세트는 현재 최대 49명의 멤버십을 허용합니다 (호출자 제외).

사람 멤버십의 경우 Membership.member 필드에 name가 채워진 user (형식: users/{user})가 포함되어야 하며 type는 User.Type.HUMAN로 설정되어야 합니다. 스페이스를 설정할 때는 사람 사용자만 추가할 수 있습니다 (Chat 앱 추가는 통화 앱과의 채팅 메시지 설정에서만 지원됨). 사용자의 이메일을 {user}의 별칭으로 사용하여 회원을 추가할 수도 있습니다. 예를 들어 user.name는 users/example@gmail.com일 수 있습니다. Gmail 사용자 또는 외부 Google Workspace 도메인의 사용자를 초대하려면 사용자의 이메일을 {user}에 사용해야 합니다.

Google 그룹스 멤버십의 경우 Membership.group_member 필드에 name가 채워진 group가 포함되어야 합니다 (형식 groups/{group}). Space.spaceType를 SPACE로 설정할 때만 Google 그룹스를 추가할 수 있습니다.

Space.spaceType을 SPACE로 설정하는 경우 선택사항입니다.

Space.spaceType를 GROUP_CHAT로 설정할 때 최소 2개의 멤버십과 함께 필요합니다.

Space.spaceType를 사람 사용자와 함께 DIRECT_MESSAGE로 설정할 때 정확히 하나의 멤버십과 함께 필요합니다.

사용자와 호출하는 Chat 앱 간에 1:1 대화를 만들 때 (Space.spaceType를 DIRECT_MESSAGE로, Space.singleUserBotDm를 true로 설정할 때) 비어 있어야 합니다.

SlashCommand

Google Chat의 슬래시 명령어에 관한 메타데이터입니다.

필드

command_id

int64

슬래시 명령어의 ID입니다.

SlashCommandMetadata

슬래시 명령어 (/)의 주석 메타데이터입니다.

필드
`bot`	`User` 명령어가 호출된 Chat 앱입니다.
`type`	`Type` 슬래시 명령어 유형입니다.
`command_name`	`string` 호출된 슬래시 명령어의 이름입니다.
`command_id`	`int64` 호출된 슬래시 명령어의 명령어 ID입니다.
`triggers_dialog`	`bool` 슬래시 명령어가 대화상자용인지 여부를 나타냅니다.

유형

열거형
`TYPE_UNSPECIFIED`	enum의 기본값입니다. 사용하지 마세요.
`ADD`	스페이스에 Chat 앱을 추가합니다.
`INVOKE`	스페이스에서 슬래시 명령어를 호출합니다.

우주

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

필드
`name`	`string` 식별자. 스페이스의 리소스 이름입니다. 형식: `spaces/{space}` 여기서 `{space}`는 스페이스에 대해 시스템에서 할당된 ID를 나타냅니다. `spaces.list()` 메서드를 호출하거나 스페이스 URL에서 스페이스 ID를 가져올 수 있습니다. 예를 들어 스페이스 URL이 `https://mail.google.com/mail/u/0/#chat/space/AAAAAAAAA`인 경우 스페이스 ID는 `AAAAAAAAA`입니다.
`type (deprecated)`	`Type` 이 항목은 지원 중단되었습니다. 출력 전용입니다. 지원 중단됨: 대신 `space_type`를 사용하세요. 스페이스 유형입니다.
`space_type`	`SpaceType` 선택사항입니다. 스페이스 유형입니다. 스페이스를 만들거나 스페이스의 스페이스 유형을 업데이트할 때 필요합니다. 다른 용도의 경우 출력 전용입니다.
`single_user_bot_dm`	`bool` 선택사항입니다. 스페이스가 Chat 앱과 한 명의 사용자 간의 채팅 메시지인지 여부입니다.
`threaded (deprecated)`	`bool` 이 항목은 지원 중단되었습니다. 출력 전용입니다. 지원 중단됨: 대신 `spaceThreadingState`를 사용하세요. 이 스페이스에서 메시지가 대화목록 형식인지 여부입니다.
`display_name`	`string` 선택사항입니다. 스페이스의 표시 이름입니다. `spaceType`가 `SPACE`인 스페이스를 만들 때 필요합니다. 스페이스를 만들거나 `displayName`를 업데이트할 때 `ALREADY_EXISTS` 오류 메시지가 표시되면 다른 `displayName`를 사용해 보세요. Google Workspace 조직 내의 기존 스페이스에서 이미 이 표시 이름을 사용하고 있을 수 있습니다. 채팅 메시지의 경우 이 필드가 비어 있을 수 있습니다. 최대 128자(영문 기준)까지 지원합니다.
`external_user_allowed`	`bool` 선택사항입니다. 변경할 수 없습니다. 이 스페이스에서 모든 Google Chat 사용자를 멤버로 허용하는지 여부입니다. Google Workspace 조직에서 스페이스를 만들 때 입력합니다. 다음 조건에서 스페이스를 만들 때는 이 필드를 생략합니다. 인증된 사용자가 일반 계정 (비관리 사용자 계정)을 사용합니다. 기본적으로 일반 계정으로 만든 스페이스는 모든 Google Chat 사용자를 허용합니다. 기존 스페이스의 경우 이 필드는 출력 전용입니다.
`space_threading_state`	`SpaceThreadingState` 출력 전용입니다. Chat 스페이스의 대화목록 상태입니다.
`space_details`	`SpaceDetails` 선택사항입니다. 설명 및 규칙을 포함한 스페이스에 관한 세부정보입니다.
`space_history_state`	`HistoryState` 선택사항입니다. 이 스페이스에 있는 메시지 및 대화목록의 메시지 기록 상태입니다.
`import_mode`	`bool` 선택사항입니다. 이 스페이스가 Google Workspace로의 데이터 이전의 일환으로 `Import Mode`에서 생성되었는지 여부입니다. 스페이스를 가져오는 동안에는 가져오기가 완료될 때까지 사용자에게 표시되지 않습니다. `Import Mode`에서 스페이스를 만들려면 사용자 인증이 필요합니다.
`create_time`	`Timestamp` 선택사항입니다. 변경할 수 없습니다. Chat에서 생성된 스페이스의 경우 스페이스가 생성된 시간입니다. 이 필드는 가져오기 모드 스페이스에서 사용되는 경우를 제외하고 출력 전용입니다. 가져오기 모드 스페이스의 경우 원래 생성 시간을 보존하기 위해 이 필드를 소스에서 스페이스가 생성된 이전 타임스탬프로 설정합니다. `spaceType`가 `GROUP_CHAT` 또는 `SPACE`인 경우에만 출력에 채워집니다.
`last_active_time`	`Timestamp` 출력 전용입니다. 스페이스에 있는 마지막 메시지의 타임스탬프입니다.
`admin_installed`	`bool` 출력 전용입니다. Chat 앱이 있는 채팅 메시지 (DM) 스페이스의 경우 Google Workspace 관리자가 스페이스를 만들었는지 여부 관리자는 조직의 사용자를 대신하여 Chat 앱을 설치하고 채팅 메시지를 설정할 수 있습니다. 관리자 설치를 지원하려면 Chat 앱에 채팅 메시지 기능이 있어야 합니다.
`membership_count`	`MembershipCount` 출력 전용입니다. 가입한 멤버십 수를 회원 유형별로 그룹화한 값입니다. `space_type`가 `SPACE`, `DIRECT_MESSAGE` 또는 `GROUP_CHAT`인 경우 채워집니다.
`access_settings`	`AccessSettings` 선택사항입니다. 스페이스의 액세스 설정을 지정합니다. `space_type`가 `SPACE`인 경우에만 채워집니다.
`space_uri`	`string` 출력 전용입니다. 사용자가 스페이스에 액세스하기 위한 URI입니다.
`import_mode_expire_time`	`Timestamp` 출력 전용입니다. 스페이스가 가져오기 모드로 유지되는 경우 시스템에서 자동으로 삭제되는 시간입니다. 가져오기 모드에서 생성된 각 스페이스는 만료 시간 전에 `spaces.completeImport`를 사용하여 이 모드를 종료해야 합니다. 이 필드는 가져오기 모드로 생성된 스페이스에만 채워집니다.
`customer`	`string` 선택사항입니다. 변경할 수 없습니다. 스페이스 도메인의 고객 ID입니다. 앱 인증을 사용하여 스페이스를 만들고 `SpaceType`가 `SPACE`인 경우에만 필요하며, 그렇지 않으면 설정해서는 안 됩니다. `customers/{customer}` 형식입니다. 여기서 `customer`는 Admin SDK 고객 리소스의 `id`입니다. 비공개 앱은 `customers/my_customer` 별칭을 사용하여 앱과 동일한 Google Workspace 조직에 스페이스를 만들 수도 있습니다. 이 입력란은 채팅 메시지 (DM) 또는 Google Workspace 사용자가 아닌 사용자가 스페이스를 만든 경우에는 채워지지 않습니다.
통합 필드 `space_permission_settings`. 스페이스의 권한 설정을 나타냅니다. `space_type`가 `SPACE`인 경우에만 채워집니다. `space_permission_settings`은 다음 중 하나여야 합니다.
`predefined_permission_settings`	`PredefinedPermissionSettings` 선택사항입니다. 입력 전용입니다. 사전 정의된 스페이스 권한 설정으로, 스페이스를 만들 때만 입력합니다. 필드가 설정되지 않으면 공동작업 공간이 생성됩니다. 스페이스를 만들면 설정이 `PermissionSettings` 필드에 채워집니다. 사전 정의된 권한 설정을 지정하면 다음이 지원됩니다. `chat.app.spaces` 또는 `chat.app.spaces.create` 범위의 관리자 승인을 통한 앱 인증 사용자 인증
`permission_settings`	`PermissionSettings` 선택사항입니다. 기존 스페이스의 스페이스 권한 설정 정확한 스페이스 권한 설정을 업데이트하기 위한 입력으로, 기존 권한 설정이 대체됩니다. 출력에 현재 권한 설정이 표시됩니다. 권한 설정 읽기 및 업데이트는 다음을 지원합니다. `chat.app.spaces` 범위의 관리자 승인을 통한 앱 인증 Chat 앱에서 스페이스를 만든 경우에만 채워지고 설정할 수 있습니다. 사용자 인증

AccessPermissionSetting

액세스 권한 설정입니다.

필드

principals[]

Principal

선택사항입니다. 순서가 지정되지 않은 목록 이 권한에 허용되는 주 구성원입니다.

AccessPermissionSettings

스페이스의 액세스 권한 설정

필드

discover_space_setting

선택사항입니다. 스페이스를 검색하기 위한 액세스 권한 설정입니다.

join_space_setting

AccessPermissionSetting

선택사항입니다. 스페이스 참여를 위한 액세스 권한 설정입니다.

view_space_membership_setting

AccessPermissionSetting

선택사항입니다. 스페이스 멤버십을 보기 위한 액세스 권한 설정입니다. 스페이스 멤버십을 볼 수 있는 사용자를 업데이트할 때 업데이트 마스크 및 요청 본문에 PermissionSettings.view_space_membership와 함께 지정해야 합니다. 타겟 잠재고객에게 보기 권한을 부여할 때는 동일한 요청에서 모든 구성원에게 PermissionSettings.view_space_membership도 부여해야 합니다. 기존 공유 대상 그룹을 삭제하려면 (예: 스페이스 관리자 또는 부관리자로만 보기 액세스 권한을 제한하려면) 빈 AccessPermissionSetting (principals 없음)를 지정합니다.

AccessSettings

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

필드

access_state

AccessState

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

audience

string

선택사항입니다. 스페이스를 검색하고, 스페이스에 참여하고, 스페이스의 메시지를 미리 볼 수 있는 타겟층의 리소스 이름입니다. 설정하지 않으면 스페이스에 개별적으로 초대되거나 추가된 사용자 또는 Google 그룹만 스페이스에 액세스할 수 있습니다. 자세한 내용은 공유 대상 그룹이 스페이스를 검색할 수 있도록 설정하기를 참고하세요.

형식: audiences/{audience}

Google Workspace 조직의 기본 공유 대상 그룹을 사용하려면 audiences/default로 설정합니다.

타겟층 지원 읽기:

사용자 인증
chat.app.spaces 범위의 관리자 승인을 통한 앱 인증

앱 인증과 함께 chat.bot 범위를 사용하는 경우 이 필드는 채워지지 않습니다.

공유 타겟층을 설정하려면 사용자 인증이 필요합니다.

access_permission_settings

AccessPermissionSettings

선택사항입니다. 스페이스의 액세스 권한 설정

스페이스를 만들 때 타겟 잠재고객을 설정하려면 요청에 accessSettings.audience 필드를 지정합니다.

AccessState

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

열거형

ACCESS_STATE_UNSPECIFIED 액세스 상태를 알 수 없거나 이 API에서 지원되지 않습니다.

PRIVATE 다른 사용자 또는 Google Workspace 관리자가 개별적으로 추가하거나 초대한 사용자 또는 Google 그룹만 스페이스를 검색하고 액세스할 수 있습니다.

DISCOVERABLE

스페이스 관리자가 특정 공유 대상 그룹에게 스페이스에 대한 액세스 권한을 부여했습니다. 스페이스에 개별적으로 추가되거나 초대된 사용자 또는 Google 그룹도 스페이스를 검색하고 액세스할 수 있습니다. 자세한 내용은 특정 사용자가 스페이스를 검색할 수 있도록 설정하기를 참고하세요.

검색 가능한 스페이스를 만들려면 사용자 인증이 필요합니다.

MembershipCount

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

필드

joined_direct_human_user_count

int32

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

joined_group_count

int32

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

PermissionSetting

스페이스 권한 설정을 나타냅니다.

필드

managers_allowed

bool

선택사항입니다. 스페이스 소유자 (ROLE_MANAGER)에게 이 권한이 있는지 여부입니다.

members_allowed

bool

선택사항입니다. 기본 스페이스 멤버 (ROLE_MEMBER)에게 이 권한이 있는지 여부입니다.

assistant_managers_allowed

bool

선택사항입니다. 스페이스 관리자(ROLE_ASSISTANT_MANAGER)에게 이 권한이 있는지 여부입니다.

PermissionSettings

기존 이름이 지정된 스페이스를 업데이트할 때 지정할 수 있는 권한 설정입니다.

스페이스를 만들 때 권한 설정을 지정하려면 요청에 PredefinedPermissionSettings 필드를 지정합니다.

필드
`manage_members_and_groups`	`PermissionSetting` 선택사항입니다. 스페이스에서 멤버 및 그룹을 관리하기 위한 설정입니다.
`modify_space_details`	`PermissionSetting` 선택사항입니다. 스페이스 이름, 아바타, 설명, 가이드라인을 업데이트하는 설정입니다.
`toggle_history`	`PermissionSetting` 선택사항입니다. 스페이스 기록을 사용 설정하거나 사용 중지하는 설정입니다.
`use_at_mention_all`	`PermissionSetting` 선택사항입니다. 스페이스에서 @all을 사용하기 위한 설정입니다.
`manage_apps`	`PermissionSetting` 선택사항입니다. 스페이스에서 앱을 관리하는 설정입니다.
`manage_webhooks`	`PermissionSetting` 선택사항입니다. 스페이스에서 웹훅을 관리하기 위한 설정입니다.
`post_messages`	`PermissionSetting` 출력 전용입니다. 스페이스에 메시지를 게시하기 위한 설정입니다.
`reply_messages`	`PermissionSetting` 선택사항입니다. 스페이스에서 메시지에 답장하는 설정입니다.
`view_space_membership`	`PermissionSetting` 선택사항입니다. 스페이스 멤버십을 보기 위한 설정입니다. 스페이스 멤버십을 볼 수 있는 사용자를 업데이트할 때 업데이트 마스크 및 요청 본문에 `AccessPermissionSettings.view_space_membership_setting`와 함께 지정해야 합니다. 보기 권한을 특정 역할 (예: 스페이스 관리자 또는 부관리자만)로 제한하는 경우 여기에 원하는 역할 권한을 지정하고 동일한 요청에 빈 `AccessPermissionSettings.view_space_membership_setting`를 제공합니다. `AccessPermissionSettings.view_space_membership_setting`에 타겟 잠재고객이 구성된 경우 이 설정은 모든 구성원에게 부여되어야 합니다.

PredefinedPermissionSettings

이름이 지정된 스페이스를 만들 때만 지정할 수 있는 사전 정의된 권한 세트입니다. 향후 더 많은 설정이 추가될 수 있습니다. 이름이 지정된 스페이스의 권한 설정에 관한 자세한 내용은 스페이스에 대해 알아보기를 참고하세요.

열거형
`PREDEFINED_PERMISSION_SETTINGS_UNSPECIFIED`	지정되지 않음. 사용하지 마세요.
`COLLABORATION_SPACE`	스페이스를 모든 멤버가 메시지를 게시할 수 있는 공동작업 스페이스로 설정합니다.
`ANNOUNCEMENT_SPACE`	스페이스 관리자만 메시지를 게시할 수 있는 공지 스페이스로 설정합니다.

주 구성원

액세스 권한이 부여된 항목을 나타내는 주 구성원입니다.

필드

통합 필드 principal_type. 주 구성원 유형입니다. principal_type은 다음 중 하나여야 합니다.

audience

Audience

잠재고객

SpaceDetails

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

필드

description

string

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

최대 4,096자(영문 기준)를 지원합니다.

guidelines

string

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

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

SpaceThreadingState

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

열거형
`SPACE_THREADING_STATE_UNSPECIFIED`	Reserved.
`THREADED_MESSAGES`	메시지 대화목록을 지원하는 스페이스 사용자가 메시지에 응답할 때 대화목록 내에서 답장할 수 있으므로 원본 메시지의 맥락에 맞게 응답을 유지할 수 있습니다.
`GROUPED_MESSAGES`	주제별로 대화가 정리된 이름이 지정된 스페이스 주제와 답장이 그룹화됩니다.
`UNTHREADED_MESSAGES`	대화목록을 지원하지 않는 스페이스 이 스페이스 대화목록 상태는 다음을 포함한 특수한 경우에만 사용됩니다. 대화목록이 의도적으로 사용 중지된 회의 그룹 상시 채팅 2022년 이전에 생성된 기존 그룹 대화

SpaceType

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

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

유형

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

열거형
`TYPE_UNSPECIFIED`	Reserved.
`ROOM`	두 명 이상의 사람 간의 대화
`DM`	사용자와 Chat 앱 간의 1:1 채팅 메시지이며, 모든 메시지가 플랫합니다. 두 사람 간의 채팅 메시지는 포함되지 않습니다.

SpaceBatchUpdatedEventData

스페이스를 여러 번 업데이트하는 이벤트 페이로드입니다.

이벤트 유형: google.workspace.chat.space.v1.batchUpdated

필드

spaces[]

SpaceUpdatedEventData

업데이트된 스페이스 목록입니다.

SpaceEvent

Google Chat 스페이스의 변경사항 또는 활동을 나타내는 이벤트입니다. 자세한 내용은 Google Chat의 이벤트 작업을 참고하세요.

필드
`name`	`string` 스페이스 이벤트의 리소스 이름입니다. 형식: `spaces/{space}/spaceEvents/{spaceEvent}`
`event_time`	`Timestamp` 이벤트가 발생한 시간입니다.
`event_type`	`string` 스페이스 이벤트 유형입니다. 각 이벤트 유형에는 짧은 기간 동안 발생하는 이벤트 유형의 여러 인스턴스를 나타내는 일괄 버전이 있습니다. `spaceEvents.list()` 요청의 경우 쿼리 필터에서 일괄 이벤트 유형을 생략합니다. 기본적으로 서버는 이벤트 유형과 일괄 버전을 모두 반환합니다. 메시지에 지원되는 이벤트 유형: 새 메시지: `google.workspace.chat.message.v1.created` 업데이트된 메시지: `google.workspace.chat.message.v1.updated` 삭제된 메시지: `google.workspace.chat.message.v1.deleted` 새 메시지 여러 개: `google.workspace.chat.message.v1.batchCreated` 업데이트된 메시지 여러 개: `google.workspace.chat.message.v1.batchUpdated` 삭제된 메시지 여러 개: `google.workspace.chat.message.v1.batchDeleted` 멤버십에 지원되는 이벤트 유형: 새 멤버십: `google.workspace.chat.membership.v1.created` 업데이트된 멤버십: `google.workspace.chat.membership.v1.updated` 멤버십 삭제됨: `google.workspace.chat.membership.v1.deleted` 여러 신규 멤버십: `google.workspace.chat.membership.v1.batchCreated` 업데이트된 멤버십 여러 개: `google.workspace.chat.membership.v1.batchUpdated` 삭제된 멤버십 여러 개: `google.workspace.chat.membership.v1.batchDeleted` 반응에 지원되는 이벤트 유형: 새로운 반응: `google.workspace.chat.reaction.v1.created` 반응 삭제됨: `google.workspace.chat.reaction.v1.deleted` 여러 개의 새로운 반응: `google.workspace.chat.reaction.v1.batchCreated` 삭제된 반응 여러 개: `google.workspace.chat.reaction.v1.batchDeleted` 스페이스에 대해 지원되는 이벤트 유형: 스페이스 업데이트됨: `google.workspace.chat.space.v1.updated` 여러 스페이스 업데이트: `google.workspace.chat.space.v1.batchUpdated`
통합 필드 `payload`. `payload`는 다음 중 하나여야 합니다.
`message_created_event_data`	`MessageCreatedEventData` 새 메시지의 이벤트 페이로드입니다. 이벤트 유형: `google.workspace.chat.message.v1.created`
`message_updated_event_data`	`MessageUpdatedEventData` 업데이트된 메시지의 이벤트 페이로드입니다. 이벤트 유형: `google.workspace.chat.message.v1.updated`
`message_deleted_event_data`	`MessageDeletedEventData` 삭제된 메시지의 이벤트 페이로드입니다. 이벤트 유형: `google.workspace.chat.message.v1.deleted`
`message_batch_created_event_data`	`MessageBatchCreatedEventData` 여러 새 메시지의 이벤트 페이로드입니다. 이벤트 유형: `google.workspace.chat.message.v1.batchCreated`
`message_batch_updated_event_data`	`MessageBatchUpdatedEventData` 업데이트된 여러 메시지의 이벤트 페이로드입니다. 이벤트 유형: `google.workspace.chat.message.v1.batchUpdated`
`message_batch_deleted_event_data`	`MessageBatchDeletedEventData` 삭제된 여러 메시지의 이벤트 페이로드입니다. 이벤트 유형: `google.workspace.chat.message.v1.batchDeleted`
`space_updated_event_data`	`SpaceUpdatedEventData` 스페이스 업데이트의 이벤트 페이로드입니다. 이벤트 유형: `google.workspace.chat.space.v1.updated`
`space_batch_updated_event_data`	`SpaceBatchUpdatedEventData` 스페이스를 여러 번 업데이트하는 이벤트 페이로드입니다. 이벤트 유형: `google.workspace.chat.space.v1.batchUpdated`
`membership_created_event_data`	`MembershipCreatedEventData` 새 멤버십의 이벤트 페이로드입니다. 이벤트 유형: `google.workspace.chat.membership.v1.created`
`membership_updated_event_data`	`MembershipUpdatedEventData` 업데이트된 멤버십의 이벤트 페이로드입니다. 이벤트 유형: `google.workspace.chat.membership.v1.updated`
`membership_deleted_event_data`	`MembershipDeletedEventData` 삭제된 멤버십의 이벤트 페이로드입니다. 이벤트 유형: `google.workspace.chat.membership.v1.deleted`
`membership_batch_created_event_data`	`MembershipBatchCreatedEventData` 여러 신규 멤버십의 이벤트 페이로드입니다. 이벤트 유형: `google.workspace.chat.membership.v1.batchCreated`
`membership_batch_updated_event_data`	`MembershipBatchUpdatedEventData` 업데이트된 여러 멤버십의 이벤트 페이로드입니다. 이벤트 유형: `google.workspace.chat.membership.v1.batchUpdated`
`membership_batch_deleted_event_data`	`MembershipBatchDeletedEventData` 삭제된 멤버십 여러 개의 이벤트 페이로드입니다. 이벤트 유형: `google.workspace.chat.membership.v1.batchDeleted`
`reaction_created_event_data`	`ReactionCreatedEventData` 새 반응의 이벤트 페이로드입니다. 이벤트 유형: `google.workspace.chat.reaction.v1.created`
`reaction_deleted_event_data`	`ReactionDeletedEventData` 삭제된 반응의 이벤트 페이로드입니다. 이벤트 유형: `google.workspace.chat.reaction.v1.deleted`
`reaction_batch_created_event_data`	`ReactionBatchCreatedEventData` 여러 개의 새로운 반응에 대한 이벤트 페이로드입니다. 이벤트 유형: `google.workspace.chat.reaction.v1.batchCreated`
`reaction_batch_deleted_event_data`	`ReactionBatchDeletedEventData` 삭제된 여러 반응의 이벤트 페이로드입니다. 이벤트 유형: `google.workspace.chat.reaction.v1.batchDeleted`

SpaceNotificationSetting

스페이스에 있는 사용자의 알림 설정입니다.

필드

name

string

식별자. 스페이스 알림 설정의 리소스 이름입니다. 형식은 users/{user}/spaces/{space}/spaceNotificationSetting입니다.

notification_setting

NotificationSetting

알림 설정입니다.

mute_setting

MuteSetting

스페이스 알림 음소거 설정입니다.

MuteSetting

스페이스 알림 음소거 설정 유형입니다.

열거형
`MUTE_SETTING_UNSPECIFIED`	Reserved.
`UNMUTED`	사용자는 알림 설정에 따라 스페이스에 대한 알림을 받게 됩니다.
`MUTED`	사용자는 알림 설정과 관계없이 스페이스에 대한 알림을 받지 않습니다.

NotificationSetting

알림 설정 유형입니다. 향후 다른 유형이 지원될 수 있습니다.

열거형
`NOTIFICATION_SETTING_UNSPECIFIED`	Reserved.
`ALL`	@멘션, 팔로우 중인 대화목록, 새 대화목록의 첫 번째 메시지에 의해 알림이 트리거됩니다. 사용자가 수동으로 팔로우 해제하지 않는 한 모든 새 대화목록이 자동으로 팔로우됩니다.
`MAIN_CONVERSATIONS`	@멘션, 팔로우 중인 대화목록, 새 대화목록의 첫 번째 메시지에 의해 알림이 트리거됩니다. 1:1 채팅 메시지에는 사용할 수 없습니다.
`FOR_YOU`	@멘션, 팔로우 중인 대화목록에 의해 알림이 트리거됩니다. 1:1 채팅 메시지에는 사용할 수 없습니다.
`OFF`	알림이 사용 중지되었습니다.

SpaceReadState

스페이스 내 사용자의 읽음 상태로, 읽은 메시지와 읽지 않은 메시지를 식별하는 데 사용됩니다.

필드

name

string

스페이스 읽기 상태의 리소스 이름입니다.

형식: users/{user}/spaces/{space}/spaceReadState

last_read_time

Timestamp

선택사항입니다. 사용자의 스페이스 읽기 상태가 업데이트된 시간입니다. 일반적으로 이는 마지막으로 읽은 메시지의 타임스탬프 또는 사용자가 스페이스에서 마지막으로 읽은 위치를 표시하기 위해 지정한 타임스탬프에 해당합니다.

SpaceUpdatedEventData

업데이트된 스페이스의 이벤트 페이로드입니다.

이벤트 유형: google.workspace.chat.space.v1.updated

필드

space

업데이트된 스페이스입니다.

SpaceView

Space 리소스에 채워야 하는 필드를 지정하는 뷰입니다. 향후 출시 버전과의 호환성을 보장하려면 코드에서 추가 값을 고려하는 것이 좋습니다.

열거형
`SPACE_VIEW_UNSPECIFIED`	기본값 / 설정되지 않은 값입니다.
`SPACE_VIEW_RESOURCE_NAME_ONLY`	스페이스 리소스 이름만 채웁니다.
`SPACE_VIEW_EXPANDED`	스페이스 리소스 필드를 채웁니다. 참고: `permissionSettings` 필드는 채워지지 않습니다. SPACE_VIEW_EXPANDED를 지정하는 요청에는 스페이스 데이터를 읽을 수 있는 범위(예: https://www.googleapis.com/auth/chat.spaces 또는 https://www.googleapis.com/auth/chat.spaces.readonly)가 포함되어야 합니다.

스레드

Google Chat 스페이스의 대화목록입니다. 사용 예시는 메시지 대화목록 시작 또는 답장을 참고하세요.

메시지를 만들 때 대화목록을 지정하는 경우 messageReplyOption 필드를 설정하여 일치하는 대화목록을 찾을 수 없는 경우 어떻게 할지 결정할 수 있습니다.

필드

name

string

식별자. 대화목록의 리소스 이름입니다.

예: spaces/{space}/threads/{thread}

thread_key

string

선택사항입니다. 대화목록을 만들거나 업데이트하기 위한 입력입니다. 그 외의 경우에는 출력 전용입니다. 대화목록의 ID입니다. 최대 4,000자(영문 기준)까지 지원됩니다.

이 ID는 이를 설정하는 Chat 앱에 고유합니다. 예를 들어 여러 Chat 앱이 동일한 대화목록 키를 사용하여 메시지를 만드는 경우 메시지는 서로 다른 대화목록에 게시됩니다. 사용자 또는 다른 Chat 앱에서 만든 대화목록에 답장하려면 대신 대화목록 name 필드를 지정합니다.

ThreadReadState

읽은 메일과 읽지 않은 메일을 식별하는 데 사용되는 대화목록 내 사용자의 읽음 상태입니다.

필드

name

string

대화목록 읽음 상태의 리소스 이름입니다.

형식: users/{user}/spaces/{space}/threads/{thread}/threadReadState

last_read_time

Timestamp

사용자의 대화목록 읽기 상태가 업데이트된 시간입니다. 일반적으로 대화목록에서 마지막으로 읽은 메시지의 타임스탬프에 해당합니다.

UpdateAvailabilityRequest

UpdateAvailability 메서드에 대한 요청 메시지입니다.

필드

availability

Availability

필수 항목입니다. 업데이트할 재고입니다.

update_mask

필수 항목입니다. 업데이트할 필드 목록입니다. 업데이트할 수 있는 유일한 필드는 custom_status입니다.

UpdateMembershipRequest

멤버십 업데이트 요청 메시지입니다.

필드

membership

필수 항목입니다. 업데이트할 멤버십입니다. update_mask로 지정된 필드만 업데이트됩니다.

update_mask

필수 항목입니다. 업데이트할 필드 경로입니다. 여러 값을 쉼표로 구분하거나 *를 사용하여 모든 필드 경로를 업데이트합니다.

현재 지원되는 필드 경로는 다음과 같습니다.

role

use_admin_access

bool

선택사항입니다. true인 경우 메서드는 사용자의 Google Workspace 관리자 권한을 사용하여 실행됩니다.

호출하는 사용자는 채팅 및 스페이스 대화 관리 권한이 있는 Google Workspace 관리자여야 합니다.

chat.admin.memberships OAuth 2.0 범위가 필요합니다.

UpdateMessageRequest

메시지 업데이트 요청입니다.

필드

message

필수 항목입니다. 필드가 업데이트된 메시지입니다.

update_mask

필수 항목입니다. 업데이트할 필드 경로입니다. 여러 값을 쉼표로 구분하거나 *를 사용하여 모든 필드 경로를 업데이트합니다.

현재 지원되는 필드 경로는 다음과 같습니다.

text
attachment
cards (앱 인증 필요)
cards_v2 (앱 인증 필요)
accessory_widgets (앱 인증 필요)
quoted_message_metadata (인용된 메시지만 삭제할 수 있음)

allow_missing

bool

선택사항입니다. true이고 메시지를 찾을 수 없는 경우 새 메시지가 생성되고 updateMask는 무시됩니다. 지정된 메시지 ID는 클라이언트 할당이어야 하며, 그렇지 않으면 요청이 실패합니다.

UpdateSectionRequest

섹션 업데이트 요청 메시지입니다.

필드

section

필수 항목입니다. 업데이트할 섹션입니다.

update_mask

SpaceNotificationSetting

필수 항목입니다. 업데이트할 필드를 지정하는 마스크입니다.

현재 지원되는 필드 경로는 다음과 같습니다.

display_name

UpdateSpaceNotificationSettingRequest

스페이스 알림 설정 업데이트 요청입니다. 호출 사용자의 알림 설정 업데이트만 지원합니다.

필드

space_notification_setting

필수 항목입니다. 스페이스 알림 설정의 리소스 이름은 users/{user}/spaces/{space}/spaceNotificationSetting 형식으로 채워야 합니다. update_mask로 지정된 필드만 업데이트됩니다.

update_mask

필수 항목입니다. 지원되는 필드 경로:

notification_setting
mute_setting

UpdateSpaceReadStateRequest

UpdateSpaceReadState API의 요청 메시지입니다.

필드

space_read_state

SpaceReadState

필수 항목입니다. 업데이트할 스페이스 읽기 상태 및 필드입니다.

호출 사용자의 읽기 상태 업데이트만 지원합니다.

호출 사용자를 참조하려면 다음 중 하나를 설정합니다.

me 별칭입니다. 예를 들면 다음과 같습니다. users/me/spaces/{space}/spaceReadState
Workspace 이메일 주소 예를 들면 users/user@example.com/spaces/{space}/spaceReadState입니다.
사용자 ID 예를 들면 users/123456789/spaces/{space}/spaceReadState입니다.

형식: users/{user}/spaces/{space}/spaceReadState

update_mask

필수 항목입니다. 업데이트할 필드 경로입니다. 현재 지원되는 필드 경로는 다음과 같습니다.

last_read_time

last_read_time가 최신 메시지 생성 시간 이전인 경우 스페이스가 UI에 읽지 않은 상태로 표시됩니다.

스페이스를 읽음으로 표시하려면 last_read_time를 최신 메시지 생성 시간보다 이후 (더 큰) 값으로 설정합니다. last_read_time는 최신 메시지 생성 시간과 일치하도록 강제 변환됩니다. 스페이스 읽기 상태는 스페이스의 최상위 대화에 표시되는 메시지의 읽기 상태에만 영향을 미칩니다. 대화목록의 답장은 이 타임스탬프의 영향을 받지 않으며 대신 대화목록 읽기 상태를 사용합니다.

UpdateSpaceRequest

단일 스페이스를 업데이트하는 요청입니다.

필드

space

필수 항목입니다. 업데이트할 필드가 있는 스페이스입니다. Space.name은 spaces/{space} 형식으로 채워야 합니다. update_mask로 지정된 필드만 업데이트됩니다.

update_mask