이 페이지에서는 Google Chat 앱에서 Google Chat의 이벤트
Google Chat 이벤트는 Chat의 활동이나 변경사항을 나타냅니다. 예를 들어 스페이스의 새 메시지를 사용하는 것이 좋습니다 채팅 앱에서 사용할 수 있는 기능 이를 통해 무슨 일이 일어났는지 이해하고 의미 있는 방식으로 조치를 취하거나 방법을 제공합니다
다음은 이벤트를 사용하는 방법의 몇 가지 예입니다.
- 스페이스에서 키 확인 등 새로운 메시지를 모니터링하고 답장합니다. 학습합니다.
- 사용자가 스페이스에 참여할 때 스페이스에 대해 설명하는 환영 메시지를 보냅니다. 효과적인 사용법에 대한 팁을 공유하거나 채팅 앱
- Chat 활동 추적 및 분석 예를 들어 신규 회원 또는 가장 많은 구독자를 모은 메시지에 대한 월간 보고서를 반응입니다.
- 메시지 플랫폼 간 커뮤니케이션 예를 들어 사용자는 다른 메시징 플랫폼에서 사용자로부터 메시지를 받을 수 있습니다 채팅에서 나가기
일정 작동 방식
Google Chat에서 문제가 발생할 때마다 Google Chat API 리소스는 즉, 생성, 업데이트 또는 삭제됩니다. Chat은 이벤트를 사용하여 어떤 유형의 채팅인지에 관한 정보를 발생한 활동, 영향을 받은 Chat API 리소스를 확인할 수 있습니다.
Message
리소스를 생성하는 Chat 스페이스
그러면 Chat에서 새로운
메시지가 표시됩니다.Chat에서는 이벤트를 유형별로 분류합니다. 이벤트 유형을 사용하면 필요한 유형의 정보만 받고 비슷한 유형의 같은 방식으로 사용할 수 있습니다.
다음 표는 Chat의 활동이 Google Chat API 리소스 및 채팅 앱에서 수신하는 메시지:
활동 | Chat API 리소스 | 이벤트 유형 |
---|---|---|
사용자가 Chat 스페이스에 메시지를 게시합니다. | Message 리소스가 생성됩니다. |
새 메시지 |
사용자가 스페이스 관리자가 됩니다. | Membership 리소스가 업데이트되었습니다. |
업데이트된 멤버십 |
사용자가 메시지에 반응합니다. | Reaction 리소스가 생성됩니다. |
새 반응 |
사용자가 스페이스에서 나갑니다. | Membership 리소스가 삭제됩니다. |
삭제된 멤버십 |
Google Chat에서 이벤트 수신
이벤트를 수신하려면 채팅 앱에서 있습니다.
- 이벤트를 수신하려면 Google Workspace Events API를 사용하여 이벤트 구독 발생할 수 있습니다.
- Chat API를 호출하여 최근 이벤트를 쿼리합니다.
다음 표는 쿼리 또는 쿼리하는 것의 차이와 이유를 설명합니다. 이벤트 구독:
이벤트 구독 | 이벤트 쿼리 | |
---|---|---|
사용 사례 |
|
|
API | Google Workspace Events API | Chat API |
이벤트 소스 | 스페이스 및 사용자 | 스페이스만 |
지원되는 이벤트 |
지원되는 이벤트 유형 목록은 를 참조하세요. 정기 결제 생성을 위한 이벤트 유형: Google Workspace Events API 문서입니다. |
지원되는 이벤트 유형 목록은 Chat API의 spaceEvents 리소스
참조하세요.
|
이벤트 형식 | 다음에 따라 형식이 지정된 Google Cloud Pub/Sub 메시지 CloudEvent 사양. 자세한 내용은 Google Workspace 이벤트의 구조 |
Chat API 리소스
(
spaces.spaceEvent )
|
이벤트 데이터 | 리소스 데이터 유무와 관계없이 Base64로 인코딩된 문자열입니다. 페이로드 예시는 이벤트 데이터를 참조하세요. | 리소스 데이터가 포함된 JSON 페이로드입니다. 일부 이벤트 유형에는 특정 리소스 필드만 포함됩니다. 페이로드 예시는 다음을 참조하세요. <ph type="x-smartling-placeholder"></ph> 참조 문서를 확인하세요. |
예: 스페이스의 멤버십 관련 이벤트 쿼리 또는 구독
이 예에서 채팅 앱은 Chat 스페이스 참여자의 변경사항에 대한 정보 포함 스페이스에서 다음 멤버십 활동이 발생합니다.
- 사용자가 스페이스에 참여하여
Membership
리소스가 생성되고 신규 회원 이벤트를 표시합니다. - 사용자가 스페이스 관리자가 되어 다음 스페이스의
Membership
리소스가 업데이트됩니다. 업데이트된 구성원 이벤트를 트리거합니다. - 사용자가 스페이스를 나가면서
Membership
리소스의 구성원이 삭제 이벤트를 트리거합니다.
멤버십 이벤트 구독
실시간으로 이벤트를 수신하려면
Chat 앱이 Google Workspace Events API를 호출합니다.
subscriptions.create()
메서드를 사용하여 모든 유형의 멤버십 이벤트를 위해 스페이스를 구독할 수 있습니다. 후(After)
구독이 생성되면 채팅 앱에서
멤버십 이벤트를 수신할 수 있습니다.
그림 2에서 채팅 앱에는 그러면 스페이스의 멤버십이 있을 때마다 앱에서 이벤트를 수신합니다. 있습니다. 그러면 채팅 앱이 모든 활동에 실시간으로 연결할 수 있습니다(예: 스페이스에 참여한 멤버
Google Workspace Events API를 사용하여 구독을 만드는 방법을 알아보려면 Google Workspace Events API 문서를 참고하세요.
최근 멤버십 이벤트 쿼리
멤버십 이벤트가 발생할 때마다 받는 대신 채팅 앱은 Chat API를 호출하여 나열할 수 있습니다. 멤버십 활동과 관련된 최근 스페이스 이벤트
그림 3에서는 채팅 앱이 Chat API를 호출합니다.
spaces.spaceEvents.list()
메서드를 호출하고 쿼리를 필터링하고
신규, 업데이트, 삭제된 멤버십 이벤트를 확인할 수 있습니다. Chat API는
각 멤버십 변경사항을 나타내는 spaceEvent
리소스의 목록입니다.
그러면 채팅 앱이
최근의 활동(예: 주간 메시지 게시)에서
스페이스의 지난 7일간 멤버십 활동
Chat API를 사용하여 이벤트를 쿼리하려면 다음을 참고하세요. Google Chat 스페이스의 이벤트 나열
제한사항
-
사용자 구독, 채팅 메시지 또는 이름이 지정되지 않은 그룹 채팅의 새 회원 관련 일정 (
google.workspace.chat.membership.v1.created
) 첫 번째 메시지가 게시된 후에만 트리거됩니다. - 멤버십 이벤트를 수신하려면 사용자가 스페이스의 직속 멤버여야 합니다. 사용자가 추가된 경우 스페이스에 간접적으로 업데이트되거나 삭제된 경우 구독은 이러한 멤버십 이벤트를 수신할 수 있습니다. Google 그룹 멤버십 작동 방식을 이해하려면 다음을 참고하세요. 스페이스에 Google 그룹 추가하기
관련 주제
- Google Workspace Events API 개요
- 정기 결제 만들기
- Google Chat 스페이스 일정에 관한 세부정보 확인하기
- Google Chat 스페이스의 이벤트 나열하기
- 이벤트 사용 방법의 예시는 다음을 바탕으로 질문에 답변하기 (Gemini AI와의 Chat 대화) 채팅 앱 문제 관리의 포용성 도움말 기능을 Codelab의 채팅 앱 Gemini로 Google Chat용 앱 빌드하기