이 페이지에서는 앱이 Google Workspace Events API를 사용하여 구독할 수 있는 Google Meet 이벤트를 설명합니다. 필요한 이벤트 유형을 결정한 후 구독을 만들어 Google Meet에서 이벤트를 수신합니다.
Google Meet용 앱 개발에 대해 자세히 알아보려면 Google Meet REST API 개요를 참고하세요.
지원되는 Meet 이벤트
Google Workspace를 구독하면 Meet의 다음과 같은 유형의 변경사항에 관한 이벤트를 받을 수 있습니다.
이벤트를 모니터링할 수 있는 리소스
이벤트를 수신하려면 모니터링할 Meet 리소스(구독의 타겟 리소스라고 함)를 지정합니다.
Google Workspace Events API는 Meet에 다음과 같은 타겟 리소스를 지원합니다.
| 타겟 리소스 | 방식 | 제한사항 (해당하는 경우) |
|---|---|---|
| 회의 공간 | //meet.googleapis.com/spaces/SPACE
여기서 SPACE는 Meet REST API |
|
| 사용자 | //cloudidentity.googleapis.com/users/USER
여기서 USER는 Meet REST API |
구독은 사용자가 다음 중 하나인 회의 공간에 관한 이벤트를 수신합니다.
|
구독 생성을 위한 이벤트 유형
Meet 리소스에 대한 구독을 만들 때는 eventTypes[] 필드를 사용하여 수신할 이벤트 유형을 지정합니다. 이벤트 유형은 CloudEvents 사양(예: google.workspace.APPLICATION.RESOURCE.VERSION.ACTION)에 따라 형식이 지정됩니다.
예를 들어 Meet 스페이스의 회의에 참여한 신규 참석자에 관한 이벤트를 수신하려면 이벤트 유형을 google.workspace.meet.participant.v2.joined로 지정합니다. 이벤트 작동 방식에 관한 자세한 내용은 Google Workspace 이벤트 구조를 참고하세요.
다음 표에는 지원되는 이벤트 유형, 설명, 이벤트 데이터에 표시되는 변경된 Meet 리소스가 나와 있습니다.
| 이벤트 유형 | 설명 | Meet 리소스 |
|---|---|---|
|
회의 공간에서 회의가 시작됩니다. |
|
|
회의 공간에서 회의가 종료됩니다. |
|
|
참여자가 회의 공간에서 진행 중인 회의에 참여합니다. |
|
|
참석자가 회의 공간에서 진행 중인 회의를 종료합니다. |
|
|
회의 공간에서 회의에 대한 녹화 파일이 생성됩니다. |
|
|
회의 공간의 회의에 대한 스크립트 파일이 생성됩니다. |
|
이벤트 데이터
이 섹션에서는 Meet 회의 공간의 이벤트에 대한 이벤트 데이터와 페이로드 예시를 설명합니다.
Google Workspace 구독이 Meet에서 이벤트를 수신하면 data 필드에 이벤트의 페이로드가 포함됩니다. 이 페이로드에는 변경된 Google Workspace 리소스에 관한 정보가 포함되어 있습니다. 예를 들어 스페이스의 새 스크립트에 관한 이벤트를 구독한 경우 이러한 이벤트의 페이로드에는 변경된 transcript 리소스에 관한 정보가 포함됩니다.
이벤트 페이로드의 리소스 데이터
다음 표에는 Meet 회의 공간 구독을 위한 JSON 페이로드의 예가 나와 있습니다. 이 예에서는 스페이스에서 진행되는 회의 conferenceRecords/AAA-BBB-CCC-DDD-EEE를 사용합니다. 구독이 수신하는 각 이벤트의 경우 페이로드는 이벤트의 data 필드에 표시됩니다.
| 예 | 이벤트 유형 | JSON 페이로드 |
|---|---|---|
Meet 회의 공간의 회의가 시작됩니다. |
|
리소스 데이터 제외
{
"conferenceRecord":
{
"name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE"
}
}
|
| 참여자가 Meet 회의 공간에서 회의에 참여합니다. |
|
리소스 데이터 제외
{
"participantSession":
{
"name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/participants/FFF-GGG-HHH-III-JJJ/participantSessions/LLL-MMM-NNN-OOO-PPP"
}
}
|
| Meet 회의 공간에서 회의 녹화 파일이 생성됩니다. | google.workspace.meet.recording.v2.fileGenerated |
리소스 데이터 제외
{
"recording":
{
"name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/recordings/LLL-MMM-NNN-OOO-PPP"
}
}
|
| Meet 회의 공간에서 회의에 대한 스크립트가 생성됩니다. | google.workspace.meet.transcript.v2.fileGenerated |
리소스 데이터 제외
{
"transcript":
{
"name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/transcripts/PPP-QQQ-RRR-SSS-TTT"
}
}
|