이 문서에서는 Google Cloud Pub/Sub에서 Google Meet 이벤트를 수신하고 이에 응답하는 방법을 설명합니다.
Meet 이벤트는 새 회의를 만드는 등 Meet 리소스의 활동이나 변경사항을 나타냅니다. 이벤트를 사용하여 발생한 상황을 파악한 후 조치를 취하거나 사용자에게 의미 있는 방식으로 응답할 수 있습니다.
다음은 이벤트를 사용하는 방법의 몇 가지 예시입니다.
회의 시작 또는 종료와 같은 회의의 변경사항을 관찰하고 이에 응답합니다.
규제 또는 교육 목적으로 회의에 참석한 사용자를 추적합니다.
파일 콘텐츠를 파싱하고 CRM 또는 데이터베이스에 기록할 수 있도록 회의 스크립트를 수신합니다.
이벤트 작동 방식
Google Meet에서 어떤 일이 발생하면 Google Meet REST API 리소스가 생성되거나 업데이트됩니다. Meet에서는 이벤트를 사용하여 발생한 활동 유형과 영향을 받은 Meet REST API 리소스에 관한 정보를 앱에 제공합니다.
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
리소스를 참고하세요.
|
제한사항
- 캘린더 초대 대상자와 회의에 초대된 다른 참여자는
google.workspace.meet.conference.v2.started및google.workspace.meet.transcript.v2.fileGenerated이벤트만 수신할 수 있습니다.