Google Chat에서 일정 작업하기

이 페이지에서는 Google Chat 앱이 Google Chat의 이벤트를 수신하고 이에 응답하는 방법을 설명합니다.

Google Chat 이벤트는 스페이스의 새 메시지와 같이 Chat의 활동 또는 변경사항을 나타냅니다. 채팅 앱은 이벤트를 사용하여 발생한 상황을 이해하고 사용자에게 의미 있는 방식으로 조치를 취하거나 응답할 수 있습니다.

다음은 이벤트를 사용하는 방법의 몇 가지 예입니다.

• 키워드나 구문을 확인하는 등 스페이스에서 새 메시지를 모니터링하고 응답합니다.
• 스페이스에 참여하는 사용자에게 환영 메시지를 보내 스페이스 가이드라인을 설명하거나 Chat 앱을 효과적으로 사용하는 방법에 관한 팁을 공유합니다.
• Chat 활동을 추적하고 분석합니다. 예를 들어 신규 회원 또는 반응이나 답장이 가장 많은 메시지에 대한 월간 보고서를 보낼 수 있습니다.
• 메시지 플랫폼 간 커뮤니케이션 예를 들어 사용자는 Chat을 종료하지 않고도 다른 메시지 플랫폼에서 사용자와 메시지를 주고받을 수 있습니다.

이벤트 작동 방식

Google Chat에서 문제가 발생할 때마다 Google Chat API 리소스가 생성, 업데이트 또는 삭제됩니다. 이벤트는 활동이 발생한 시점과 영향을 받은 Chat API 리소스에 관한 정보를 전달합니다.

Chat은 이벤트를 유형별로 분류합니다. 이벤트 유형을 사용하면 필요한 정보 유형만 필터링하고 요청할 수 있으며 유사한 이벤트를 같은 방식으로 처리할 수 있습니다.

다음 표는 Chat의 활동이 관련 Chat API 리소스에 미치는 영향과 채팅 앱에서 수신하는 이벤트 유형을 보여줍니다.

활동	Chat API 리소스	이벤트 유형
사용자가 Chat 스페이스에 메시지를 게시합니다.	Message 리소스가 생성됩니다.	새 메시지
사용자가 스페이스 관리자가 됩니다.	Membership 리소스가 업데이트됩니다.	업데이트된 멤버십
사용자가 메시지에 반응합니다.	Reaction 리소스가 생성됩니다.	새 반응
사용자가 스페이스에서 나갑니다.	Membership 리소스가 삭제됩니다.	멤버십이 삭제되었습니다.

참고: 채팅 앱은 상호작용 이벤트도 수신할 수 있습니다. 이러한 이벤트는 사용자가 스페이스에 채팅 앱을 추가하거나 채팅 앱을 @멘션하는 경우와 같은 직접적인 사용자 상호작용에 응답하는 데 도움이 됩니다. 상호작용 이벤트를 구성하고 수신하려면 Google Chat 앱과의 상호작용 수신 및 응답을 참고하세요.

Google Chat에서 이벤트 수신

이벤트를 수신하려면 채팅 앱에서 다음 중 하나를 수행할 수 있습니다.

• Google Workspace Events API를 사용하여 이벤트를 구독하여 발생하는 이벤트를 수신합니다.
• Chat API를 호출하여 이벤트를 쿼리합니다.

Google Workspace Events API와 Chat API는 동일한 이벤트 유형을 지원하고 전송합니다. 이벤트를 구독해야 하는지 쿼리해야 하는지 알아보려면 다음 표를 참고하세요.

	이벤트 구독	이벤트 쿼리
사용 사례	실시간으로 이벤트를 처리하거나 응답하세요. 사용자의 멤버십 활동을 모니터링하고 모니터링할 새 스페이스를 찾습니다.	주기적으로 또는 트리거를 통해 이벤트를 처리하거나 응답합니다. 구독에서 누락된 이벤트 (서비스 중단 또는 비활성 구독으로 인해)를 가져옵니다.
API	Google Workspace Events API	Chat API
이벤트 소스	스페이스 및 사용자	스페이스만
이벤트 형식	CloudEvent 사양에 따라 형식이 지정된 Google Cloud Pub/Sub 메시지입니다. 자세한 내용은 Google Workspace 이벤트의 구조를 참고하세요.	Chat API 리소스( spaces.spaceEvent)
이벤트 데이터	리소스 데이터가 있거나 없는 Base64 인코딩 문자열입니다. 페이로드 예시는 이벤트 데이터를 참조하세요.	리소스 데이터가 포함된 JSON 페이로드 일부 이벤트 유형에는 특정 리소스 필드만 포함됩니다. 페이로드 예시는 SpaceEvents 참조 문서를 확인하세요.

Google Workspace Events API를 사용하여 구독을 만드는 방법에 대한 자세한 내용은 Google Workspace Events API 문서를 참조하세요. Chat API를 사용하여 이벤트를 쿼리하려면 다음 가이드를 참조하세요.

• Google Chat 스페이스 일정 세부정보 보기
• Google Chat 스페이스의 일정 나열하기

제한사항

• 사용자 구독, 채팅 메시지 또는 이름이 지정되지 않은 그룹 채팅 (google.workspace.chat.membership.v1.created)의 새 회원에 대한 이벤트는 첫 번째 메시지가 게시된 후에만 트리거됩니다.
• 스페이스 기록을 변경해도 업데이트된 스페이스 이벤트 (이벤트 유형: google.workspace.chat.spaces.v1.updated)가 트리거되지 않습니다.
• 멤버십 이벤트를 수신하려면 사용자가 스페이스의 직속 멤버여야 합니다. 사용자가 Google 그룹을 통해 스페이스에 간접적으로 추가, 업데이트 또는 삭제된 경우 구독은 이러한 멤버십 이벤트를 수신하지 않습니다. Google 그룹 멤버십의 작동 방식을 알아보려면 스페이스에 Google 그룹 추가를 참조하세요.