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에서 생성된 파일입니다(예: 녹화 및 transcripts). 일반적으로 아티팩트는 회의가 끝난 후 바로 가져올 준비가 됩니다.
캘린더 일정
여러 참석자가 참여하는 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가 할당됩니다.

API별 승인 및 인증 정보

승인 범위는 앱에서 회의 콘텐츠에 액세스할 수 있도록 사용자에게 승인하도록 요청하는 권한입니다. 누군가 앱을 설치하면 사용자에게 이러한 범위의 유효성을 검사하라는 메시지가 표시됩니다. 일반적으로 가능한 한 가장 좁은 포커스가 지정된 범위를 선택하고 앱에 필요하지 않은 범위는 요청하지 않아야 합니다. 사용자는 제한되고 명확하게 설명된 범위에 대한 액세스 권한을 보다 쉽게 부여할 수 있습니다.

Meet REST API는 다음과 같은 OAuth 2.0 범위를 지원합니다.

범위 코드 설명 사용량
https://www.googleapis.com/auth/meetings.space.readonly 앱에서 사용자가 액세스할 수 있는 회의 공간에 관한 메타데이터를 읽도록 허용합니다. 민감한 콘텐츠
https://www.googleapis.com/auth/meetings.space.created 앱이 앱에서 만든 회의 공간에 관한 메타데이터를 생성, 수정, 읽을 수 있도록 허용합니다. 민감한 콘텐츠
https://www.googleapis.com/auth/drive.readonly 앱이 Google Drive API에서 녹음 파일 및 스크립트 파일을 다운로드하도록 허용합니다. 제한됨

특정 OAuth 2.0 범위에 대한 자세한 내용은 Google API의 OAuth 2.0 범위를 참조하세요.