Google Meet 이벤트 구독하기

이 페이지에서는 앱에서 Google Workspace Events API를 사용하여 구독할 수 있는 Google Meet 이벤트를 설명합니다. 필요한 이벤트 유형을 결정한 후 구독을 생성하여 Google Meet에서 이벤트 수신을 시작합니다.

Google Meet용 앱 개발에 관한 자세한 내용은 Google Meet REST API 개요를 참고하세요.

지원되는 Meet 대상 리소스

Google Workspace Events API에서는 Meet 이벤트를 수신할 수 있도록 다음 리소스에 대한 구독을 지원합니다.

  • space 리소스로 표시되는 회의 공간
  • 사용자: Cloud ID API user 리소스로 표시됩니다.

지원되는 Meet 이벤트

Google Workspace 구독을 사용하면 다음과 같은 Meet 변경 유형에 대한 이벤트를 수신할 수 있습니다.

  • 회의는 회의 공간에서 시작하거나 끝납니다.
  • 참여자가 회의에 참여하거나 회의에서 나갑니다.
  • 회의의 녹화가 생성됩니다.
  • 회의의 스크립트가 생성됩니다.

Meet 리소스 구독을 만들 때는 eventTypes[] 필드를 사용하여 수신하려는 이벤트 유형을 지정합니다. 이벤트 유형은 CloudEvents 사양에 따라 형식이 지정됩니다(예: google.workspace.APPLICATION.RESOURCE.VERSION.ACTION). 예를 들어 Meet 스페이스의 새 회의 참여자에 관한 이벤트를 수신하려면 이벤트 유형을 google.workspace.meet.participant.v2.joined로 지정합니다. 이벤트의 작동 방식에 대한 자세한 내용은 Google Workspace 이벤트의 구조를 참조하세요.

다음 표에는 지원되는 이벤트 유형, 설명, 이벤트 데이터에 표시되는 변경된 Meet 리소스가 나와 있습니다.

이벤트 유형 설명 Meet 리소스

google.workspace.meet.conference.v2.started

회의 공간에서 회의가 시작됩니다.

conferenceRecord

google.workspace.meet.conference.v2.ended

회의 공간에서 회의가 종료됩니다.

conferenceRecord

google.workspace.meet.participant.v2.joined

참여자가 회의 공간에서 진행 중인 회의에 참여합니다.

conferenceRecord.participantSession

google.workspace.meet.participant.v2.left

참여자가 회의 공간에서 진행 중인 회의에서 나갑니다.

conferenceRecord.participantSession

google.workspace.meet.recording.v2.fileGenerated

회의 공간에서 진행되는 회의를 위한 녹화 파일이 생성됩니다.

conferenceRecord.recording

google.workspace.meet.transcript.v2.fileGenerated

회의 공간에서 진행되는 회의의 스크립트 파일이 생성됩니다.

conferenceRecord.transcript

이벤트 데이터

이 섹션에서는 Meet 회의 공간의 이벤트에 대한 이벤트 데이터와 예시 페이로드를 설명합니다.

Google Workspace 구독에서 Meet의 이벤트를 수신하면 data 필드에 이벤트의 페이로드가 포함됩니다. 이 페이로드에는 변경된 Google Workspace 리소스에 대한 정보가 포함되어 있습니다. 예를 들어 스페이스의 새 스크립트에 대한 이벤트를 구독한 경우 이러한 이벤트의 페이로드에는 변경된 transcript 리소스에 대한 정보가 포함됩니다.

이벤트 페이로드의 리소스 데이터

다음 표에는 Meet 회의 공간 구독에 대한 JSON 페이로드의 예시가 나와 있습니다. 예에서는 공간에서 열리는 conferenceRecords/AAA-BBB-CCC-DDD-EEE 회의를 사용합니다. 정기 결제가 수신하는 각 이벤트의 경우 페이로드는 이벤트의 data 필드에 표시됩니다.

예 이벤트 유형 JSON 페이로드

Meet 회의 공간에서 회의가 시작됩니다.

google.workspace.meet.conference.v2.started

리소스 데이터 제외
{
    "conferenceRecord":
    {
        "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE"
    }
}
참여자가 Meet 회의 공간에서 회의에 참여합니다.

google.workspace.meet.participant.v2.joined

리소스 데이터 제외
{
    "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"
    }
}