이 문서에서는 Google Cloud Pub/Sub에서 Google Meet 이벤트를 수신하고 이에 응답하는 방법을 설명합니다.
Meet 이벤트는 새 회의를 만드는 등 Meet 리소스의 활동이나 변경사항을 나타냅니다. 이벤트를 사용하여 발생한 상황을 파악한 후 조치를 취하거나 사용자에게 의미 있는 방식으로 응답할 수 있습니다.
다음은 이벤트를 사용하는 방법의 몇 가지 예시입니다.
회의 시작 또는 종료와 같은 회의의 변경사항을 관찰하고 이에 응답합니다.
규제 또는 교육 목적으로 회의에 참석한 사용자를 추적합니다.
파일 콘텐츠를 파싱하고 CRM 또는 데이터베이스에 기록할 수 있도록 회의 스크립트를 수신합니다.
이벤트 작동 방식
Google Meet에서 어떤 일이 발생하면 Google Meet REST API 리소스가 생성되거나 업데이트됩니다. Meet에서는 이벤트를 사용하여 발생한 활동 유형과 영향을 받은 Meet REST API 리소스에 관한 정보를 앱에 제공합니다.
Space 리소스가 생성됩니다. 그러면 Meet에서 새 회의 스페이스에 관한 데이터가 포함된 일정을 만듭니다.Meet에서는 유형별로 이벤트를 분류합니다. 이벤트 유형을 사용하면 필요한 정보 유형만 필터링하고 수신할 수 있으며 유사한 활동을 동일한 방식으로 처리할 수 있습니다.
다음 예에서는 Meet의 활동이 관련 Meet REST API 리소스와 Meet 앱이 수신하는 이벤트 유형에 미치는 영향을 보여줍니다.
| 활동 | Meet REST API 리소스 | 이벤트 유형 |
|---|---|---|
| 사용자가 회의 스페이스에 참여합니다. | ConferenceRecord 리소스가 생성됩니다. |
새 회의 기록 |
Google Meet에서 이벤트 데이터 수신
이벤트 데이터를 수신하기 위해 앱은 다음 중 하나를 수행할 수 있습니다.
Google Workspace Events API를 사용하여 이벤트를 구독하여 이벤트가 발생할 때 이벤트를 수신합니다. 자세한 내용은 Google Meet 이벤트 구독하기를 참고하세요.
Meet REST API를 호출하여 최근 데이터를 쿼리합니다.
다음 표에서는 이벤트를 구독하는 것과 이벤트를 쿼리하는 것의 차이점과 이유를 설명합니다.
| 이벤트 구독 | 데이터 쿼리 | |
|---|---|---|
| 사용 사례 |
|
|
| API | Google Workspace Events API | Meet REST API |
| 이벤트 소스 | 컨퍼런스 기록 및 사용자 | 스페이스 및 회의 기록 |
| 지원되는 이벤트 |
회의 기록
지원되는 이벤트 유형 목록은 Google Workspace Events API 문서의 구독 생성용 이벤트 유형을 참고하세요. |
스페이스 및 회의 기록
지원되는 엔드포인트 목록은 Meet REST API 문서의 Space 리소스 및 ConferenceRecord 리소스를 참고하세요.
|
| 이벤트 형식 | CloudEvent 사양에 따라 형식이 지정된 Google Cloud Pub/Sub 메시지입니다. 자세한 내용은 Google Workspace 이벤트 구조를 참고하세요. |
Meet REST API 리소스 (Space 및 ConferenceRecord)
|
| 이벤트 데이터 | 리소스 데이터가 있거나 없는 Base64로 인코딩된 문자열입니다. 페이로드 예시는 이벤트 데이터를 참고하세요. |
리소스 데이터가 포함된 JSON 페이로드입니다. 페이로드 예시는 참고 문서의 ConferenceRecord
리소스를 참고하세요.
|
예: 회의실의 참여자에 관한 이벤트 가져오기
이 예에서는 Meet 앱이 회의 공간의 참여자 변경에 관한 정보를 수신하려고 합니다. 회의 공간에서 참여자가 활성 회의에 참여하면 ParticipantSession 리소스가 채워지고 새 이벤트가 트리거됩니다. 그런 다음 subscribe 또는 query 메서드를 사용하여 이러한 이벤트에 관한 정보를 가져올 수 있습니다.
이벤트 구독
이벤트를 실시간으로 수신하기 위해 Meet 앱은 Google Workspace Events API subscriptions.create 메서드를 호출하여 모든 유형의 이벤트에 대한 회의 스페이스를 구독합니다. 구독을 만든 후 Meet 앱이 이벤트를 수신할 수 있습니다.
그림 2에서 Meet 앱은 회의 스페이스를 활성 구독하고 있으므로 회의 스페이스에서 참여자 세션이 변경될 때마다 앱이 이벤트를 수신합니다. 그러면 Meet 앱이 참여자가 활성 회의에 참여하거나 나가는 시점을 아는 등 모든 활동에 실시간으로 응답할 수 있습니다.
Google Workspace Events API를 사용하여 구독을 만드는 방법을 알아보려면 Google Workspace Events API 문서를 참고하세요.
최근 이벤트 쿼리
이벤트가 발생할 때 수신하는 대신 Meet 앱은 Meet REST API를 호출하여 참여자 활동과 관련된 최근 회의 스페이스 이벤트를 나열할 수도 있습니다.
그림 3에서는 모든 참여자 세션 활동이 발생한 후 Meet 앱이 Meet REST API conferenceRecords.participants.participantSessions.list 메서드를 호출합니다. Meet REST API는 각 변경사항을 나타내는 ParticipantSession 리소스 목록을 반환합니다. 그러면 Meet 앱에서 회의에 참여했다가 나간 참여자 목록을 만드는 등 최근 활동을 기반으로 처리하거나 응답할 수 있습니다.
Meet REST API를 사용하여 이벤트를 쿼리하려면 모든 참여자 세션 나열을 참고하세요.
제한사항
- 캘린더 초대 대상자와 회의에 초대된 다른 참여자는
google.workspace.meet.conference.v2.started및google.workspace.meet.transcript.v2.fileGenerated이벤트만 수신할 수 있습니다.