Google Meet 이벤트 구독하기

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

이벤트를 구독하는 것 외에도 Google Meet REST API를 호출하여 이벤트를 쿼리할 수도 있습니다. Meet REST API를 호출하여 이벤트를 주기적으로 가져오거나, 서비스 중단으로 인해 구독에서 놓쳤을 수 있는 이벤트를 따라잡습니다. Meet 이벤트를 수신하고 응답하는 방법에 대한 자세한 내용은 Meet 문서의 Meet 이벤트에 응답하기를 참고하세요.

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

지원되는 Meet 이벤트

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

• 회의 공간에서 회의가 시작되거나 종료됩니다.
• 참여자가 회의에 참여하거나 회의에서 나갑니다.
• 회의의 녹화가 시작되거나 종료되거나 파일이 생성됩니다.
• 회의의 스마트 메모가 시작되거나 종료되거나 파일이 생성됩니다.
• 회의의 스크립트가 시작되거나 종료되거나 파일이 생성됩니다.

이벤트를 모니터링할 수 있는 리소스

이벤트를 수신하려면 모니터링할 Meet 리소스를 지정합니다. 이를 구독의 타겟 리소스 라고 합니다.

Google Workspace Events API는 Meet에 대해 다음과 같은 타겟 리소스를 지원합니다.

구독을 만들기 위한 이벤트 유형

Meet 리소스에 대한 구독을 만들 때 eventTypes[] 필드를 사용하여 수신하려는 이벤트 유형을 지정합니다. 이벤트 유형은 CloudEvents 사양에 따라 형식이 지정됩니다. 예: google.workspace.APPLICATION.RESOURCE.VERSION.ACTION.

예를 들어 Meet 공간의 회의에 참여하는 새 참여자에 관한 이벤트를 수신하려면 이벤트 유형을 google.workspace.meet.participant.v2.joined로 지정합니다. 이벤트 작동 방식에 대한 자세한 내용은 Google Workspace 이벤트의 구조를 참고하세요.

다음 표는 Meet 리소스 구독에 지원되는 이벤트 유형을 보여줍니다.

이벤트 데이터

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

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

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

다음 표는 Meet 회의 공간 구독의 JSON 페이로드 예를 제공합니다. 이 예에서는 회의 공간을 식별하기 위해 회의 기록 ID(예: conferenceRecords/kRyYx8b7vNDsLpR1tG_cNjFUQBoBRhHIMoGJAJkBCQ)를 사용합니다. 자세한 내용은 Meet에서 회의 공간을 식별하는 방법을 참고하세요.

구독이 수신하는 각 이벤트의 경우 페이로드가 이벤트의 data 필드에 표시됩니다.

{
  "conferenceRecord":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID"
  }
}
      

{
  "participantSession":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID/participants/PARTICIPANT_ID/participantSessions/PARTICIPANT_SESSION_ID"
  }
}
      

{
  "recording":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID/recordings/RECORDING_ID"
  }
}
      

{
  "smartNote":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID/smartNotes/SMART_NOTE_ID"
  }
}
      

{
  "transcript":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID/transcripts/TRANSCRIPT_ID"
  }
}
      

• Calendar 초대 대상 및 회의에 초대된 다른 참여자는 다음 이벤트만 수신할 수 있습니다. google.workspace.meet.conference.v2.started 및 google.workspace.meet.transcript.v2.fileGenerated.

관련 주제

• Google Workspace Events API 개요
• Google Workspace 이벤트의 구조
• Google Workspace Events API 범위 선택
• Meet REST API 개요
• Meet REST API 범위 선택
• 튜토리얼: Python 및 Meet REST API로 회의 이벤트 관찰