Google Meet REST API 개요

Google Meet REST API를 사용하면 Google Meet 회의를 만들고 관리할 수 있으며 앱에서 바로 사용자에게 진입점을 제공할 수 있습니다.

Meet REST API를 사용하면 다음을 수행할 수 있습니다.

  • 동영상을 통해 사용자를 연결하는 회의 공간을 만듭니다.
  • 리소스 이름으로 회의 공간 또는 회의를 가져옵니다.
  • 참석자 및 참석자 세션 목록을 가져옵니다.
  • 회의 아티팩트 (녹화 파일, 스크립트, 스크립트 항목)를 가져옵니다.

Google Workspace Events API를 사용하여 Meet 이벤트를 구독할 수도 있습니다. 변경사항을 알림으로 받으려면 지정된 회의 공간 또는 지정된 사용자의 모든 회의 공간을 구독하면 됩니다. 자세한 내용은 Google Workspace Events API를 사용하여 이벤트 구독하기 및 Google Meet 이벤트 구독하기를 참고하세요.

사용 사례

앱은 Meet REST API와 통합하여 다음 작업을 실행할 수 있습니다.

  • 회의 전: 회의 공간을 만들어 필요에 따라 회의 환경을 조정합니다. 초대 대상자를 관리하고 설정을 사전 구성할 수도 있습니다.

  • 회의 중: 회의 정보를 검색하여 반환된 메타데이터를 기반으로 앱 환경을 변경합니다.

  • 회의 후: 녹화 파일, 스크립트와 같은 회의 아티팩트를 가져옵니다.

Meet REST API를 사용할 수 있는 작업의 예는 다음과 같습니다.

  • 영업 및 계정 관리

    • 기록을 위해 회의 및 참여자 정보를 검색합니다.
    • 회의 아티팩트를 가져와 계정에 게시합니다.
    • AI 모델을 통해 스크립트 및 녹음 파일을 실행하여 코칭 및 판매 효과 분석을 생성합니다.

  • 학습 및 개발

    • 교육을 위한 회의를 만들고 사전 구성합니다.
    • 강사 및 세션 리더에게 공동 호스트 역할을 할당합니다.
    • 학생들이 과정이 끝난 후 자료를 복습할 수 있는 녹화 파일을 검색합니다.

  • 개발자 운영

    • 회의를 만들어 팀원과 즉시 소통하세요.
    • 실시간 회의 및 참여자 정보를 공유하여 다른 이해관계자가 진행 중인 회의에 참여하도록 허용합니다.
    • AI 모델을 통해 스크립트 데이터를 실행하여 올바른 다음 단계를 생성합니다.
Chat 스페이스에서 동료와 함께 생동감 넘치는 회의를 만들고 참여하세요.
그림 1. Chat 스페이스에서 동료와 함께 생동감 넘치는 회의를 만들고 참여하세요.

Chat API와 같은 다른 Google Workspace API를 앱에 통합하여 공동작업을 더욱 확장할 수도 있습니다. 자세한 내용은 채팅 사용 사례를 참고하세요.

일반적인 용어

다음은 이 API에서 사용되는 일반적인 용어 목록입니다.

아티팩트
Meet에서 회의에 대한 응답으로 생성한 파일(예: 녹화 파일, 스크립트)입니다. 일반적으로 회의가 끝난 직후에 아티팩트를 가져올 수 있습니다.
캘린더 일정
Google Calendar의 일정으로, 일반적으로 회의 주최자가 만들며 회의 참여 정보가 포함되어 있습니다. Meet이 이벤트에 적합한 회의 솔루션일 수 있습니다.
통화
Meet을 사용하는 세션 또는 통화가 시작되거나 진행 중임을 다른 사용자에게 알리고 즉시 참여하도록 허용하는 세션입니다.
회의
회의는 회의 스페이스 내의 통화 인스턴스입니다. 사용자는 일반적으로 이 시나리오를 단일 회의로 간주합니다.
공동 호스트
원래 호스트를 삭제하는 기능을 제외하고 호스트로부터 호스트 관리 권한을 부여받은 통화 참여자입니다.
호스트
통화를 만든 사용자 (회의 주최자) 또는 통화를 제어하는 사용자입니다. 회의 주최자는 회의를 조직할 수 있지만 회의가 진행되는 동안 참석하지 않아도 됩니다. 호스트는 공동 호스트에게 호스트 권한을 위임할 수도 있습니다.
회의 코드

회의 스페이스의 회의 URI 내에 사용되는 회의 스페이스의 고유한 10자리 문자열로 입력할 수 있습니다. 대소문자를 구분하지 않습니다. 예로 abc-mnop-xyz를 들 수 있습니다. 최대 길이는 128자(영문 기준)입니다.

회의 코드는 회의 공간에서 연결 해제될 수 있고 향후 다른 회의 공간에 재사용될 수 있으므로 장기적으로 저장해서는 안 됩니다. 일반적으로 회의 코드는 마지막 사용 후 365일 후에 만료됩니다. 자세한 내용은 Google Meet 회의 코드에 관해 자세히 알아보기를 참고하세요.

회의 이름

회의 공간을 식별하는 데 사용되는 고유한 서버 생성 ID입니다. 대소문자를 구분합니다. 예를 들면 jQCFfuBOdN5z입니다. 회의 ID는 spaces 리소스의 name 필드에 반환됩니다.

회의 주최자

회의 스페이스를 만든 사용자입니다. 이 사용자는 회의 소유자로 간주될 수도 있습니다. 통화 중에 참석하지 않거나 회의 호스트가 아닐 수 있습니다. 회의 주최자는 한 명만 지정할 수 있습니다.

회의 공간

회의가 열리는 가상 장소 또는 영구 객체 (예: 회의실)입니다. 한 공간에서 한 번에 하나의 회의만 진행할 수 있습니다. 회의 공간은 사용자가 공유 리소스를 찾고 만나는 데도 도움이 됩니다.

회의 URI

클릭하면 통화를 시작하거나 사용자를 통화에 참여시키는 URL입니다. 각 호출에는 https://meet.google.com/ 다음에 회의 코드가 오는 고유한 URL이 있습니다. 예를 들면 https://meet.google.com/abc-mnop-xyz입니다.

참여자

통화에 참여했거나 컴패니언 모드를 사용하거나 시청자로 시청 중인 사용자 또는 통화에 연결된 회의실 기기입니다. 사용자당 하나의 conferenceRecords.participants 리소스가 있습니다. 참여자가 회의에 참여하면 고유 ID가 할당됩니다.

참여자 세션

통화에 참여하는 각 참여자-기기 쌍에 대해 생성된 고유한 세션 ID입니다. 세션당 하나의 conferenceRecords.participants.participantSessions 리소스가 있습니다. 참여자가 동일한 참여자-기기 쌍에서 동일한 통화에 여러 번 참여하면 각 참여자-기기 쌍에 고유한 세션 ID가 할당됩니다.