Google Meet REST API 개요

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

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

  • 화상으로 사용자를 연결할 수 있도록 회의 스페이스를 만들고 구성합니다.
  • 스페이스 액세스 수준, 조정 설정, 자동 녹화 또는 스크립트를 사전 구성합니다.
  • 회의 스페이스 멤버를 관리하고 공동 호스트 역할을 할당합니다.
  • 회의 스페이스 내에서 프로그래매틱 방식으로 활성 회의를 종료합니다.
  • 회의 기록, 참석 세부정보, 참여자 세션 메타데이터를 가져옵니다.
  • 회의 아티팩트 (녹화 파일, 스크립트, 스크립트 항목, 자동 회의록)를 가져옵니다.

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

사용 사례

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

  • 회의 전: 주문형으로 회의실을 만들고, 액세스 제한 (공개, 신뢰할 수 있음, 제한됨)을 사전 구성하고, 조정 관리 컨트롤 (화면 공유, 채팅, 반응, 마이크, 카메라)을 적용하고, 자동 녹화 또는 자동 스크립트를 구성하고, 공동 호스트 역할이 있는 스페이스 구성원을 할당합니다.

  • 컨퍼런스 중: 활성 컨퍼런스 메타데이터 및 참여자 세션을 가져오거나, 회원을 동적으로 관리하거나, Google Workspace Events API를 사용하여 실시간 수명 주기 이벤트를 수신하거나, 프로그래매틱 방식으로 활성 컨퍼런스를 종료합니다.

  • 회의 후: 회의 기록 및 참석 로그를 검색하고, Google Drive에서 녹화 파일, Google Docs 스크립트, 스마트 회의록을 다운로드하고, 코칭, 규정 준수 또는 AI 분석을 위해 세부적인 스크립트 음성 항목에 액세스합니다.

Meet REST API를 사용할 수 있는 몇 가지 예는 다음과 같습니다.

  • 영업 및 계정 관리

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

  • 학습 및 발전

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

  • 고객 지원 및 컨설팅

    • 헬프 데스크 티켓 또는 클라이언트 포털에서 직접 안전하고 제한된 회의 스페이스를 만드세요.
    • 지원 상담사만 발표하거나 출석을 관리할 수 있도록 호스트 관리를 사전 구성합니다.
    • 품질 보증 및 규정 준수 기록을 위해 자동 녹음 또는 스크립트를 사용 설정합니다.
    • 예약 또는 지원 세션이 종료되면 프로그래매틱 방식으로 진행 중인 회의를 종료합니다.

  • 개발자 작업

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

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

일반적인 용어

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

활성 회의
회의 공간 내에서 진행 중인 컨퍼런스입니다. 언제든지 회의 공간에서 하나의 활성 회의만 개최할 수 있습니다. 종료되면 기록 회의 기록이 됩니다.
아티팩트
Meet에서 회의에 대한 응답으로 생성된 파일입니다(예: recordings, transcripts, smartNotes). 아티팩트는 회의 주최자의 Drive에 저장됩니다. 일반적으로 회의가 끝난 직후에 가져올 수 있습니다.
Calendar 일정
일반적으로 회의 주최자가 만들고 회의 참여 정보가 포함된 Google Calendar의 일정입니다. Meet이 이벤트의 회의 솔루션일 수 있습니다.
Call
Meet을 사용한 세션 또는 통화가 시작되거나 진행 중임을 다른 사용자에게 알리고 즉시 참여할 수 있도록 합니다.
공동 호스트
원래 호스트를 삭제하는 기능을 제외하고 호스트가 호스트 관리 권한을 부여한 통화 참여자입니다.
회의
회의는 회의 스페이스 내 통화의 인스턴스입니다. 사용자는 일반적으로 이 시나리오를 단일 회의로 간주합니다.
컨퍼런스 성적
회의의 각 인스턴스에 대한 고유 ID입니다. 회의가 시작되면 자동으로 생성됩니다. conferenceRecords 리소스는 conferenceRecords/{conferenceRecord} 형식을 사용합니다. 예를 들면 conferenceRecords/kRyYx8b7vNDsLpR1tG_cNjFUQBoBRhHIMoGJAJkBCQ입니다.
전화로 참여하기
전화를 사용하여 통화에 참여하거나 스트리밍된 통화를 청취합니다.
호스트
통화를 만든 사용자 (회의 주최자) 또는 통화를 제어하는 사용자 회의 주최자는 회의를 주최할 수 있지만 회의에 참석하지는 않을 수 있습니다. 호스트는 공동 호스트에게 호스트 권한을 위임할 수도 있습니다.
회의 코드

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

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

회의 이름

회의 스페이스를 식별하는 데 사용되는 고유한 서버 생성 ID입니다. 대소문자를 구분합니다. 예를 들면 다음과 같습니다. jQCFfuBOdN5z 회의 ID는 spaces 리소스의 name 필드에 반환됩니다. 자세한 내용은 Meet에서 회의실을 식별하는 방법을 참고하세요.

회의 주최자

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

회의 스페이스

회의가 개최되는 가상 장소 또는 지속적인 객체 (예: 회의실)입니다. 언제든지 하나의 스페이스에서 하나의 활성 회의만 개최할 수 있습니다. 회의 공간을 사용하면 사용자가 만나 공유 리소스를 찾을 수도 있습니다.

회의 URI

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

회원

지정된 역할 (예: COHOST)로 회의 스페이스에 명시적으로 추가된 사용자입니다. 라이브 컨퍼런스 중에만 참석하는 참석자와 달리 멤버는 지속적인 회의 스페이스와 연결되어 있으며 해당 스페이스의 여러 컨퍼런스에서 권한을 유지합니다.

참여자

통화에 참여하거나 컴패니언 모드를 사용하는 사용자, 시청자로 시청하는 사용자 또는 통화에 연결된 회의실 기기 각 사용자에 대해 하나의 participants 리소스가 있습니다. 참석자가 컨퍼런스에 참여하면 고유 ID가 할당됩니다.

참여자 세션

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

녹화

회의가 녹화될 때 생성되는 MP4 동영상 파일 및 관련 메타데이터입니다. 녹화 파일은 회의 주최자의 Drive에 저장되며 회의 아티팩트로 검색할 수 있습니다.

SIP 주소

세션 시작 프로토콜 (SIP) 주소는 서드 파티 화상 회의 하드웨어가 Meet 회의를 찾아 참여하는 방법을 자세히 설명합니다. Meet은 SIP URI 스킴을 지원합니다.

스마트 메모

Gemini가 생성한 컨퍼런스의 핵심 사항과 작업 항목을 간략하게 요약한 내용으로, 회의 주최자의 Drive에 Docs 파일로 내보내집니다.

스크립트

회의에서 말한 대화를 캡처한 텍스트 문서로, 회의 주최자의 Drive에 Docs 파일로 내보내집니다.

스크립트 입력

회의의 참여자가 스크립트로 작성한 음성의 개별 세그먼트입니다. 각 항목에는 참여자 ID, 타임스탬프, 음성 텍스트, 언어 코드가 포함되며 회의가 종료된 후 30일 동안 사용할 수 있습니다.