Package google.chat.v1

색인

• ChatService(인터페이스)
• AccessoryWidget(메시지)
• ActionResponse(메시지)
• ActionResponse.ResponseType(열거형)
• ActionResponse.SelectionItems(메시지)
• ActionResponse.UpdatedWidget(메시지)
• ActionStatus(메시지)
• Annotation(메시지)
• AnnotationType(열거형)
• AppCommandMetadata(메시지)
• AppCommandMetadata.AppCommandType(열거형)
• AttachedGif(메시지)
• Attachment(메시지)
• Attachment.Source(열거형)
• AttachmentDataRef(메시지)
• CalendarEventLinkData(메시지)
• CardWithId(메시지)
• ChatSpaceLinkData(메시지)
• CompleteImportSpaceRequest(메시지)
• CompleteImportSpaceResponse(메시지)
• ContextualAddOnMarkup(메시지)
• ContextualAddOnMarkup.Card(메시지)
• ContextualAddOnMarkup.Card.CardAction(메시지)
• ContextualAddOnMarkup.Card.CardHeader(메시지)
• ContextualAddOnMarkup.Card.CardHeader.ImageStyle(열거형)
• ContextualAddOnMarkup.Card.Section(메시지)
• CreateCustomEmojiRequest(메시지)
• CreateMembershipRequest(메시지)
• CreateMessageRequest(메시지)
• CreateMessageRequest.MessageReplyOption(열거형)
• CreateReactionRequest(메시지)
• CreateSpaceRequest(메시지)
• CustomEmoji(메시지)
• CustomEmoji.CustomEmojiPayload(메시지)
• CustomEmojiMetadata(메시지)
• DeleteCustomEmojiRequest(메시지)
• DeleteMembershipRequest(메시지)
• DeleteMessageRequest(메시지)
• DeleteReactionRequest(메시지)
• DeleteSpaceRequest(메시지)
• DeletionMetadata(메시지)
• DeletionMetadata.DeletionType(열거형)
• Dialog(메시지)
• DialogAction(메시지)
• DriveDataRef(메시지)
• DriveLinkData(메시지)
• Emoji(메시지)
• EmojiReactionSummary(메시지)
• FindDirectMessageRequest(메시지)
• GetAttachmentRequest(메시지)
• GetCustomEmojiRequest(메시지)
• GetMembershipRequest(메시지)
• GetMessageRequest(메시지)
• GetSpaceEventRequest(메시지)
• GetSpaceNotificationSettingRequest(메시지)
• GetSpaceReadStateRequest(메시지)
• GetSpaceRequest(메시지)
• GetThreadReadStateRequest(메시지)
• Group(메시지)
• HistoryState(열거형)
• ListCustomEmojisRequest(메시지)
• ListCustomEmojisResponse(메시지)
• ListMembershipsRequest(메시지)
• ListMembershipsResponse(메시지)
• ListMessagesRequest(메시지)
• ListMessagesResponse(메시지)
• ListReactionsRequest(메시지)
• ListReactionsResponse(메시지)
• ListSpaceEventsRequest(메시지)
• ListSpaceEventsResponse(메시지)
• ListSpacesRequest(메시지)
• ListSpacesResponse(메시지)
• MatchedUrl(메시지)
• MeetSpaceLinkData(메시지)
• MeetSpaceLinkData.HuddleStatus(열거형)
• MeetSpaceLinkData.Type(열거형)
• Membership(메시지)
• Membership.MembershipRole(열거형)
• Membership.MembershipState(열거형)
• MembershipBatchCreatedEventData(메시지)
• MembershipBatchDeletedEventData(메시지)
• MembershipBatchUpdatedEventData(메시지)
• MembershipCreatedEventData(메시지)
• MembershipDeletedEventData(메시지)
• MembershipUpdatedEventData(메시지)
• Message(메시지)
• MessageBatchCreatedEventData(메시지)
• MessageBatchDeletedEventData(메시지)
• MessageBatchUpdatedEventData(메시지)
• MessageCreatedEventData(메시지)
• MessageDeletedEventData(메시지)
• MessageUpdatedEventData(메시지)
• QuotedMessageMetadata(메시지)
• Reaction(메시지)
• ReactionBatchCreatedEventData(메시지)
• ReactionBatchDeletedEventData(메시지)
• ReactionCreatedEventData(메시지)
• ReactionDeletedEventData(메시지)
• RichLinkMetadata(메시지)
• RichLinkMetadata.RichLinkType(열거형)
• SearchSpacesRequest(메시지)
• SearchSpacesResponse(메시지)
• SetUpSpaceRequest(메시지)
• SlashCommand(메시지)
• SlashCommandMetadata(메시지)
• SlashCommandMetadata.Type(열거형)
• Space(메시지)
• Space.AccessSettings(메시지)
• Space.AccessSettings.AccessState(열거형)
• Space.MembershipCount(메시지)
• Space.PermissionSetting(메시지)
• Space.PermissionSettings(메시지)
• Space.PredefinedPermissionSettings(열거형)
• Space.SpaceDetails(메시지)
• Space.SpaceThreadingState(열거형)
• Space.SpaceType(열거형)
• Space.Type(열거형)
• SpaceBatchUpdatedEventData(메시지)
• SpaceEvent(메시지)
• SpaceNotificationSetting(메시지)
• SpaceNotificationSetting.MuteSetting(열거형)
• SpaceNotificationSetting.NotificationSetting(열거형)
• SpaceReadState(메시지)
• SpaceUpdatedEventData(메시지)
• Thread(메시지)
• ThreadReadState(메시지)
• UpdateMembershipRequest(메시지)
• UpdateMessageRequest(메시지)
• UpdateSpaceNotificationSettingRequest(메시지)
• UpdateSpaceReadStateRequest(메시지)
• UpdateSpaceRequest(메시지)
• User(메시지)
• User.Type(열거형)
• UserMentionMetadata(메시지)
• UserMentionMetadata.Type(열거형)
• WidgetMarkup(메시지)
• WidgetMarkup.Button(메시지)
• WidgetMarkup.FormAction(메시지)
• WidgetMarkup.FormAction.ActionParameter(메시지)
• WidgetMarkup.Icon(열거형)
• WidgetMarkup.Image(메시지)
• WidgetMarkup.ImageButton(메시지)
• WidgetMarkup.KeyValue(메시지)
• WidgetMarkup.OnClick(메시지)
• WidgetMarkup.OpenLink(메시지)
• WidgetMarkup.TextButton(메시지)
• WidgetMarkup.TextParagraph(메시지)

ChatService

개발자가 Google Chat 플랫폼에서 Chat 앱과 통합을 빌드할 수 있도록 지원합니다.

CompleteImportSpace
rpc CompleteImportSpace(CompleteImportSpaceRequest) returns (CompleteImportSpaceResponse) 지정된 스페이스의 가져오기 프로세스를 완료하고 사용자에게 표시되도록 합니다. 사용자 인증 및 승인 범위를 사용한 도메인 전체 위임이 필요합니다. https://www.googleapis.com/auth/chat.import 자세한 내용은 Google Chat 앱이 데이터를 가져오도록 승인하기를 참고하세요. 승인 범위 다음 OAuth 범위가 필요합니다. https://www.googleapis.com/auth/chat.import 자세한 내용은 승인 가이드를 참고하세요.

CreateCustomEmoji

rpc CreateCustomEmoji(CreateCustomEmojiRequest) returns (CustomEmoji) 맞춤 이모티콘을 만듭니다. 맞춤 그림 이모티콘은 Google Workspace 계정에서만 사용할 수 있으며 관리자가 조직에 맞춤 그림 이모티콘을 사용 설정해야 합니다. 자세한 내용은 Google Chat의 맞춤 그림 이모티콘에 관해 알아보기 및 맞춤 그림 이모티콘 권한 관리하기를 참고하세요. 승인 범위를 사용한 사용자 인증이 필요합니다. https://www.googleapis.com/auth/chat.customemojis 승인 범위 다음 OAuth 범위가 필요합니다. https://www.googleapis.com/auth/chat.customemojis 자세한 내용은 승인 가이드를 참고하세요.

CreateMembership

rpc CreateMembership(CreateMembershipRequest) returns (Membership) 호출 Chat 앱, 사용자 또는 Google 그룹의 멤버십을 만듭니다. 다른 Chat 앱의 멤버십 생성은 지원되지 않습니다. 멤버십을 만들 때 지정된 멤버의 자동 수락 정책이 사용 중지되어 있으면 해당 멤버가 초대되며, 스페이스에 참여하기 전에 스페이스 초대를 수락해야 합니다. 그렇지 않으면 멤버십을 만들면 지정된 스페이스에 멤버가 바로 추가됩니다. 다음 유형의 인증을 지원합니다. 개발자 미리보기의 관리자 승인을 사용하는 앱 인증 및 승인 범위: https://www.googleapis.com/auth/chat.app.memberships 다음 승인 범위 중 하나를 사용한 사용자 인증 https://www.googleapis.com/auth/chat.memberships https://www.googleapis.com/auth/chat.memberships.app (호출 앱을 스페이스에 추가) https://www.googleapis.com/auth/chat.import (가져오기 모드 스페이스만 해당) 사용자 인증은 관리자 계정이 인증되고 use_admin_access이 true이며 다음 승인 범위가 사용될 때 관리자 권한을 부여합니다. https://www.googleapis.com/auth/chat.admin.memberships 다음 사용 사례에서는 앱 인증이 지원되지 않습니다. 스페이스를 소유한 Workspace 조직 외부의 사용자를 초대합니다. 스페이스에 Google 그룹 추가 스페이스에 Chat 앱 추가 사용 예시는 다음을 참고하세요. 사용자를 스페이스에 초대하거나 추가 스페이스에 Google 그룹 초대 또는 추가하기 스페이스에 Chat 앱 추가하기 승인 범위 다음 OAuth 범위 중 하나가 필요합니다. https://www.googleapis.com/auth/chat.app.memberships https://www.googleapis.com/auth/chat.admin.memberships https://www.googleapis.com/auth/chat.import https://www.googleapis.com/auth/chat.memberships https://www.googleapis.com/auth/chat.memberships.app 자세한 내용은 승인 가이드를 참고하세요.

CreateMessage

rpc CreateMessage(CreateMessageRequest) returns (Message) Google Chat 스페이스에 메시지를 만듭니다. 예를 보려면 메시지 보내기를 참고하세요. 다음 유형의 인증을 지원합니다. 승인 범위가 있는 앱 인증: https://www.googleapis.com/auth/chat.bot 다음 승인 범위 중 하나를 사용한 사용자 인증 https://www.googleapis.com/auth/chat.messages.create https://www.googleapis.com/auth/chat.messages https://www.googleapis.com/auth/chat.import (가져오기 모드 스페이스만 해당) Chat은 요청에 사용하는 인증 유형에 따라 메시지 발신자를 다르게 표시합니다. 다음 이미지는 앱 인증을 사용할 때 Chat에서 메시지를 속성으로 지정하는 방법을 보여줍니다. Chat에 채팅 앱이 메시지 발신자로 표시됩니다. 메시지 콘텐츠에는 텍스트 (text), 카드 (cardsV2), 액세서리 위젯 (accessoryWidgets)이 포함될 수 있습니다. 다음 이미지는 사용자 인증을 사용할 때 Chat에서 메시지를 속성으로 지정하는 방법을 보여줍니다. Chat은 사용자를 메시지 발신자로 표시하고 이름을 표시하여 Chat 앱을 메시지에 귀속시킵니다. 메시지 콘텐츠에는 텍스트 (text)만 포함될 수 있습니다. 메일 콘텐츠를 포함한 최대 메일 크기는 32,000바이트입니다. 웹훅 요청의 경우 응답에 전체 메시지가 포함되지 않습니다. 대답에는 요청에 있던 정보 외에 name 및 thread.name 필드만 채워집니다. 승인 범위 다음 OAuth 범위 중 하나가 필요합니다. https://www.googleapis.com/auth/chat.bot https://www.googleapis.com/auth/chat.import https://www.googleapis.com/auth/chat.messages https://www.googleapis.com/auth/chat.messages.create 자세한 내용은 승인 가이드를 참고하세요.

CreateReaction

rpc CreateReaction(CreateReactionRequest) returns (Reaction) 반응을 만들어 메시지에 추가합니다. 예를 보려면 메시지에 반응 추가하기를 참고하세요. 다음 승인 범위 중 하나를 사용하여 사용자 인증이 필요합니다. https://www.googleapis.com/auth/chat.messages.reactions.create https://www.googleapis.com/auth/chat.messages.reactions https://www.googleapis.com/auth/chat.messages https://www.googleapis.com/auth/chat.import (가져오기 모드 스페이스만 해당) 승인 범위 다음 OAuth 범위 중 하나가 필요합니다. https://www.googleapis.com/auth/chat.import https://www.googleapis.com/auth/chat.messages https://www.googleapis.com/auth/chat.messages.reactions https://www.googleapis.com/auth/chat.messages.reactions.create 자세한 내용은 승인 가이드를 참고하세요.

CreateSpace

rpc CreateSpace(CreateSpaceRequest) returns (Space) 스페이스를 만듭니다. Import mode에서 이름이 지정된 스페이스 또는 그룹 채팅을 만드는 데 사용할 수 있습니다. 예시는 스페이스 만들기를 참고하세요. 다음 유형의 인증을 지원합니다. 개발자 미리보기의 관리자 승인을 사용하는 앱 인증 및 다음 승인 범위 중 하나 https://www.googleapis.com/auth/chat.app.spaces.create https://www.googleapis.com/auth/chat.app.spaces 다음 승인 범위 중 하나를 사용한 사용자 인증 https://www.googleapis.com/auth/chat.spaces.create https://www.googleapis.com/auth/chat.spaces https://www.googleapis.com/auth/chat.import (가져오기 모드 스페이스만 해당) 앱으로 인증할 때는 요청에서 space.customer 필드를 설정해야 합니다. 앱으로 인증하면 Chat 앱이 스페이스의 구성원으로 추가됩니다. 하지만 사람 인증과 달리 Chat 앱은 스페이스 관리자로 추가되지 않습니다. 기본적으로 모든 스페이스 참여자가 스페이스에서 Chat 앱을 삭제할 수 있습니다. 스페이스 관리자만 스페이스에서 앱을 삭제할 수 있도록 하려면 space.permission_settings.manage_apps을 managers_allowed로 설정하세요. 생성 시 스페이스 멤버십은 스페이스가 Import mode에서 생성되었는지에 따라 달라집니다. 가져오기 모드: 회원이 생성되지 않습니다. 기타 모든 모드: 통화하는 사용자가 회원으로 추가됩니다. 이는 다음을 의미합니다. 앱 인증을 사용하는 경우 앱 자체 사용자 인증을 사용하는 경우의 실제 사용자입니다. 스페이스를 만들 때 ALREADY_EXISTS 오류 메시지가 표시되면 다른 displayName를 사용해 보세요. Google Workspace 조직 내의 기존 스페이스에서 이미 이 표시 이름을 사용하고 있을 수 있습니다. 승인 범위 다음 OAuth 범위 중 하나가 필요합니다. https://www.googleapis.com/auth/chat.app.spaces.create https://www.googleapis.com/auth/chat.app.spaces https://www.googleapis.com/auth/chat.import https://www.googleapis.com/auth/chat.spaces https://www.googleapis.com/auth/chat.spaces.create 자세한 내용은 승인 가이드를 참고하세요.

DeleteCustomEmoji

rpc DeleteCustomEmoji(DeleteCustomEmojiRequest) returns (Empty) 맞춤 그림 이모티콘을 삭제합니다. 기본적으로 사용자는 자신이 만든 맞춤 그림 이모티콘만 삭제할 수 있습니다. 관리자가 할당한 그림 이모티콘 관리자는 조직의 모든 맞춤 그림 이모티콘을 삭제할 수 있습니다. Google Chat의 맞춤 이모티콘에 관해 알아보기를 참고하세요. 맞춤 그림 이모티콘은 Google Workspace 계정에서만 사용할 수 있으며 관리자가 조직에 맞춤 그림 이모티콘을 사용 설정해야 합니다. 자세한 내용은 Google Chat의 맞춤 그림 이모티콘에 관해 알아보기 및 맞춤 그림 이모티콘 권한 관리하기를 참고하세요. 승인 범위를 사용한 사용자 인증이 필요합니다. https://www.googleapis.com/auth/chat.customemojis 승인 범위 다음 OAuth 범위가 필요합니다. https://www.googleapis.com/auth/chat.customemojis 자세한 내용은 승인 가이드를 참고하세요.

DeleteMembership

rpc DeleteMembership(DeleteMembershipRequest) returns (Membership) 멤버십을 삭제합니다. 예를 보려면 스페이스에서 사용자 또는 Google Chat 앱 삭제하기를 참고하세요. 다음 유형의 인증을 지원합니다. 개발자 미리보기의 관리자 승인을 사용하는 앱 인증 및 승인 범위: https://www.googleapis.com/auth/chat.app.memberships 다음 승인 범위 중 하나를 사용한 사용자 인증 https://www.googleapis.com/auth/chat.memberships https://www.googleapis.com/auth/chat.memberships.app (호출 앱을 스페이스에서 삭제) https://www.googleapis.com/auth/chat.import (가져오기 모드 스페이스만 해당) 사용자 인증은 관리자 계정이 인증되고 use_admin_access이 true이며 다음 승인 범위가 사용될 때 관리자 권한을 부여합니다. https://www.googleapis.com/auth/chat.admin.memberships 다음 사용 사례에서는 앱 인증이 지원되지 않습니다. 스페이스에서 Google 그룹을 삭제합니다. 스페이스에서 Chat 앱을 삭제합니다. 스페이스 관리자의 멤버십을 삭제하려면 요청자가 스페이스 관리자여야 합니다. 앱 인증을 사용하는 경우 Chat 앱이 스페이스 생성자여야 합니다. 승인 범위 다음 OAuth 범위 중 하나가 필요합니다. https://www.googleapis.com/auth/chat.app.memberships https://www.googleapis.com/auth/chat.admin.memberships https://www.googleapis.com/auth/chat.import https://www.googleapis.com/auth/chat.memberships https://www.googleapis.com/auth/chat.memberships.app 자세한 내용은 승인 가이드를 참고하세요.

DeleteMessage

rpc DeleteMessage(DeleteMessageRequest) returns (Empty) 메일을 삭제합니다. 예를 보려면 메시지 삭제를 참고하세요. 다음 유형의 인증을 지원합니다. 승인 범위가 있는 앱 인증: https://www.googleapis.com/auth/chat.bot 다음 승인 범위 중 하나를 사용한 사용자 인증 https://www.googleapis.com/auth/chat.messages https://www.googleapis.com/auth/chat.import (가져오기 모드 스페이스만 해당) 앱 인증을 사용하는 경우 요청은 호출하는 Chat 앱에서 만든 메시지만 삭제할 수 있습니다. 승인 범위 다음 OAuth 범위 중 하나가 필요합니다. https://www.googleapis.com/auth/chat.bot https://www.googleapis.com/auth/chat.import https://www.googleapis.com/auth/chat.messages 자세한 내용은 승인 가이드를 참고하세요.

DeleteReaction

rpc DeleteReaction(DeleteReactionRequest) returns (Empty) 메시지에 대한 반응을 삭제합니다. 예를 보려면 반응 삭제를 참고하세요. 다음 승인 범위 중 하나를 사용하여 사용자 인증이 필요합니다. https://www.googleapis.com/auth/chat.messages.reactions https://www.googleapis.com/auth/chat.messages https://www.googleapis.com/auth/chat.import (가져오기 모드 스페이스만 해당) 승인 범위 다음 OAuth 범위 중 하나가 필요합니다. https://www.googleapis.com/auth/chat.import https://www.googleapis.com/auth/chat.messages https://www.googleapis.com/auth/chat.messages.reactions 자세한 내용은 승인 가이드를 참고하세요.

DeleteSpace

rpc DeleteSpace(DeleteSpaceRequest) returns (Empty) 명명된 스페이스를 삭제합니다. 항상 캐스케이드 삭제를 실행합니다. 즉, 스페이스에 게시된 메시지, 스페이스의 멤버십과 같은 스페이스의 하위 리소스도 삭제됩니다. 예를 보려면 스페이스 삭제를 참고하세요. 다음 유형의 인증을 지원합니다. 개발자 미리보기의 관리자 승인을 사용하는 앱 인증 및 승인 범위: https://www.googleapis.com/auth/chat.app.delete (앱에서 만든 스페이스에서만) 다음 승인 범위 중 하나를 사용한 사용자 인증 https://www.googleapis.com/auth/chat.delete https://www.googleapis.com/auth/chat.import (가져오기 모드 스페이스만 해당) 사용자 인증은 관리자 계정이 인증되고 use_admin_access이 true이며 다음 승인 범위가 사용될 때 관리자 권한을 부여합니다. https://www.googleapis.com/auth/chat.admin.delete 승인 범위 다음 OAuth 범위 중 하나가 필요합니다. https://www.googleapis.com/auth/chat.app.delete https://www.googleapis.com/auth/chat.admin.delete https://www.googleapis.com/auth/chat.import https://www.googleapis.com/auth/chat.delete 자세한 내용은 승인 가이드를 참고하세요.

FindDirectMessage

rpc FindDirectMessage(FindDirectMessageRequest) returns (Space) 지정된 사용자와의 기존 채팅 메시지를 반환합니다. 다이렉트 메시지 스페이스가 없으면 404 NOT_FOUND 오류를 반환합니다. 예시는 채팅 메시지 찾기를 참고하세요. 앱 인증을 사용하면 지정된 사용자와 호출된 Chat 앱 간의 채팅 메시지 스페이스가 반환됩니다. 사용자 인증을 사용하면 지정된 사용자와 인증된 사용자 간의 다이렉트 메시지 스페이스가 반환됩니다. 다음 유형의 인증을 지원합니다. 승인 범위가 있는 앱 인증: https://www.googleapis.com/auth/chat.bot 다음 승인 범위 중 하나를 사용한 사용자 인증 https://www.googleapis.com/auth/chat.spaces.readonly https://www.googleapis.com/auth/chat.spaces 승인 범위 다음 OAuth 범위 중 하나가 필요합니다. https://www.googleapis.com/auth/chat.spaces https://www.googleapis.com/auth/chat.spaces.readonly https://www.googleapis.com/auth/chat.bot 자세한 내용은 승인 가이드를 참고하세요.

GetAttachment
rpc GetAttachment(GetAttachmentRequest) returns (Attachment) 메시지 첨부파일의 메타데이터를 가져옵니다. 첨부 파일 데이터는 미디어 API를 사용하여 가져옵니다. 예시는 메일 첨부파일에 관한 메타데이터 가져오기를 참고하세요. 승인 범위를 사용한 앱 인증이 필요합니다. https://www.googleapis.com/auth/chat.bot 승인 범위 다음 OAuth 범위가 필요합니다. https://www.googleapis.com/auth/chat.bot 자세한 내용은 승인 가이드를 참고하세요.

GetCustomEmoji

rpc GetCustomEmoji(GetCustomEmojiRequest) returns (CustomEmoji) 맞춤 그림 이모티콘에 관한 세부정보를 반환합니다. 맞춤 그림 이모티콘은 Google Workspace 계정에서만 사용할 수 있으며 관리자가 조직에 맞춤 그림 이모티콘을 사용 설정해야 합니다. 자세한 내용은 Google Chat의 맞춤 그림 이모티콘에 관해 알아보기 및 맞춤 그림 이모티콘 권한 관리하기를 참고하세요. 다음 승인 범위 중 하나를 사용하여 사용자 인증이 필요합니다. https://www.googleapis.com/auth/chat.customemojis.readonly https://www.googleapis.com/auth/chat.customemojis 승인 범위 다음 OAuth 범위 중 하나가 필요합니다. https://www.googleapis.com/auth/chat.customemojis https://www.googleapis.com/auth/chat.customemojis.readonly 자세한 내용은 승인 가이드를 참고하세요.

GetMembership

rpc GetMembership(GetMembershipRequest) returns (Membership) 멤버십에 관한 세부정보를 반환합니다. 예를 보려면 사용자 또는 Google Chat 앱의 멤버십에 관한 세부정보 가져오기를 참고하세요. 다음 유형의 인증을 지원합니다. 다음 승인 범위 중 하나를 사용하는 앱 인증 https://www.googleapis.com/auth/chat.bot https://www.googleapis.com/auth/chat.app.memberships (관리자 승인 필요) 다음 승인 범위 중 하나를 사용한 사용자 인증 https://www.googleapis.com/auth/chat.memberships.readonly https://www.googleapis.com/auth/chat.memberships 사용자 인증은 관리자 계정이 인증되고 use_admin_access이 true이며 다음 승인 범위 중 하나가 사용될 때 관리자 권한을 부여합니다. https://www.googleapis.com/auth/chat.admin.memberships.readonly https://www.googleapis.com/auth/chat.admin.memberships 승인 범위 다음 OAuth 범위 중 하나가 필요합니다. https://www.googleapis.com/auth/chat.admin.memberships https://www.googleapis.com/auth/chat.admin.memberships.readonly https://www.googleapis.com/auth/chat.app.memberships https://www.googleapis.com/auth/chat.bot https://www.googleapis.com/auth/chat.memberships https://www.googleapis.com/auth/chat.memberships.readonly 자세한 내용은 승인 가이드를 참고하세요.

GetMessage

rpc GetMessage(GetMessageRequest) returns (Message) 메시지에 관한 세부정보를 반환합니다. 예를 보려면 메시지에 관한 세부정보 가져오기를 참고하세요. 다음 유형의 인증을 지원합니다. 승인 범위가 있는 앱 인증: https://www.googleapis.com/auth/chat.bot 다음 승인 범위 중 하나를 사용한 사용자 인증 https://www.googleapis.com/auth/chat.messages.readonly https://www.googleapis.com/auth/chat.messages 참고: 차단된 회원 또는 스페이스의 메시지가 반환될 수 있습니다. 승인 범위 다음 OAuth 범위 중 하나가 필요합니다. https://www.googleapis.com/auth/chat.bot https://www.googleapis.com/auth/chat.messages https://www.googleapis.com/auth/chat.messages.readonly 자세한 내용은 승인 가이드를 참고하세요.

GetSpace

rpc GetSpace(GetSpaceRequest) returns (Space) 스페이스에 관한 세부정보를 반환합니다. 예를 보려면 스페이스에 관한 세부정보 가져오기를 참고하세요. 다음 유형의 인증을 지원합니다. 다음 승인 범위 중 하나를 사용하는 앱 인증 https://www.googleapis.com/auth/chat.bot 관리자 승인이 있는 https://www.googleapis.com/auth/chat.app.spaces 다음 승인 범위 중 하나를 사용한 사용자 인증 https://www.googleapis.com/auth/chat.spaces.readonly https://www.googleapis.com/auth/chat.spaces 사용자 인증은 관리자 계정이 인증되고 use_admin_access이 true이며 다음 승인 범위 중 하나가 사용될 때 관리자 권한을 부여합니다. https://www.googleapis.com/auth/chat.admin.spaces.readonly https://www.googleapis.com/auth/chat.admin.spaces 앱 인증에는 다음과 같은 제한사항이 있습니다. space.access_settings는 chat.app.spaces 범위를 사용하는 경우에만 채워집니다. space.predefind_permission_settings 및 space.permission_settings는 chat.app.spaces 범위를 사용하는 경우에만, 앱에서 만든 스페이스에 대해서만 채워집니다. 승인 범위 다음 OAuth 범위 중 하나가 필요합니다. https://www.googleapis.com/auth/chat.admin.spaces https://www.googleapis.com/auth/chat.admin.spaces.readonly https://www.googleapis.com/auth/chat.spaces https://www.googleapis.com/auth/chat.spaces.readonly https://www.googleapis.com/auth/chat.bot https://www.googleapis.com/auth/chat.app.spaces 자세한 내용은 승인 가이드를 참고하세요.

GetSpaceEvent

rpc GetSpaceEvent(GetSpaceEventRequest) returns (SpaceEvent) Google Chat 스페이스의 이벤트를 반환합니다. 이벤트 페이로드에는 변경된 리소스의 최신 버전이 포함됩니다. 예를 들어 새 메시지에 관한 이벤트를 요청했지만 나중에 메시지가 업데이트된 경우 서버는 이벤트 페이로드에서 업데이트된 Message 리소스를 반환합니다. 참고: 이 요청의 공간 이벤트 데이터의 공간 객체에는 permissionSettings 필드가 반환되지 않습니다. 요청된 데이터를 읽는 데 적합한 승인 범위를 사용하여 사용자 인증이 필요합니다. https://www.googleapis.com/auth/chat.spaces.readonly https://www.googleapis.com/auth/chat.spaces https://www.googleapis.com/auth/chat.messages.readonly https://www.googleapis.com/auth/chat.messages https://www.googleapis.com/auth/chat.messages.reactions.readonly https://www.googleapis.com/auth/chat.messages.reactions https://www.googleapis.com/auth/chat.memberships.readonly https://www.googleapis.com/auth/chat.memberships 이벤트를 가져오려면 인증된 사용자가 스페이스의 구성원이어야 합니다. 예는 Google Chat 스페이스에서 이벤트에 관한 세부정보 가져오기를 참고하세요. 승인 범위 다음 OAuth 범위 중 하나가 필요합니다. https://www.googleapis.com/auth/chat.spaces https://www.googleapis.com/auth/chat.spaces.readonly https://www.googleapis.com/auth/chat.messages https://www.googleapis.com/auth/chat.messages.readonly https://www.googleapis.com/auth/chat.memberships https://www.googleapis.com/auth/chat.memberships.readonly https://www.googleapis.com/auth/chat.messages.reactions https://www.googleapis.com/auth/chat.messages.reactions.readonly 자세한 내용은 승인 가이드를 참고하세요.

GetSpaceNotificationSetting
rpc GetSpaceNotificationSetting(GetSpaceNotificationSettingRequest) returns (SpaceNotificationSetting) 스페이스 알림 설정을 가져옵니다. 예를 보려면 호출자의 스페이스 알림 설정 가져오기를 참고하세요. 승인 범위를 사용한 사용자 인증이 필요합니다. https://www.googleapis.com/auth/chat.users.spacesettings 승인 범위 다음 OAuth 범위가 필요합니다. https://www.googleapis.com/auth/chat.users.spacesettings 자세한 내용은 승인 가이드를 참고하세요.

GetSpaceReadState

rpc GetSpaceReadState(GetSpaceReadStateRequest) returns (SpaceReadState) 읽은 메시지와 읽지 않은 메시지를 식별하는 데 사용되는 스페이스 내 사용자의 읽기 상태에 관한 세부정보를 반환합니다. 예는 사용자의 스페이스 읽기 상태에 관한 세부정보 가져오기를 참고하세요. 다음 승인 범위 중 하나를 사용하여 사용자 인증이 필요합니다. https://www.googleapis.com/auth/chat.users.readstate.readonly https://www.googleapis.com/auth/chat.users.readstate 승인 범위 다음 OAuth 범위 중 하나가 필요합니다. https://www.googleapis.com/auth/chat.users.readstate https://www.googleapis.com/auth/chat.users.readstate.readonly 자세한 내용은 승인 가이드를 참고하세요.

GetThreadReadState

rpc GetThreadReadState(GetThreadReadStateRequest) returns (ThreadReadState) 읽은 메일과 읽지 않은 메일을 식별하는 데 사용되는 스레드 내 사용자의 읽기 상태에 관한 세부정보를 반환합니다. 예를 보려면 사용자의 스레드 읽기 상태에 관한 세부정보 가져오기를 참고하세요. 다음 승인 범위 중 하나를 사용하여 사용자 인증이 필요합니다. https://www.googleapis.com/auth/chat.users.readstate.readonly https://www.googleapis.com/auth/chat.users.readstate 승인 범위 다음 OAuth 범위 중 하나가 필요합니다. https://www.googleapis.com/auth/chat.users.readstate https://www.googleapis.com/auth/chat.users.readstate.readonly 자세한 내용은 승인 가이드를 참고하세요.

ListCustomEmojis

rpc ListCustomEmojis(ListCustomEmojisRequest) returns (ListCustomEmojisResponse) 인증된 사용자에게 표시되는 맞춤 이모티콘을 나열합니다. 맞춤 그림 이모티콘은 Google Workspace 계정에서만 사용할 수 있으며 관리자가 조직에 맞춤 그림 이모티콘을 사용 설정해야 합니다. 자세한 내용은 Google Chat의 맞춤 그림 이모티콘에 관해 알아보기 및 맞춤 그림 이모티콘 권한 관리하기를 참고하세요. 다음 승인 범위 중 하나를 사용하여 사용자 인증이 필요합니다. https://www.googleapis.com/auth/chat.customemojis.readonly https://www.googleapis.com/auth/chat.customemojis 승인 범위 다음 OAuth 범위 중 하나가 필요합니다. https://www.googleapis.com/auth/chat.customemojis https://www.googleapis.com/auth/chat.customemojis.readonly 자세한 내용은 승인 가이드를 참고하세요.

ListMemberships

rpc ListMemberships(ListMembershipsRequest) returns (ListMembershipsResponse) 스페이스의 멤버십을 나열합니다. 예를 보려면 스페이스의 사용자 및 Google Chat 앱 나열하기를 참고하세요. 앱 인증으로 멤버십을 나열하면 Chat 앱이 액세스할 수 있는 스페이스의 멤버십이 나열되지만 자체를 포함한 Chat 앱 멤버십은 제외됩니다. 사용자 인증으로 멤버십을 나열하면 인증된 사용자가 액세스할 수 있는 스페이스의 멤버십이 나열됩니다. 다음 유형의 인증을 지원합니다. 다음 승인 범위 중 하나를 사용하는 앱 인증 https://www.googleapis.com/auth/chat.bot https://www.googleapis.com/auth/chat.app.memberships (관리자 승인 필요) 다음 승인 범위 중 하나를 사용한 사용자 인증 https://www.googleapis.com/auth/chat.memberships.readonly https://www.googleapis.com/auth/chat.memberships https://www.googleapis.com/auth/chat.import (가져오기 모드 스페이스만 해당) 사용자 인증은 관리자 계정이 인증되고 use_admin_access이 true이며 다음 승인 범위 중 하나가 사용될 때 관리자 권한을 부여합니다. https://www.googleapis.com/auth/chat.admin.memberships.readonly https://www.googleapis.com/auth/chat.admin.memberships 승인 범위 다음 OAuth 범위 중 하나가 필요합니다. https://www.googleapis.com/auth/chat.admin.memberships https://www.googleapis.com/auth/chat.admin.memberships.readonly https://www.googleapis.com/auth/chat.app.memberships https://www.googleapis.com/auth/chat.bot https://www.googleapis.com/auth/chat.import https://www.googleapis.com/auth/chat.memberships https://www.googleapis.com/auth/chat.memberships.readonly 자세한 내용은 승인 가이드를 참고하세요.

ListMessages

rpc ListMessages(ListMessagesRequest) returns (ListMessagesResponse) 호출자가 회원인 스페이스의 메시지를 나열합니다. 여기에는 차단된 회원 및 스페이스의 메시지가 포함됩니다. 메시지가 없는 스페이스의 메시지를 나열하면 응답은 빈 객체입니다. REST/HTTP 인터페이스를 사용하는 경우 응답에 빈 JSON 객체 {}이 포함됩니다. 예는 메일 목록 표시를 참고하세요. 다음 승인 범위 중 하나를 사용하여 사용자 인증이 필요합니다. https://www.googleapis.com/auth/chat.messages.readonly https://www.googleapis.com/auth/chat.messages https://www.googleapis.com/auth/chat.import (가져오기 모드 스페이스만 해당) 승인 범위 다음 OAuth 범위 중 하나가 필요합니다. https://www.googleapis.com/auth/chat.import https://www.googleapis.com/auth/chat.messages https://www.googleapis.com/auth/chat.messages.readonly 자세한 내용은 승인 가이드를 참고하세요.

ListReactions

rpc ListReactions(ListReactionsRequest) returns (ListReactionsResponse) 메시지에 대한 반응을 나열합니다. 예를 들어 메시지의 반응 목록 표시를 참고하세요. 다음 승인 범위 중 하나를 사용하여 사용자 인증이 필요합니다. https://www.googleapis.com/auth/chat.messages.reactions.readonly https://www.googleapis.com/auth/chat.messages.reactions https://www.googleapis.com/auth/chat.messages.readonly https://www.googleapis.com/auth/chat.messages 승인 범위 다음 OAuth 범위 중 하나가 필요합니다. https://www.googleapis.com/auth/chat.messages https://www.googleapis.com/auth/chat.messages.readonly https://www.googleapis.com/auth/chat.messages.reactions https://www.googleapis.com/auth/chat.messages.reactions.readonly 자세한 내용은 승인 가이드를 참고하세요.

ListSpaceEvents

rpc ListSpaceEvents(ListSpaceEventsRequest) returns (ListSpaceEventsResponse) Google Chat 스페이스의 이벤트를 나열합니다. 각 이벤트의 페이로드에는 Chat 리소스의 최신 버전이 포함됩니다. 예를 들어 새 스페이스 구성원에 관한 이벤트를 나열하면 서버는 최신 멤버십 세부정보가 포함된 Membership 리소스를 반환합니다. 요청된 기간 동안 새 회원이 삭제된 경우 이벤트 페이로드에 빈 Membership 리소스가 포함됩니다. 요청된 데이터를 읽는 데 적합한 승인 범위를 사용하여 사용자 인증이 필요합니다. https://www.googleapis.com/auth/chat.spaces.readonly https://www.googleapis.com/auth/chat.spaces https://www.googleapis.com/auth/chat.messages.readonly https://www.googleapis.com/auth/chat.messages https://www.googleapis.com/auth/chat.messages.reactions.readonly https://www.googleapis.com/auth/chat.messages.reactions https://www.googleapis.com/auth/chat.memberships.readonly https://www.googleapis.com/auth/chat.memberships 이벤트를 나열하려면 인증된 사용자가 스페이스의 구성원이어야 합니다. 예를 보려면 Google Chat 스페이스의 이벤트 나열을 참고하세요. 승인 범위 다음 OAuth 범위 중 하나가 필요합니다. https://www.googleapis.com/auth/chat.spaces https://www.googleapis.com/auth/chat.spaces.readonly https://www.googleapis.com/auth/chat.messages https://www.googleapis.com/auth/chat.messages.readonly https://www.googleapis.com/auth/chat.memberships https://www.googleapis.com/auth/chat.memberships.readonly https://www.googleapis.com/auth/chat.messages.reactions https://www.googleapis.com/auth/chat.messages.reactions.readonly 자세한 내용은 승인 가이드를 참고하세요.

ListSpaces

rpc ListSpaces(ListSpacesRequest) returns (ListSpacesResponse) 호출자가 속한 스페이스를 나열합니다. 그룹 채팅과 채팅 메시지는 첫 번째 메시지가 전송될 때까지 표시되지 않습니다. 예시는 스페이스 목록 표시를 참고하세요. 다음 유형의 인증을 지원합니다. 승인 범위가 있는 앱 인증: https://www.googleapis.com/auth/chat.bot 다음 승인 범위 중 하나를 사용한 사용자 인증 https://www.googleapis.com/auth/chat.spaces.readonly https://www.googleapis.com/auth/chat.spaces Google Workspace 조직별로 모든 명명된 스페이스를 나열하려면 대신 Workspace 관리자 권한을 사용하여 spaces.search() 메서드를 사용하세요. 승인 범위 다음 OAuth 범위 중 하나가 필요합니다. https://www.googleapis.com/auth/chat.spaces https://www.googleapis.com/auth/chat.spaces.readonly https://www.googleapis.com/auth/chat.bot 자세한 내용은 승인 가이드를 참고하세요.

SearchSpaces

rpc SearchSpaces(SearchSpacesRequest) returns (SearchSpacesResponse) 관리자의 검색을 기반으로 Google Workspace 조직의 스페이스 목록을 반환합니다. 관리자 권한이 있는 사용자 인증과 다음 승인 범위 중 하나가 필요합니다. https://www.googleapis.com/auth/chat.admin.spaces.readonly https://www.googleapis.com/auth/chat.admin.spaces 요청에서 use_admin_access를 true로 설정합니다. 승인 범위 다음 OAuth 범위 중 하나가 필요합니다. https://www.googleapis.com/auth/chat.admin.spaces https://www.googleapis.com/auth/chat.admin.spaces.readonly 자세한 내용은 승인 가이드를 참고하세요.

SetUpSpace

rpc SetUpSpace(SetUpSpaceRequest) returns (Space) 스페이스를 만들고 지정된 사용자를 추가합니다. 호출하는 사용자는 스페이스에 자동으로 추가되므로 요청에서 멤버십으로 지정하면 안 됩니다. 예시는 초기 구성원이 포함된 스페이스 설정을 참고하세요. 추가할 사용자 구성원을 지정하려면 적절한 membership.member.name로 멤버십을 추가합니다. 실제 사용자를 추가하려면 users/{user}를 사용하세요. 여기서 {user}은 사용자의 이메일 주소일 수 있습니다. 동일한 Workspace 조직의 사용자의 경우 {user}는 People API의 사용자 id 또는 Directory API의 사용자 id일 수도 있습니다. 예를 들어 [e-mail]의 People API Person 프로필 ID가 123456789인 경우 membership.member.name을 users/[e-mail] 또는 users/123456789로 설정하여 사용자를 스페이스에 추가할 수 있습니다. 추가할 Google 그룹을 지정하려면 적절한 membership.group_member.name로 멤버십을 추가하세요. Google 그룹을 추가하거나 초대하려면 groups/{group}를 사용하세요. 여기서 {group}은 Cloud ID 그룹스 API의 그룹 id입니다. 예를 들어 Cloud ID 그룹 조회 API를 사용하여 그룹 이메일 [e-mail]의 ID 123456789를 검색한 다음 membership.group_member.name을 groups/123456789로 설정하여 그룹을 스페이스에 추가할 수 있습니다. 그룹 이메일은 지원되지 않으며 Google 그룹은 이름이 지정된 스페이스에서만 구성원으로 추가할 수 있습니다. 이름이 지정된 스페이스 또는 그룹 채팅의 경우, 발신자가 일부 구성원을 차단하거나 일부 구성원에 의해 차단되거나 일부 구성원을 추가할 권한이 없는 경우 해당 구성원은 생성된 스페이스에 추가되지 않습니다. 호출하는 사용자와 다른 실제 사용자 간에 채팅 메시지 (DM)를 만들려면 실제 사용자를 나타내는 멤버십을 정확히 하나 지정하세요. 한 사용자가 다른 사용자를 차단하면 요청이 실패하고 DM이 생성되지 않습니다. 호출 사용자 및 호출 앱 간에 DM을 만들려면 Space.singleUserBotDm을 true로 설정하고 멤버십을 지정하지 마세요. 이 메서드는 호출 앱과의 DM을 설정하는 데만 사용할 수 있습니다. 호출 앱을 스페이스 또는 두 명의 실제 사용자 간 기존 DM의 구성원으로 추가하려면 스페이스에 사용자 또는 앱 초대 또는 추가하기를 참고하세요. 두 사용자 간에 DM이 이미 있는 경우, 요청이 이루어질 때 한 사용자가 다른 사용자를 차단하더라도 기존 DM이 반환됩니다. 스레드 답장이 있는 스페이스는 지원되지 않습니다. 스페이스를 설정할 때 ALREADY_EXISTS 오류 메시지가 표시되면 다른 displayName를 사용해 보세요. Google Workspace 조직 내의 기존 스페이스에서 이미 이 표시 이름을 사용하고 있을 수 있습니다. 다음 승인 범위 중 하나를 사용하여 사용자 인증이 필요합니다. https://www.googleapis.com/auth/chat.spaces.create https://www.googleapis.com/auth/chat.spaces 승인 범위 다음 OAuth 범위 중 하나가 필요합니다. https://www.googleapis.com/auth/chat.spaces https://www.googleapis.com/auth/chat.spaces.create 자세한 내용은 승인 가이드를 참고하세요.

UpdateMembership

rpc UpdateMembership(UpdateMembershipRequest) returns (Membership) 멤버십을 업데이트합니다. 예를 들어 스페이스에서 사용자의 멤버십 업데이트를 참고하세요. 다음 유형의 인증을 지원합니다. 개발자 미리보기의 관리자 승인을 사용하는 앱 인증 및 승인 범위: https://www.googleapis.com/auth/chat.app.memberships (앱에서 만든 스페이스에서만) 다음 승인 범위 중 하나를 사용한 사용자 인증 https://www.googleapis.com/auth/chat.memberships https://www.googleapis.com/auth/chat.import (가져오기 모드 스페이스만 해당) 사용자 인증은 관리자 계정이 인증되고 use_admin_access이 true이며 다음 승인 범위가 사용될 때 관리자 권한을 부여합니다. https://www.googleapis.com/auth/chat.admin.memberships 승인 범위 다음 OAuth 범위 중 하나가 필요합니다. https://www.googleapis.com/auth/chat.app.memberships https://www.googleapis.com/auth/chat.admin.memberships https://www.googleapis.com/auth/chat.import https://www.googleapis.com/auth/chat.memberships 자세한 내용은 승인 가이드를 참고하세요.

UpdateMessage

rpc UpdateMessage(UpdateMessageRequest) returns (Message) 메시지를 업데이트합니다. patch 메서드와 update 메서드 간에는 차이가 있습니다. patch 메서드는 patch 요청을 사용하고 update 메서드는 put 요청을 사용합니다. patch 메서드를 사용하는 것이 좋습니다. 예는 메시지 업데이트를 참고하세요. 다음 유형의 인증을 지원합니다. 승인 범위가 있는 앱 인증: https://www.googleapis.com/auth/chat.bot 다음 승인 범위 중 하나를 사용한 사용자 인증 https://www.googleapis.com/auth/chat.messages https://www.googleapis.com/auth/chat.import (가져오기 모드 스페이스만 해당) 앱 인증을 사용하는 경우 요청은 호출하는 Chat 앱에서 만든 메시지만 업데이트할 수 있습니다. 승인 범위 다음 OAuth 범위 중 하나가 필요합니다. https://www.googleapis.com/auth/chat.bot https://www.googleapis.com/auth/chat.import https://www.googleapis.com/auth/chat.messages 자세한 내용은 승인 가이드를 참고하세요.

UpdateSpace

rpc UpdateSpace(UpdateSpaceRequest) returns (Space) 스페이스를 업데이트합니다. 예를 보려면 스페이스 업데이트를 참고하세요. displayName 필드를 업데이트할 때 ALREADY_EXISTS 오류 메시지가 표시되면 다른 표시 이름을 사용해 보세요. Google Workspace 조직 내의 기존 스페이스에서 이미 이 표시 이름을 사용하고 있을 수 있습니다. 다음 유형의 인증을 지원합니다. 개발자 미리보기의 관리자 승인을 사용하는 앱 인증 및 다음 승인 범위 중 하나 https://www.googleapis.com/auth/chat.app.spaces 다음 승인 범위 중 하나를 사용한 사용자 인증 https://www.googleapis.com/auth/chat.spaces https://www.googleapis.com/auth/chat.import (가져오기 모드 스페이스만 해당) 사용자 인증은 관리자 계정이 인증되고 use_admin_access이 true이며 다음 승인 범위가 사용될 때 관리자 권한을 부여합니다. https://www.googleapis.com/auth/chat.admin.spaces 앱 인증에는 다음과 같은 제한사항이 있습니다. space.predefined_permission_settings 또는 space.permission_settings를 업데이트하려면 앱이 스페이스 생성자여야 합니다. 앱 인증에서는 space.access_settings.audience 업데이트가 지원되지 않습니다. 승인 범위 다음 OAuth 범위 중 하나가 필요합니다. https://www.googleapis.com/auth/chat.app.spaces https://www.googleapis.com/auth/chat.admin.spaces https://www.googleapis.com/auth/chat.import https://www.googleapis.com/auth/chat.spaces 자세한 내용은 승인 가이드를 참고하세요.

UpdateSpaceNotificationSetting
rpc UpdateSpaceNotificationSetting(UpdateSpaceNotificationSettingRequest) returns (SpaceNotificationSetting) 스페이스 알림 설정을 업데이트합니다. 예를 보려면 호출자의 스페이스 알림 설정 업데이트를 참고하세요. 승인 범위를 사용한 사용자 인증이 필요합니다. https://www.googleapis.com/auth/chat.users.spacesettings 승인 범위 다음 OAuth 범위가 필요합니다. https://www.googleapis.com/auth/chat.users.spacesettings 자세한 내용은 승인 가이드를 참고하세요.

UpdateSpaceReadState
rpc UpdateSpaceReadState(UpdateSpaceReadStateRequest) returns (SpaceReadState) 읽은 메시지와 읽지 않은 메시지를 식별하는 데 사용되며 스페이스 내에서 사용자의 읽기 상태를 업데이트합니다. 예를 보려면 사용자의 스페이스 읽기 상태 업데이트를 참고하세요. 승인 범위를 사용한 사용자 인증이 필요합니다. https://www.googleapis.com/auth/chat.users.readstate 승인 범위 다음 OAuth 범위가 필요합니다. https://www.googleapis.com/auth/chat.users.readstate 자세한 내용은 승인 가이드를 참고하세요.

AccessoryWidget

메일 하단에 표시되는 하나 이상의 대화형 위젯 자세한 내용은 메일 하단에 대화형 위젯 추가하기를 참고하세요.

필드
통합 필드 action. 작업 유형입니다. action은 다음 중 하나여야 합니다.
button_list	ButtonList 버튼 목록입니다.

ActionResponse

Chat 앱이 응답이 게시되는 방식을 구성하는 데 사용할 수 있는 매개변수입니다.

필드
type	ResponseType 입력 전용입니다. Chat 앱 응답 유형입니다.
url	string 입력 전용입니다. 사용자가 인증하거나 구성할 수 있는 URL입니다. (REQUEST_CONFIG 응답 유형에만 해당)
dialog_action	DialogAction 입력 전용입니다. 대화상자와 관련된 상호작용 이벤트에 대한 응답입니다. ResponseType.Dialog이 있어야 합니다.
updated_widget	UpdatedWidget 입력 전용입니다. 업데이트된 위젯의 응답입니다.

ResponseType

Chat 앱 응답 유형입니다.

열거형
TYPE_UNSPECIFIED	NEW_MESSAGE로 처리되는 기본 유형입니다.
NEW_MESSAGE	주제에 새 메시지로 게시합니다.
UPDATE_MESSAGE	Chat 앱의 메시지를 업데이트합니다. 메시지 발신자 유형이 BOT인 CARD_CLICKED 이벤트에서만 허용됩니다.
UPDATE_USER_MESSAGE_CARDS	사용자 메시지의 카드를 업데이트합니다. 이는 일치하는 URL이 있는 MESSAGE 이벤트 또는 메시지 발신자 유형이 HUMAN인 CARD_CLICKED 이벤트에 대한 응답으로만 허용됩니다. 텍스트가 무시됩니다.
REQUEST_CONFIG	사용자에게 추가 인증 또는 구성을 비공개로 요청합니다.
DIALOG	대화상자를 표시합니다.
UPDATE_WIDGET	위젯 텍스트 자동 완성 옵션 쿼리입니다.

SelectionItems

위젯 자동 완성 결과 목록입니다.

필드
items[]	SelectionItem SelectionItem 객체의 배열입니다.

UpdatedWidget

selectionInput 위젯의 경우 다중 선택 메뉴의 자동 완성 추천을 반환합니다.

필드
widget	string 업데이트된 위젯의 ID입니다. ID는 업데이트 요청을 트리거한 위젯의 ID와 일치해야 합니다.
통합 필드 updated_widget. 사용자 작업에 따라 업데이트된 위젯 updated_widget은 다음 중 하나여야 합니다.
suggestions	SelectionItems 위젯 자동 완성 결과 목록

ActionStatus

대화상자를 호출하거나 제출하는 요청의 상태를 나타냅니다.

필드
status_code	Code 상태 코드입니다.
user_facing_message	string 요청 상태에 관해 사용자에게 보낼 메시지입니다. 설정하지 않으면 status_code에 기반한 일반 메시지가 전송됩니다.

주석

주석은 메일의 일반 텍스트 본문 또는 start_index 및 length이 0인 Google Docs 또는 Sheets와 같은 Google Workspace 리소스에 연결되는 칩과 연결될 수 있습니다. 문자 메시지에 기본 서식을 추가하려면 문자 메시지 서식 지정을 참고하세요.

일반 텍스트 메시지 본문의 예:

Hello @FooBot how are you!"

해당 주석 메타데이터는 다음과 같습니다.

"annotations":[{
  "type":"USER_MENTION",
  "startIndex":6,
  "length":7,
  "userMention": {
    "user": {
      "name":"users/{user}",
      "displayName":"FooBot",
      "avatarUrl":"https://goo.gl/aeDtrS",
      "type":"BOT"
    },
    "type":"MENTION"
   }
}]

필드
type	AnnotationType 이 주석의 유형입니다.
length	int32 이 주석이 해당하는 일반 텍스트 메시지 본문의 하위 문자열 길이입니다. 없는 경우 길이가 0임을 나타냅니다.
start_index	int32 이 주석이 해당하는 일반 텍스트 메시지 본문의 시작 색인 (0부터 시작, 포함)입니다.
통합 필드 metadata. 주석에 관한 추가 메타데이터입니다. metadata은 다음 중 하나여야 합니다.
user_mention	UserMentionMetadata 사용자 멘션의 메타데이터입니다.
slash_command	SlashCommandMetadata 슬래시 명령어의 메타데이터입니다.
rich_link_metadata	RichLinkMetadata 리치 링크의 메타데이터입니다.
custom_emoji_metadata	CustomEmojiMetadata 맞춤 그림 이모티콘의 메타데이터입니다.

AnnotationType

주석의 유형입니다.

열거형
ANNOTATION_TYPE_UNSPECIFIED	enum의 기본값입니다. 사용하지 마세요.
USER_MENTION	사용자가 멘션됩니다.
SLASH_COMMAND	슬래시 명령어가 호출됩니다.
RICH_LINK	리치 링크 주석입니다.
CUSTOM_EMOJI	맞춤 그림 이모티콘 주석입니다.

AppCommandMetadata

Chat 앱 명령어에 관한 메타데이터입니다.

필드
app_command_id	int32 Chat API 구성에 지정된 명령어의 ID입니다.
app_command_type	AppCommandType 채팅 앱 명령어의 유형입니다.

AppCommandType

채팅 앱 명령어의 유형입니다. 자세한 내용은 Chat 앱 명령어 유형을 참고하세요.

열거형
APP_COMMAND_TYPE_UNSPECIFIED	기본값 지정되지 않음.
SLASH_COMMAND	슬래시 명령어입니다. 사용자가 Chat 메시지에서 명령어를 보냅니다.
QUICK_COMMAND	빠른 명령어 사용자가 메시지 답장 영역의 Chat 메뉴에서 명령어를 선택합니다.

AttachedGif

URL로 지정된 GIF 이미지입니다.

필드
uri	string 출력 전용입니다. GIF 이미지를 호스팅하는 URL입니다.

첨부파일

Google Chat의 첨부파일입니다.

필드
name	string 선택사항입니다. 첨부파일의 리소스 이름입니다(형식: spaces/{space}/messages/{message}/attachments/{attachment}).
content_name	string 출력 전용입니다. 콘텐츠의 원본 파일 이름입니다(전체 경로 아님).
content_type	string 출력 전용입니다. 파일의 콘텐츠 유형 (MIME 유형)입니다.
thumbnail_uri	string 출력 전용입니다. 사람 사용자에게 첨부파일을 미리 보는 데 사용해야 하는 썸네일 URL입니다. 채팅 앱은 이 URL을 사용하여 첨부파일 콘텐츠를 다운로드해서는 안 됩니다.
download_uri	string 출력 전용입니다. 사람이 첨부파일을 다운로드할 수 있도록 하는 데 사용해야 하는 다운로드 URL입니다. 채팅 앱은 이 URL을 사용하여 첨부파일 콘텐츠를 다운로드해서는 안 됩니다.
source	Source 출력 전용입니다. 첨부파일의 소스입니다.
통합 필드 data_ref. 첨부파일에 대한 데이터 참조입니다. data_ref은 다음 중 하나여야 합니다.
attachment_data_ref	AttachmentDataRef 선택사항입니다. 첨부파일 데이터에 대한 참조입니다. 이 필드는 첨부파일이 있는 메시지를 만들거나 업데이트하는 데 사용되며, 미디어 API를 사용하여 첨부파일 데이터를 다운로드하는 데도 사용됩니다.
drive_data_ref	DriveDataRef 출력 전용입니다. Google Drive 첨부파일에 대한 참조입니다. 이 필드는 Google Drive API와 함께 사용됩니다.

소스

첨부파일의 소스입니다.

열거형
SOURCE_UNSPECIFIED	예약됨
DRIVE_FILE	파일이 Google Drive 파일입니다.
UPLOADED_CONTENT	파일이 Chat에 업로드됩니다.

AttachmentDataRef

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

필드
resource_name	string 선택사항입니다. 첨부파일 데이터의 리소스 이름입니다. 이 필드는 미디어 API와 함께 사용하여 첨부파일 데이터를 다운로드합니다.
attachment_upload_token	string 선택사항입니다. 업로드된 첨부파일에 대한 참조가 포함된 불투명 토큰입니다. 클라이언트에서 불투명한 문자열로 처리되며 첨부파일이 있는 Chat 메시지를 만들거나 업데이트하는 데 사용됩니다.

CalendarEventLinkData

Calendar 일정 링크의 데이터입니다.

필드
calendar_id	string 연결된 캘린더의 캘린더 식별자입니다.
event_id	string 연결된 캘린더 일정의 이벤트 식별자입니다.

CardWithId

Google Chat 메시지의 카드입니다.

Chat 앱만 카드를 만들 수 있습니다. Chat 앱이 사용자로 인증되면 메시지에 카드를 포함할 수 없습니다.

카드 빌더로 카드를 디자인하고 미리보기합니다.

카드 빌더 열기

필드
card_id	string 메시지에 여러 카드가 포함된 경우 필수입니다. 메시지의 카드에 대한 고유 식별자입니다.
card	Card 카드 최대 크기는 32KB입니다.

ChatSpaceLinkData

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

필드
space	string 연결된 Chat 스페이스 리소스의 스페이스입니다. 형식: spaces/{space}
thread	string 연결된 Chat 스페이스 리소스의 대화목록입니다. 형식: spaces/{space}/threads/{thread}
message	string 연결된 Chat 스페이스 리소스의 메시지입니다. 형식: spaces/{space}/messages/{message}

CompleteImportSpaceRequest

스페이스의 가져오기 프로세스를 완료하기 위한 요청 메시지입니다.

필드
name	string 필수 항목입니다. 가져오기 모드 스페이스의 리소스 이름입니다. 형식: spaces/{space}

CompleteImportSpaceResponse

스페이스의 가져오기 프로세스를 완료하기 위한 응답 메시지입니다.

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

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	CustomEmoji 필수 항목입니다. 만들 맞춤 이모티콘입니다.

CreateMembershipRequest

멤버십 생성 요청 메시지입니다.

필드
parent	string 필수 항목입니다. 멤버십을 만들 스페이스의 리소스 이름입니다. 형식: spaces/{space}
membership	Membership 필수 항목입니다. 만들 멤버십 관계입니다. memberType 필드에는 user.name 및 user.type 필드가 채워진 사용자가 포함되어야 합니다. 서버에서 리소스 이름을 할당하고 지정된 항목을 덮어씁니다. 채팅 앱이 실제 사용자용 멤버십 관계를 만드는 경우 특정 승인 범위를 사용하고 특정 필드에 특정 값을 설정해야 합니다. 사용자로 인증할 때는 chat.memberships 승인 범위가 필요합니다. 앱으로 인증하는 경우 chat.app.memberships 승인 범위가 필요합니다. 앱으로 인증은 다음에서 사용할 수 있습니다. 개발자 프리뷰: 특정 기능에 대한 사전 액세스 권한을 부여하는 Google Workspace 개발자 프리뷰 프로그램의 일부로 제공됩니다. user.type을 HUMAN로 설정하고 user.name을 users/{user} 형식으로 설정합니다. 여기서 {user}은 사용자의 이메일 주소일 수 있습니다. 동일한 Workspace 조직의 사용자의 경우 {user}는 People API의 person의 id 또는 Directory API의 사용자의 id일 수도 있습니다. 예를 들어 [e-mail]의 People API Person 프로필 ID가 123456789인 경우 membership.member.name을 users/[e-mail] 또는 users/123456789로 설정하여 사용자를 스페이스에 추가할 수 있습니다. 스페이스를 소유한 Workspace 조직 외부의 사용자를 초대하려면 사용자 인증이 필요합니다. 채팅 앱이 자체 멤버십 관계를 만드는 경우 사용자로 인증하고 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 조직 외부 사용자의 멤버십을 만드는 것은 지원되지 않습니다.

CreateMessageRequest

메시지를 만듭니다.

필드
parent	string 필수 항목입니다. 메시지를 만들 스페이스의 리소스 이름입니다. 형식: spaces/{space}
message	Message 필수 항목입니다. 메일 본문입니다.
thread_key (deprecated)	string 이 항목은 지원 중단되었습니다. 선택사항입니다. 지원 중단됨: 대신 thread.thread_key를 사용하세요. 대화목록의 ID입니다. 최대 4,000자(영문 기준)까지 지원됩니다. 대화목록을 시작하거나 대화목록에 추가하려면 메시지를 만들고 threadKey 또는 thread.name을 지정합니다. 사용 예는 메시지 대화목록 시작 또는 답장하기를 참고하세요.
request_id	string 선택사항입니다. 이 메시지의 고유 요청 ID입니다. 기존 요청 ID를 지정하면 새 메시지가 생성되는 대신 해당 ID로 생성된 메시지가 반환됩니다.
message_reply_option	MessageReplyOption 선택사항입니다. 메시지가 대화목록을 시작하는지 아니면 대화목록에 답장하는지 지정합니다. 이름이 지정된 스페이스에서만 지원됩니다. 사용자 상호작용에 응답할 때는 이 필드가 무시됩니다. 대화목록 내 상호작용의 경우 답장이 동일한 대화목록에 생성됩니다. 그렇지 않으면 답장이 새 스레드로 생성됩니다.
message_id	string 선택사항입니다. 메시지의 맞춤 ID입니다. Chat 앱이 메시지의 리소스 이름 (메시지 name 필드에 표시됨)에 시스템 할당 ID를 저장하지 않고도 메시지를 가져오거나 업데이트하거나 삭제할 수 있습니다. 이 필드의 값은 다음 요구사항을 충족해야 합니다. client-로 시작합니다. 예를 들어 client-custom-name은 유효한 맞춤 ID이지만 custom-name은 그렇지 않습니다. 최대 63자(영문 기준)의 소문자, 숫자, 하이픈만 포함합니다. 스페이스 내에서 고유합니다. 채팅 앱은 서로 다른 메시지에 동일한 맞춤 ID를 사용할 수 없습니다. 자세한 내용은 메일 이름 지정하기를 참고하세요.

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	Reaction 필수 항목입니다. 만들 반응입니다.

CreateSpaceRequest

구성원이 없는 명명된 스페이스를 만들라는 요청입니다.

필드
space	Space 필수 항목입니다. displayName 및 spaceType 필드를 채워야 합니다. SpaceType.SPACE 및 SpaceType.GROUP_CHAT만 지원됩니다. SpaceType.GROUP_CHAT는 importMode이 true로 설정된 경우에만 사용할 수 있습니다. ALREADY_EXISTS 오류 메시지가 표시되면 다른 displayName를 사용해 보세요. Google Workspace 조직 내의 기존 스페이스에서 이미 이 표시 이름을 사용하고 있을 수 있습니다. name 공간은 서버에서 할당되므로 이 필드에 지정된 내용은 무시됩니다.
request_id	string 선택사항입니다. 이 요청의 고유 식별자입니다. 임의의 UUID를 사용하는 것이 좋습니다. 기존 요청 ID를 지정하면 새 스페이스가 생성되는 대신 해당 ID로 생성된 스페이스가 반환됩니다. 인증된 사용자가 다른 동일한 Chat 앱의 기존 요청 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	CustomEmoji 맞춤 이모티콘입니다.

DeleteCustomEmojiRequest

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

필드
name	string 필수 항목입니다. 삭제할 맞춤 그림 이모티콘의 리소스 이름입니다. 형식: customEmojis/{customEmoji} 그림 이모티콘 이름을 {customEmoji}의 별칭으로 사용할 수 있습니다. 예를 들어 customEmojis/:example-emoji:(여기서 :example-emoji:은 맞춤 이모티콘의 이모티콘 이름)

DeleteMembershipRequest

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

필드
name	string 필수 항목입니다. 삭제할 멤버십의 리소스 이름입니다. 채팅 앱은 실제 사용자의 멤버십 또는 자체 멤버십을 삭제할 수 있습니다. 채팅 앱은 다른 앱의 멤버십을 삭제할 수 없습니다. 사용자 멤버십을 삭제할 때는 사용자 인증이 있는 chat.memberships 범위 또는 앱 인증이 있는 chat.memberships.app 범위와 spaces/{space}/members/{member} 형식이 필요합니다. 이메일을 {member}의 별칭으로 사용할 수 있습니다. 예를 들어 spaces/{space}/members/[e-mail]에서 [e-mail]은 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 범위가 필요합니다. 관리 액세스를 사용하여 스페이스에서 앱 멤버십을 삭제하는 것은 지원되지 않습니다.

DeleteMessageRequest

메일 삭제 요청입니다.

필드
name	string 필수 항목입니다. 메시지의 리소스 이름입니다. 형식: spaces/{space}/messages/{message} 메시지에 맞춤 ID를 설정한 경우 clientAssignedMessageId 필드의 값을 {message}에 사용할 수 있습니다. 자세한 내용은 메일 이름 지정하기를 참고하세요.
force	bool 선택사항입니다. true의 경우 메시지를 삭제하면 스레드 형식의 답장도 삭제됩니다. false의 경우 메시지에 대화목록 답장이 있으면 삭제가 실패합니다. 사용자로 인증하는 경우에만 적용됩니다. Chat 앱으로 인증할 때는 아무런 영향을 주지 않습니다.

DeleteReactionRequest

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

필드
name	string 필수 항목입니다. 삭제할 반응의 이름입니다. 형식: spaces/{space}/messages/{message}/reactions/{reaction}

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 입력 전용입니다. 요청의 대화상자입니다.

DriveDataRef

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

필드
drive_file_id	string 드라이브 파일의 ID입니다. Drive API와 함께 사용합니다.

DriveLinkData

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

필드
drive_data_ref	DriveDataRef Google Drive 파일을 참조하는 DriveDataRef
mime_type	string 연결된 Google Drive 리소스의 MIME 유형입니다.

그림 이모티콘

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

필드
통합 필드 content. 필수 항목입니다. 이모티콘의 콘텐츠입니다. content은 다음 중 하나여야 합니다.
unicode	string 선택사항입니다. 유니코드 문자열로 표현된 기본 이모티콘입니다.
custom_emoji	CustomEmoji 맞춤 이모티콘입니다.

EmojiReactionSummary

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

필드
emoji	Emoji 출력 전용입니다. 반응과 연결된 그림 이모티콘입니다.
reaction_count	int32 출력 전용입니다. 연결된 그림 이모티콘을 사용한 반응의 총수입니다.

FindDirectMessageRequest

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

필드
name	string 필수 항목입니다. 채팅 메시지를 찾을 사용자의 리소스 이름입니다. 형식: users/{user}, 여기서 {user}은 People API의 person에 대한 id 또는 Directory API의 user에 대한 id입니다. 예를 들어 People API 프로필 ID가 123456789인 경우 users/123456789을 name로 사용하여 해당 사용자와의 쪽지를 찾을 수 있습니다. 사용자로 인증되면 이메일을 {user}의 별칭으로 사용할 수 있습니다. 예를 들어 users/[e-mail]에서 [e-mail]은 Google Chat 사용자의 이메일입니다.

GetAttachmentRequest

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

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

GetCustomEmojiRequest

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

필드
name	string 필수 항목입니다. 맞춤 이모티콘의 리소스 이름입니다. 형식: customEmojis/{customEmoji} 그림 이모티콘 이름을 {customEmoji}의 별칭으로 사용할 수 있습니다. 예를 들어 customEmojis/:example-emoji:(여기서 :example-emoji:은 맞춤 이모티콘의 이모티콘 이름)

GetMembershipRequest

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

필드
name	string 필수 항목입니다. 검색할 멤버십의 리소스 이름입니다. 사용자 인증을 사용하여 앱의 자체 멤버십을 가져오려면 선택적으로 spaces/{space}/members/app를 사용할 수 있습니다. 형식: spaces/{space}/members/{member} 또는 spaces/{space}/members/app 사용자의 이메일을 {member}의 별칭으로 사용할 수 있습니다. 예를 들어 spaces/{space}/members/[e-mail]에서 [e-mail]은 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} 메시지에 맞춤 ID를 설정한 경우 clientAssignedMessageId 필드의 값을 {message}에 사용할 수 있습니다. 자세한 내용은 메일 이름 지정하기를 참고하세요.

GetSpaceEventRequest

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

필드
name	string 필수 항목입니다. 스페이스 이벤트의 리소스 이름입니다. 형식: spaces/{space}/spaceEvents/{spaceEvent}

GetSpaceNotificationSettingRequest

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

필드
name	string 필수 항목입니다. 형식: users/{user}/spaces/{space}/spaceNotificationSetting users/me/spaces/{space}/spaceNotificationSetting 또는 users/[e-mail]/spaces/{space}/spaceNotificationSetting 또는 users/123456789/spaces/{space}/spaceNotificationSetting. 참고: 경로에는 호출자의 사용자 ID 또는 이메일만 허용됩니다.

GetSpaceReadStateRequest

GetSpaceReadState API 요청 메시지입니다.

필드
name	string 필수 항목입니다. 가져올 스페이스 읽기 상태의 리소스 이름입니다. 호출 사용자의 읽기 상태 가져오기만 지원합니다. 호출 사용자를 참조하려면 다음 중 하나를 설정하세요. me 별칭입니다. 예를 들면 다음과 같습니다. users/me/spaces/{space}/spaceReadState Workspace 이메일 주소 예를 들면 users/[e-mail]/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/[e-mail]/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 ID 그룹스 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[]	CustomEmoji 순서가 지정되지 않은 목록 맞춤 그림 이모티콘 목록입니다.
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[]	Membership 순서가 지정되지 않은 목록 요청된 페이지 (또는 첫 번째 페이지)의 멤버십 목록입니다.
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 연산자를 사용합니다. 스레드별로 필터링하려면 spaces/{space}/threads/{thread} 형식으로 지정된 thread.name를 지정합니다. 쿼리당 하나의 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 선택사항입니다. 삭제된 메일을 포함할지 여부입니다. 삭제된 메일에는 삭제 시간과 삭제에 관한 메타데이터가 포함되지만 메일 콘텐츠는 사용할 수 없습니다.

ListMessagesResponse

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

필드
messages[]	Message 메시지 목록입니다.
next_page_token	string 토큰을 pageToken으로 전송하여 결과의 다음 페이지를 검색할 수 있습니다. 비어 있으면 후속 페이지가 없습니다.

ListReactionsRequest

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

필드
parent	string 필수 항목입니다. 사용자가 반응한 메시지입니다. 형식: spaces/{space}/messages/{message}
page_size	int32 선택사항입니다. 반환되는 최대 반응 수입니다. 서비스는 이 값보다 적은 반응을 반환할 수 있습니다. 지정하지 않으면 기본값은 25입니다. 최댓값은 200이며, 200을 초과하는 값은 200으로 변경됩니다.
page_token	string 선택사항입니다. (이전 쿼리에서 재개하는 경우) 이전 목록 반응 호출에서 수신된 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다. 페이지로 나누는 경우 필터 값이 페이지 토큰을 제공한 호출과 일치해야 합니다. 다른 값을 전달하면 예기치 않은 결과가 발생할 수 있습니다.
filter	string 선택사항입니다. 쿼리 필터입니다. 그림 이모티콘 (emoji.unicode 또는 emoji.custom_emoji.uid) 및 사용자 (user.name)를 기준으로 반응을 필터링할 수 있습니다. 여러 그림 이모티콘 또는 사용자의 반응을 필터링하려면 emoji.unicode = "🙂" OR emoji.unicode = "👍", user.name = "users/AAAAAA" OR user.name = "users/BBBBBB"과 같이 유사한 필드를 OR 연산자로 결합하세요. 이모티콘 및 사용자별로 반응을 필터링하려면 emoji.unicode = "🙂" AND user.name = "users/AAAAAA"과 같은 AND 연산자를 사용합니다. 쿼리에서 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[]	Reaction 요청된 페이지 (또는 첫 번째 페이지)의 반응 목록입니다.
next_page_token	string 결과의 다음 페이지를 가져오기 위한 연속 토큰입니다. 결과의 마지막 페이지에서는 비어 있습니다.

ListSpaceEventsRequest

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

필드
parent	string 필수 항목입니다. 이벤트가 발생한 Google Chat 스페이스의 리소스 이름입니다. 형식: spaces/{space}
page_size	int32 선택사항입니다. 반환되는 최대 스페이스 이벤트 수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 음수 값은 INVALID_ARGUMENT 오류를 반환합니다.
page_token	string 선택사항입니다. 이전 목록 스페이스 이벤트 호출에서 수신된 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다. 페이지로 나눌 때 스페이스 이벤트 목록에 제공된 다른 모든 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다. 다른 매개변수에 다른 값을 전달하면 예기치 않은 결과가 발생할 수 있습니다.
filter	string 필수 항목입니다. 쿼리 필터입니다. has : 연산자를 사용하여 하나 이상의 이벤트 유형 (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[]	Space 요청된 페이지 (또는 첫 번째 페이지)의 스페이스 목록입니다. 참고: 목록 요청의 경우 스페이스 객체에 permissionSettings 필드가 반환되지 않습니다.
next_page_token	string 토큰을 pageToken으로 전송하여 결과의 다음 페이지를 검색할 수 있습니다. 비어 있으면 후속 페이지가 없습니다.

MatchedUrl

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

필드
url	string 출력 전용입니다. 일치한 URL입니다.

MeetSpaceLinkData

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

필드
meeting_code	string 연결된 Meet 스페이스의 회의 코드입니다.
type	Type Meet 스페이스의 유형을 나타냅니다.
huddle_status	HuddleStatus 선택사항입니다. 출력 전용입니다. Meet이 Huddle인 경우 Huddle의 상태를 나타냅니다. 그렇지 않으면 설정되지 않습니다.

HuddleStatus

허들 상태

열거형
HUDDLE_STATUS_UNSPECIFIED	enum의 기본값입니다. 사용하지 마세요.
STARTED	허들이 시작되었습니다.
ENDED	허들이 종료되었습니다. 이 경우 Meet 스페이스 URI와 식별자가 더 이상 유효하지 않습니다.
MISSED	부재중 Huddle입니다. 이 경우 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 선택사항입니다. 변경할 수 없습니다. 멤버가 스페이스를 탈퇴하거나 스페이스에서 삭제된 경우와 같은 멤버십 삭제 시간입니다. 이 필드는 가져오기 모드 스페이스에서 이전 멤버십을 가져오는 데 사용되는 경우를 제외하고 출력 전용입니다.
통합 필드 memberType. 이 멤버십과 연결된 회원입니다. 향후 다른 회원 유형이 지원될 수 있습니다. memberType은 다음 중 하나여야 합니다.
member	User 선택사항입니다. 멤버십이 해당하는 Google Chat 사용자 또는 앱입니다. Chat 앱이 사용자로 인증되면 출력에 user name 및 type가 채워집니다.
group_member	Group 선택사항입니다. 멤버십이 해당하는 Google 그룹입니다. Google 그룹의 멤버십을 읽거나 변경하려면 사용자 인증이 필요합니다.

MembershipRole

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

열거형
MEMBERSHIP_ROLE_UNSPECIFIED	기본값 users: 스페이스의 구성원이 아니지만 초대할 수 있습니다. Google Groups: 항상 이 역할이 할당됩니다 (향후 다른 enum 값이 사용될 수 있음).
ROLE_MEMBER	스페이스의 구성원입니다. 사용자에게 스페이스에 메시지를 보내는 등의 기본 권한이 있습니다. 1:1 및 이름이 지정되지 않은 그룹 대화에서는 모든 사용자에게 이 역할이 있습니다.
ROLE_MANAGER	스페이스 관리자 사용자에게는 모든 기본 권한과 회원을 추가하거나 삭제하는 등 스페이스를 관리할 수 있는 관리 권한이 있습니다. SpaceType.SPACE에서만 지원됩니다.

MembershipState

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

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

MembershipBatchCreatedEventData

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

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

필드
memberships[]	MembershipCreatedEventData 새 멤버십 목록입니다.

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	Membership 새 멤버십입니다.

MembershipDeletedEventData

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

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

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

MembershipUpdatedEventData

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

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

필드
membership	Membership 업데이트된 멤버십입니다.

메시지

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

필드
name	string 식별자. 메시지의 리소스 이름입니다. 형식: spaces/{space}/messages/{message} 여기서 {space}는 메시지가 게시된 스페이스의 ID이고 {message}는 메시지의 시스템 할당 ID입니다. spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB를 예로 들 수 있습니다. 메시지를 만들 때 맞춤 ID를 설정한 경우 {message}를 clientAssignedMessageId 필드의 값으로 대체하여 요청에서 메시지를 지정할 수 있습니다. spaces/AAAAAAAAAAA/messages/client-custom-name를 예로 들 수 있습니다. 자세한 내용은 메일 이름 지정하기를 참고하세요.
sender	User 출력 전용입니다. 메시지를 만든 사용자입니다. Chat 앱이 사용자로 인증되면 출력에 user 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와 같은 유니코드 이모티콘에는 적용되지 않습니다. 자세한 내용은 메시지로 전송된 텍스트 형식 보기를 참고하세요.
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 출력 전용입니다. 링크 미리보기 패턴과 일치하는 spaces.messages.text의 URL입니다. 자세한 내용은 링크 미리보기를 참고하세요.
thread_reply	bool 출력 전용입니다. true인 경우 메시지는 답장 스레드의 응답입니다. false인 경우 메시지는 스페이스의 최상위 대화에 대화목록의 첫 번째 메시지 또는 대화목록 답장이 없는 메시지로 표시됩니다. 스페이스에서 대화목록의 답장을 지원하지 않으면 이 필드는 항상 false입니다.
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 출력 전용입니다. 스페이스에서 Google Chat 사용자가 인용한 메시지에 관한 정보입니다. Google Chat 사용자는 메시지를 인용하여 답장할 수 있습니다.
attached_gifs[]	AttachedGif 출력 전용입니다. 메일에 첨부된 GIF 이미지입니다.
accessory_widgets[]	AccessoryWidget 선택사항입니다. 메일 하단에 표시되는 하나 이상의 대화형 위젯 텍스트, 카드 또는 텍스트와 카드를 모두 포함하는 메시지에 액세서리 위젯을 추가할 수 있습니다. 대화상자가 포함된 메시지에서는 지원되지 않습니다. 자세한 내용은 메일 하단에 대화형 위젯 추가하기를 참고하세요. 액세서리 위젯으로 메시지를 만들려면 앱 인증이 필요합니다.

MessageBatchCreatedEventData

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

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

필드
messages[]	MessageCreatedEventData 새 메시지 목록

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	Message 새 메시지입니다.

MessageDeletedEventData

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

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

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

MessageUpdatedEventData

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

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

필드
message	Message 업데이트된 메시지입니다.

QuotedMessageMetadata

인용된 메일에 대한 정보입니다.

필드
name	string 출력 전용입니다. 인용된 메시지의 리소스 이름입니다. 형식: spaces/{space}/messages/{message}
last_update_time	Timestamp 출력 전용입니다. 인용된 메시지가 생성된 시간 또는 인용된 메시지가 마지막으로 업데이트된 시간의 타임스탬프입니다.

리액션

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

필드
name	string 식별자. 반응의 리소스 이름입니다. 형식: spaces/{space}/messages/{message}/reactions/{reaction}
user	User 출력 전용입니다. 반응을 만든 사용자입니다.
emoji	Emoji 필수 항목입니다. 반응에 사용된 그림 이모티콘입니다.

ReactionBatchCreatedEventData

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

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

필드
reactions[]	ReactionCreatedEventData 새 반응 목록입니다.

ReactionBatchDeletedEventData

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

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

필드
reactions[]	ReactionDeletedEventData 삭제된 반응 목록입니다.

ReactionCreatedEventData

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

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

필드
reaction	Reaction 새 반응입니다.

ReactionDeletedEventData

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

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

필드
reaction	Reaction 삭제된 반응입니다.

RichLinkMetadata

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

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

RichLinkType

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

열거형
RICH_LINK_TYPE_UNSPECIFIED	enum의 기본값입니다. 사용하지 마세요.
DRIVE_FILE	Google Drive 리치 링크 유형입니다.
CHAT_SPACE	Chat 스페이스 리치 링크 유형입니다. 예를 들어 스페이스 스마트 칩이 있습니다.
MEET_SPACE	Meet 메시지 리치 링크 유형입니다. 예를 들어 Meet 칩이 있습니다.
CALENDAR_EVENT	캘린더 메시지 리치 링크 유형입니다. 예를 들어 캘린더 칩이 있습니다.

SearchSpacesRequest

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

필드
use_admin_access	bool true인 경우 메서드는 사용자의 Google Workspace 관리자 권한을 사용하여 실행됩니다. 호출하는 사용자는 채팅 및 스페이스 대화 관리 권한이 있는 Google Workspace 관리자여야 합니다. chat.admin.spaces.readonly 또는 chat.admin.spaces OAuth 2.0 범위가 필요합니다. 이 메서드는 현재 관리자 액세스만 지원하므로 이 필드에는 true만 허용됩니다.
page_size	int32 반환할 최대 스페이스 수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 지정하지 않으면 최대 100개의 스페이스가 반환됩니다. 최댓값은 1,000입니다. 1,000보다 큰 값을 사용하면 자동으로 1,000으로 변경됩니다.
page_token	string 이전 검색 공간 호출에서 수신된 토큰입니다. 후속 페이지를 검색하려면 이 매개변수를 제공하세요. 페이지로 나누는 경우 제공된 다른 모든 매개변수가 페이지 토큰을 제공한 호출과 일치해야 합니다. 다른 매개변수에 다른 값을 전달하면 예기치 않은 결과가 발생할 수 있습니다.
query	string 필수 항목입니다. 검색어입니다. 다음 매개변수를 사용하여 검색할 수 있습니다. create_time customer display_name external_user_allowed last_active_time space_history_state space_type create_time 및 last_active_time은 RFC-3339 형식의 타임스탬프를 허용하며 지원되는 비교 연산자는 =, <, >, <=, >=입니다. customer는 필수이며 스페이스를 가져올 고객을 나타내는 데 사용됩니다. 유일하게 지원되는 값은 customers/my_customer입니다. display_name은 HAS (:) 연산자만 허용합니다. 일치시킬 텍스트는 먼저 토큰으로 토큰화되고 각 토큰은 스페이스의 display_name에 있는 하위 문자열로 대소문자를 구분하지 않고 독립적으로 프리픽스 일치됩니다. 예를 들어 Fun Eve는 Fun event 또는 The evening was fun과 일치하지만 notFun event 또는 even과는 일치하지 않습니다. 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"과 같은 간격을 나타내는 데만 사용할 수 있습니다. 다음은 유효한 쿼리의 예입니다. 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")
order_by	string 선택사항입니다. 스페이스 목록이 정렬되는 방식입니다. 정렬 기준으로 지원되는 속성은 다음과 같습니다. membership_count.joined_direct_human_user_count - 스페이스에 직접 참여한 실제 사용자 수를 나타냅니다. last_active_time - 이 스페이스의 주제에 마지막으로 적격 항목이 추가된 시간을 나타냅니다. create_time - 스페이스 생성 시간을 나타냅니다. 유효한 정렬 작업 값은 다음과 같습니다. 오름차순의 경우 ASC를 사용합니다. 기본값 내림차순의 경우 DESC 지원되는 구문은 다음과 같습니다. 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

SearchSpacesResponse

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

필드
spaces[]	Space 요청된 스페이스의 페이지입니다.
next_page_token	string 다음 페이지를 검색하는 데 사용할 수 있는 토큰입니다. 이 필드가 비어 있으면 후속 페이지가 없습니다.
total_size	int32 모든 페이지에서 쿼리와 일치하는 스페이스의 총수입니다. 결과가 10,000개 이상의 스페이스인 경우 이 값은 추정치입니다.

SetUpSpaceRequest

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

필드
space	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를 설정하지 마세요. 사람과 호출하는 채팅 앱 간의 1:1 대화를 만들려면 Space.spaceType을 DIRECT_MESSAGE로, Space.singleUserBotDm을 true로 설정합니다. Space.displayName 또는 Space.spaceDetails를 설정하지 마세요. DIRECT_MESSAGE 스페이스가 이미 있는 경우 새 스페이스를 만드는 대신 해당 스페이스가 반환됩니다.
request_id	string 선택사항입니다. 이 요청의 고유 식별자입니다. 임의의 UUID를 사용하는 것이 좋습니다. 기존 요청 ID를 지정하면 새 스페이스가 생성되는 대신 해당 ID로 생성된 스페이스가 반환됩니다. 인증된 사용자가 다른 동일한 Chat 앱의 기존 요청 ID를 지정하면 오류가 반환됩니다.
memberships[]	Membership 선택사항입니다. 스페이스에 참여하도록 초대할 Google Chat 사용자 또는 그룹입니다. 호출하는 사용자는 자동으로 추가되므로 생략합니다. 현재 이 세트에서는 호출자 외에 최대 49개의 멤버십이 허용됩니다. 인간 구성원의 경우 Membership.member 필드에는 name가 채워지고 (형식: users/{user}) type이 User.Type.HUMAN로 설정된 user가 포함되어야 합니다. 스페이스를 설정할 때는 실제 사용자만 추가할 수 있습니다 (채팅 앱 추가는 호출 앱과의 채팅 메시지 설정에만 지원됨). 사용자의 이메일을 {user}의 별칭으로 사용하여 구성원을 추가할 수도 있습니다. 예를 들어 user.name은 users/[e-mail]일 수 있습니다. 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 Space.spaceType을 DIRECT_MESSAGE로, Space.singleUserBotDm을 true로 설정하는 경우 사람과 호출 Chat 앱 간의 1:1 대화를 만들 때 비어 있어야 합니다.

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 앱 간의 일대일 메시지입니다.

필드
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 앱과 단일 사용자 간의 DM인지 여부입니다.
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 고객 리소스]( https://developers.google.com/admin-sdk/directory/reference/rest/v1/customers))의 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 범위로 관리자 승인을 사용하는 앱 인증 채팅 앱이 스페이스를 만든 경우에만 채워지고 설정할 수 있습니다. 사용자 인증

AccessSettings

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

필드
access_state	AccessState 출력 전용입니다. 스페이스의 액세스 상태를 나타냅니다.
audience	string 선택사항입니다. 스페이스를 검색하고, 스페이스에 참여하고, 스페이스의 메시지를 미리 볼 수 있는 대상 그룹의 리소스 이름입니다. 설정되지 않은 경우 스페이스에 개별적으로 초대되거나 추가된 사용자 또는 Google 그룹스만 스페이스에 액세스할 수 있습니다. 자세한 내용은 공유 대상 그룹에 스페이스가 표시되도록 설정하기를 참고하세요. 형식: audiences/{audience} Google Workspace 조직의 기본 공유 대상 그룹을 사용하려면 audiences/default로 설정합니다. 대상 그룹 읽기는 다음을 지원합니다. 사용자 인증 chat.app.spaces 범위의 관리자 승인을 사용하는 앱 인증 개발자 프리뷰: 특정 기능에 대한 사전 액세스 권한을 부여하는 Google Workspace 개발자 프리뷰 프로그램의 일부로 제공됩니다. 앱 인증과 함께 chat.bot 범위를 사용하는 경우 이 필드는 채워지지 않습니다. 공유 대상 그룹을 설정하려면 사용자 인증이 필요합니다.

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 선택사항입니다. 스페이스 관리자에게 이 권한이 있는지 여부입니다.
members_allowed	bool 선택사항입니다. 관리자가 아닌 구성원에게 이 권한이 있는지 여부입니다.

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 선택사항입니다. 스페이스에서 메시지에 답장하기 위한 설정입니다.

PredefinedPermissionSettings

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

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

SpaceDetails

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

필드
description	string 선택사항입니다. 스페이스에 대한 설명입니다. 예를 들어 스페이스의 토론 주제, 기능적 목적 또는 참여자를 설명합니다. 최대 150자까지 지원합니다.
guidelines	string 선택사항입니다. 스페이스의 규칙, 기대치, 에티켓 최대 5,000자(영문 기준)까지 지원합니다.

SpaceThreadingState

채팅 스페이스의 스레딩 상태 유형을 지정합니다.

열거형
SPACE_THREADING_STATE_UNSPECIFIED	예약됨
THREADED_MESSAGES	메시지 대화목록을 지원하는 이름이 지정된 스페이스 사용자가 메시지에 응답할 때 스레드 내에서 답장할 수 있으며, 이렇게 하면 답장이 원본 메시지의 컨텍스트에 유지됩니다.
GROUPED_MESSAGES	대화가 주제별로 정리된 명명된 스페이스 주제와 답장이 그룹화됩니다.
UNTHREADED_MESSAGES	두 사용자 간의 채팅 메시지 (DM) 및 세 명 이상의 사용자 간의 그룹 대화

SpaceType

스페이스 유형입니다. 스페이스를 만들거나 업데이트할 때 필요합니다. 기타 사용량의 출력 전용입니다.

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

유형

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

열거형
TYPE_UNSPECIFIED	예약됨
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	예약됨
UNMUTED	사용자는 알림 설정에 따라 스페이스에 대한 알림을 받게 됩니다.
MUTED	알림 설정과 관계없이 사용자에게 스페이스 알림이 전송되지 않습니다.

NotificationSetting

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

열거형
NOTIFICATION_SETTING_UNSPECIFIED	예약됨
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	Space 업데이트된 스페이스입니다.

스레드

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

메일을 만들 때 스레드를 지정하는 경우 messageReplyOption 필드를 설정하여 일치하는 스레드를 찾을 수 없는 경우의 동작을 결정할 수 있습니다.

필드
name	string 식별자. 대화목록의 리소스 이름입니다. 예: spaces/{space}/threads/{thread}
thread_key	string 선택사항입니다. 스레드를 만들거나 업데이트하기 위한 입력입니다. 그렇지 않으면 출력만 합니다. 대화목록의 ID입니다. 최대 4,000자(영문 기준)까지 지원됩니다. 이 ID는 설정한 채팅 앱에 고유합니다. 예를 들어 여러 채팅 앱에서 동일한 스레드 키를 사용하여 메시지를 만드는 경우 메시지는 서로 다른 스레드에 게시됩니다. 사용자 또는 다른 Chat 앱에서 만든 대화목록에 답장하려면 대신 대화목록 name 필드를 지정하세요.

ThreadReadState

읽은 메일과 읽지 않은 메일을 식별하는 데 사용되는 스레드 내 사용자의 읽기 상태입니다.

필드
name	string 스레드 읽기 상태의 리소스 이름입니다. 형식: users/{user}/spaces/{space}/threads/{thread}/threadReadState
last_read_time	Timestamp 사용자의 스레드 읽기 상태가 업데이트된 시간입니다. 일반적으로 이는 대화목록에서 마지막으로 읽은 메시지의 타임스탬프에 해당합니다.

UpdateMembershipRequest

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

필드
membership	Membership 필수 항목입니다. 업데이트할 멤버십입니다. update_mask로 지정된 필드만 업데이트됩니다.
update_mask	FieldMask 필수 항목입니다. 업데이트할 필드 경로입니다. 쉼표로 여러 값을 구분하거나 *를 사용하여 모든 필드 경로를 업데이트합니다. 현재 지원되는 필드 경로: role
use_admin_access	bool 선택사항입니다. true인 경우 메서드는 사용자의 Google Workspace 관리자 권한을 사용하여 실행됩니다. 호출하는 사용자는 채팅 및 스페이스 대화 관리 권한이 있는 Google Workspace 관리자여야 합니다. chat.admin.memberships OAuth 2.0 범위가 필요합니다.

UpdateMessageRequest

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

필드
message	Message 필수 항목입니다. 필드가 업데이트된 메시지입니다.
update_mask	FieldMask 필수 항목입니다. 업데이트할 필드 경로입니다. 쉼표로 여러 값을 구분하거나 *를 사용하여 모든 필드 경로를 업데이트합니다. 현재 지원되는 필드 경로: text attachment cards (앱 인증 필요) cards_v2 (앱 인증 필요) accessory_widgets (앱 인증 필요)
allow_missing	bool 선택사항입니다. true 및 메시지를 찾을 수 없는 경우 새 메시지가 생성되고 updateMask은 무시됩니다. 지정된 메시지 ID는 클라이언트 할당이어야 하며, 그렇지 않으면 요청이 실패합니다.

UpdateSpaceNotificationSettingRequest

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

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

UpdateSpaceReadStateRequest

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

필드
space_read_state	SpaceReadState 필수 항목입니다. 업데이트할 스페이스 읽기 상태 및 필드입니다. 호출 사용자의 읽기 상태 업데이트만 지원합니다. 호출 사용자를 참조하려면 다음 중 하나를 설정하세요. me 별칭입니다. 예를 들면 다음과 같습니다. users/me/spaces/{space}/spaceReadState Workspace 이메일 주소 예를 들면 users/[e-mail]/spaces/{space}/spaceReadState입니다. 사용자 ID입니다. 예를 들면 users/123456789/spaces/{space}/spaceReadState입니다. 형식: users/{user}/spaces/{space}/spaceReadState
update_mask	FieldMask 필수 항목입니다. 업데이트할 필드 경로입니다. 현재 지원되는 필드 경로: last_read_time last_read_time이 최신 메시지 생성 시간보다 이전이면 스페이스가 UI에서 읽지 않은 상태로 표시됩니다. 스페이스를 읽음으로 표시하려면 최신 메시지 생성 시간보다 나중 (더 큼)의 값으로 last_read_time를 설정합니다. last_read_time는 최신 메시지 생성 시간과 일치하도록 강제됩니다. 스페이스 읽기 상태는 스페이스의 최상위 대화에 표시되는 메시지의 읽기 상태에만 영향을 미칩니다. 대화목록의 답장에는 이 타임스탬프가 적용되지 않으며 대신 대화목록 읽기 상태가 사용됩니다.

UpdateSpaceRequest

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

필드
space	Space 필수 항목입니다. 업데이트할 필드가 있는 스페이스입니다. Space.name은 spaces/{space} 형식으로 채워져야 합니다. update_mask로 지정된 필드만 업데이트됩니다.
update_mask	FieldMask 필수 항목입니다. 업데이트된 필드 경로입니다. 여러 개인 경우 쉼표로 구분됩니다. 스페이스에 대해 다음 필드를 업데이트할 수 있습니다. space_details: 스페이스의 설명을 업데이트합니다. 최대 150자까지 지원합니다. display_name: spaceType 필드가 SPACE인 스페이스의 표시 이름 업데이트만 지원합니다. ALREADY_EXISTS 오류 메시지가 표시되면 다른 값을 사용해 보세요. Google Workspace 조직 내의 기존 스페이스에서 이미 이 표시 이름을 사용하고 있을 수 있습니다. space_type: GROUP_CHAT 스페이스 유형을 SPACE로 변경하는 것만 지원합니다. 업데이트 마스크에 display_name와 space_type를 함께 포함하고 지정된 스페이스에 비어 있지 않은 표시 이름과 SPACE 스페이스 유형이 있는지 확인합니다. 기존 스페이스에 이미 SPACE 유형이 있는 경우 표시 이름을 업데이트할 때 지정된 스페이스에 space_type 마스크와 SPACE 유형을 포함하는 것은 선택사항입니다. 다른 방법으로 스페이스 유형을 업데이트하려고 하면 잘못된 인자 오류가 발생합니다. space_type은 useAdminAccess에서 지원되지 않습니다. space_history_state: 스페이스의 기록을 사용 설정 또는 사용 중지하여 스페이스 기록 설정을 업데이트합니다. Google Workspace 조직에 기록 설정이 사용 설정된 경우에만 지원됩니다. 스페이스 기록 상태를 업데이트하려면 요청에서 다른 모든 필드 마스크를 생략해야 합니다. space_history_state은 useAdminAccess에서 지원되지 않습니다. access_settings.audience: spaceType 필드가 SPACE인 명명된 스페이스에서 스페이스를 검색하고, 스페이스에 참여하고, 메시지를 미리 볼 수 있는 사용자의 액세스 설정을 업데이트합니다. 기존 스페이스에 공유 대상 그룹이 있는 경우 이 필드 마스크의 값을 생략하여 공유 대상 그룹을 삭제하고 스페이스 액세스를 제한할 수 있습니다. 스페이스의 액세스 설정을 업데이트하려면 인증된 사용자가 스페이스 관리자여야 하며 요청에서 다른 모든 필드 마스크를 생략해야 합니다. 스페이스가 가져오기 모드인 경우 이 필드를 업데이트할 수 없습니다. 자세한 내용은 특정 사용자가 스페이스를 검색할 수 있도록 설정하기를 참고하세요. access_settings.audience은 useAdminAccess에서 지원되지 않습니다. permission_settings: 스페이스의 권한 설정 변경을 지원합니다. 권한 설정을 업데이트할 때는 permissionSettings 필드 마스크만 지정할 수 있으며 다른 필드 마스크는 동시에 업데이트할 수 없습니다. permissionSettings은 useAdminAccess에서 지원되지 않습니다. 지원되는 필드 마스크는 다음과 같습니다. permission_settings.manageMembersAndGroups permission_settings.modifySpaceDetails permission_settings.toggleHistory permission_settings.useAtMentionAll permission_settings.manageApps permission_settings.manageWebhooks permission_settings.replyMessages
use_admin_access	bool 선택사항입니다. true인 경우 메서드는 사용자의 Google Workspace 관리자 권한을 사용하여 실행됩니다. 호출하는 사용자는 채팅 및 스페이스 대화 관리 권한이 있는 Google Workspace 관리자여야 합니다. chat.admin.spaces OAuth 2.0 범위가 필요합니다. 일부 FieldMask 값은 관리자 액세스를 사용하여 지원되지 않습니다. 자세한 내용은 update_mask 설명을 참고하세요.

사용자

Google Chat의 사용자입니다. 요청의 출력으로 반환될 때 Chat 앱이 사용자로 인증되면 User 리소스의 출력은 사용자의 name 및 type만 채웁니다.

필드
name	string Google Chat user의 리소스 이름입니다. 형식: users/{user} users/app은 호출 앱 bot 사용자의 별칭으로 사용할 수 있습니다. human users의 경우 {user}은 다음과 동일한 사용자 식별자입니다. People API의 Person에 대한 id 예를 들어 Chat API의 users/123456789는 People API의 123456789 Person 프로필 ID와 동일한 사람을 나타냅니다. Admin SDK Directory API의 사용자에 대한 id 사용자의 이메일 주소를 API 요청에서 {user}의 별칭으로 사용할 수 있습니다. 예를 들어 [e-mail]의 People API Person 프로필 ID가 123456789인 경우 users/[e-mail]을 별칭으로 사용하여 users/123456789을 참조할 수 있습니다. 표준 리소스 이름 (예: users/123456789)만 API에서 반환됩니다.
display_name	string 출력 전용입니다. 사용자의 표시 이름입니다.
domain_id	string 사용자의 Google Workspace 도메인의 고유 식별자입니다.
type	Type 사용자 유형입니다.
is_anonymous	bool 출력 전용입니다. true인 경우 사용자가 삭제되거나 프로필이 표시되지 않습니다.

유형

열거형
TYPE_UNSPECIFIED	enum의 기본값입니다. 사용하지 않습니다.
HUMAN	실제 사용자
BOT	채팅 앱 사용자입니다.

UserMentionMetadata

사용자 멘션 (@)의 주석 메타데이터입니다.

필드
user	User 멘션된 사용자입니다.
type	Type 사용자 멘션 유형입니다.

유형

열거형
TYPE_UNSPECIFIED	enum의 기본값입니다. 사용하지 마세요.
ADD	스페이스에 사용자를 추가합니다.
MENTION	스페이스에서 사용자 멘션

WidgetMarkup

위젯은 텍스트와 이미지를 표시하는 UI 요소입니다.

필드
buttons[]	Button 버튼 목록입니다. 버튼도 oneof data이며 이 필드 중 하나만 설정해야 합니다.
통합 필드 data. WidgetMarkup에는 다음 항목 중 하나만 있을 수 있습니다. WidgetMarkup 필드를 여러 개 사용하여 항목을 더 많이 표시할 수 있습니다. data은 다음 중 하나여야 합니다.
text_paragraph	TextParagraph 이 위젯에 텍스트 단락을 표시합니다.
image	Image 이 위젯에 이미지를 표시합니다.
key_value	KeyValue 이 위젯에 키 값 항목을 표시합니다.

버튼

버튼 텍스트 버튼 또는 이미지 버튼일 수 있습니다.

필드
통합 필드 type. type는 다음 중 하나여야 합니다.
text_button	TextButton 텍스트와 onclick 작업이 있는 버튼
image_button	ImageButton 이미지와 onclick 작업이 있는 버튼

FormAction

양식 작업은 양식이 제출될 때의 동작을 설명합니다. 예를 들어 Apps Script를 호출하여 양식을 처리할 수 있습니다.

필드
action_method_name	string 메서드 이름은 양식 제출을 트리거한 양식의 부분을 식별하는 데 사용됩니다. 이 정보는 카드 클릭 이벤트의 일부로 채팅 앱에 다시 에코됩니다. 공통 동작을 트리거하는 여러 요소에 동일한 메서드 이름을 사용할 수 있습니다.
parameters[]	ActionParameter 작업 매개변수 목록입니다.

ActionParameter

작업 메서드가 호출될 때 제공할 문자열 매개변수 목록입니다. 예를 들어 지금 스누즈, 하루 스누즈, 다음 주 스누즈라는 세 개의 스누즈 버튼을 생각해 보세요. 문자열 매개변수 목록에 스누즈 유형과 스누즈 시간을 전달하는 action method = snooze()를 사용할 수 있습니다.

필드
key	string 작업 스크립트의 매개변수 이름입니다.
value	string 매개변수의 값입니다.

아이콘

지원되는 아이콘 집합입니다.

열거형
ICON_UNSPECIFIED
AIRPLANE
BOOKMARK
BUS
CAR
CLOCK
CONFIRMATION_NUMBER_ICON
DOLLAR
DESCRIPTION
EMAIL
EVENT_PERFORMER
EVENT_SEAT
FLIGHT_ARRIVAL
FLIGHT_DEPARTURE
HOTEL
HOTEL_ROOM_TYPE
INVITE
MAP_PIN
MEMBERSHIP
MULTIPLE_PEOPLE
OFFER
PERSON
PHONE
RESTAURANT_ICON
SHOPPING_CART
STAR
STORE
TICKET
TRAIN
VIDEO_CAMERA
VIDEO_PLAY

이미지

URL로 지정되고 onclick 작업이 있을 수 있는 이미지입니다.

필드
image_url	string 이미지의 URL입니다.
on_click	OnClick onclick 작업
aspect_ratio	double 이 이미지의 가로세로 비율 (너비 및 높이)입니다. 이 필드를 사용하면 이미지가 로드되는 동안 이미지의 올바른 높이를 예약할 수 있습니다. 이미지의 기본 가로세로 비율을 재정의하기 위한 것이 아닙니다. 설정되지 않은 경우 서버는 이미지를 미리 가져와서 이를 채웁니다.

ImageButton

onclick 작업이 있는 이미지 버튼

필드
on_click	OnClick onclick 작업
name	string 접근성에 사용되는 이 image_button의 이름입니다. 이 이름을 지정하지 않으면 기본값이 제공됩니다.
통합 필드 icons. 아이콘은 Icon enum 또는 URL로 지정할 수 있습니다. icons은 다음 중 하나여야 합니다.
icon	Icon Chat API에서 제공하는 아이콘을 색인화하는 enum로 지정된 아이콘입니다.
icon_url	string URL로 지정된 아이콘입니다.

KeyValue

UI 요소에는 키 (라벨)와 값 (콘텐츠)이 포함됩니다. 이 요소는 onclick 버튼과 같은 일부 작업도 포함할 수 있습니다.

필드
top_label	string 상단 라벨의 텍스트입니다. 서식이 지정된 텍스트가 지원됩니다. 텍스트 서식 지정에 대한 자세한 내용은 Google Chat 앱의 텍스트 서식 지정 및 Google Workspace 부가기능의 텍스트 서식 지정을 참고하세요.
content	string 콘텐츠의 텍스트입니다. 형식이 지정된 텍스트가 지원되며 항상 필요합니다. 텍스트 서식 지정에 대한 자세한 내용은 Google Chat 앱의 텍스트 서식 지정 및 Google Workspace 부가기능의 텍스트 서식 지정을 참고하세요.
content_multiline	bool 콘텐츠가 여러 줄이어야 하는 경우
bottom_label	string 하단 라벨의 텍스트입니다. 서식이 지정된 텍스트가 지원됩니다. 텍스트 서식 지정에 대한 자세한 내용은 Google Chat 앱의 텍스트 서식 지정 및 Google Workspace 부가기능의 텍스트 서식 지정을 참고하세요.
on_click	OnClick onclick 작업 상단 라벨, 하단 라벨, 콘텐츠 영역만 클릭할 수 있습니다.
통합 필드 icons. 아이콘, top_label, bottom_label 중 하나 이상을 정의해야 합니다. icons은 다음 중 하나여야 합니다.
icon	Icon Chat API에서 해당 아이콘 이미지로 대체되는 enum 값입니다.
icon_url	string URL로 지정된 아이콘입니다.
통합 필드 control. 제어 위젯입니다. button 또는 switch_widget 중 하나를 설정할 수 있지만 둘 다 설정할 수는 없습니다. control은 다음 중 하나여야 합니다.
button	Button 클릭하여 작업을 트리거할 수 있는 버튼입니다.

OnClick

onclick 작업 (예: 링크 열기)

필드
통합 필드 data. data는 다음 중 하나여야 합니다.
action	FormAction 지정된 경우 이 onclick 작업에 의해 양식 작업이 트리거됩니다.
open_link	OpenLink 이 onclick 작업은 지정된 경우 링크 열기 작업을 트리거합니다.

OpenLink

새 창을 여는 링크

필드
url	string 열 URL입니다.

TextButton

텍스트와 onclick 작업이 있는 버튼

필드
text	string 버튼의 텍스트입니다.
on_click	OnClick 버튼의 onclick 작업입니다.

TextParagraph

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

필드
text	string