이 문서에서는 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 이벤트 구독을 참고하세요.
다음 표에서는 이벤트 구독과 이벤트 쿼리의 차이점과 이유를 설명합니다.
| 이벤트 구독 | 데이터 쿼리 | |
|---|---|---|
| 사용 사례 |
|
|
| API | Google Workspace Events API | Meet REST API |
| 이벤트 소스 | 회의 기록 및 사용자 | 스페이스 및 회의 기록 |
| 지원되는 이벤트 |
회의 기록
지원되는 이벤트 유형 목록은 Google Workspace Events API 참고 리소스에서 구독 생성 이벤트 유형을 참고하세요. |
스페이스 및 회의 기록
지원되는 엔드포인트 목록은 Space
리소스 및
ConferenceRecord
Meet REST API 문서의 리소스를 참고하세요.
|
| 이벤트 형식 | CloudEvent 사양에 따라 형식이 지정된 Google Cloud Pub/Sub 메시지입니다. 자세한 내용은 Google Workspace 이벤트 구조를 참고하세요. |
Meet REST API 리소스 (Space 및 ConferenceRecord)
|
| 이벤트 데이터 | 리소스 데이터가 있거나 없는 Base64 인코딩 문자열입니다. 예시 페이로드는 이벤트 데이터를 참고하세요. |
리소스 데이터가 포함된 JSON 페이로드입니다. 예시 페이로드는 참고 문서의
ConferenceRecord
리소스를 참고하세요.
|
예: 회의 스페이스의 참여자에 관한 이벤트 가져오기
이 예에서 Meet 앱은 회의 스페이스의 참여자 변경사항에 관한 정보를 수신하려고 합니다. 회의 스페이스에서 참여자가 활성 회의에 참여하면
ParticipantSession
리소스가 채워지고 새 이벤트가 트리거됩니다. 그러면 구독 또는 쿼리 메서드를 사용하여 이러한 이벤트에 관한 정보를 가져올 수 있습니다.
구독 또는 쿼리
메서드를 사용하여 이러한 이벤트에 관한 정보를 가져올 수 있습니다.
이벤트 구독
이벤트를 실시간으로 수신하려면 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.