Google Meet 회의 공간 개요

Google Meet REST API 그림

이 가이드에서는 Google Meet REST API를 사용하여 Google Meet의 회의를 만들고 관리하는 방법을 설명합니다.

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

회의실을 사용하려면 회의실 만들기 및 관리하기를 참고하세요. 프로그래매틱 방식으로 회의실을 구성하는 방법을 알아보려면 회의실 및 회원 구성을 참고하세요.

회의 스페이스 메서드를 호출하는 방법

다음 표에는 회의 스페이스 메서드를 사용하는 데 필요한 회의 역할이 자세히 설명되어 있습니다.

메서드 소유자 참여자 기타
endActiveConference x
get x x x
     설정 사용 x
     활성 회의가 있는 경우 x x
patch x

Meet에서 회의 스페이스를 식별하는 방법

Google Meet REST API는 각 회의 스페이스에 대해 spaces 리소스를 생성합니다. spaces 리소스는 회의에 참여하기 위한 여러 진입점을 제공합니다.

다음 표에는 회의 스페이스를 식별하고 참여하는 방법이 나와 있습니다.

필드 이름 설명
name 스페이스의 이름입니다. {space} 문자열은 스페이스의 리소스 식별자이며 spaces/{space} 형식입니다. 서버에서 생성된 고유 ID이며 대소문자를 구분합니다. 예를 들면 spaces/jQCFfuBOdN5z입니다.
meetingCode 스페이스 이름의 별칭입니다. {meetingCode}는 입력 가능한 고유한 문자열이며 대소문자를 구분하지 않습니다. 형식은 spaces/{meetingCode}입니다. 예를 들면 spaces/abc-mnop-xyz입니다. 최대 길이는 128자(영문 기준)입니다. meetingUri의 일부를 구성합니다. https://meet.google.com/abc-mnop-xyz
phoneAccess 이 회의 스페이스의 전화 액세스 방법입니다. phoneAccess 객체에는 회의 공간의 지역 전화번호와 해당 전화번호에 고유한 PIN 코드를 비롯해 회의에 전화를 걸 때 필요한 정보가 포함되어 있습니다. PIN은 10진수 숫자만으로 구성되며 길이는 다를 수 있습니다. 예: "pin": 19707127300

Meet UI와 마찬가지로 spaces 리소스에는 제한된 다이얼 인 번호가 포함됩니다. 다음 URL(https://meet.google.com/tel/)에 {meetingCode}를 추가하여 회의실의 추가 전화번호를 확인할 수 있습니다. 예: https://meet.google.com/tel/abc-mnop-xyz
gatewaySipAccess 이 회의 스페이스의 세션 시작 프로토콜 (SIP) 액세스 방법입니다. SIP 주소는 서드 파티 화상 회의 하드웨어에서 Meet 회의를 찾아 참여하는 방법을 자세히 설명합니다. gatewaySipAccess 객체에는 URI와 숫자 액세스 코드가 포함됩니다. Meet은 SIP URI 스킴을 지원합니다.

회의 스페이스를 관리하려면 name 필드에 다음 값을 사용하세요.

  • 회의실에 대한 세부정보를 가져오려면 spaces/{space} 또는 별칭 spaces/{meetingCode}를 사용하면 됩니다. 자세한 내용은 회의 공간 확보하기를 참고하세요.

  • 회의 스페이스의 세부정보를 업데이트하려면 spaces/{space}만 사용할 수 있습니다. 자세한 내용은 회의 스페이스 업데이트를 참고하세요.

  • 회의 스페이스 내에서 활성 회의를 종료하려면 spaces/{space}만 사용할 수 있습니다. 자세한 내용은 활성 회의 종료를 참고하세요.

회의 공간의 수명 주기

회의 공간은 수명 주기 동안 여러 상태를 거칩니다. 다음 다이어그램은 회의실 수명 주기의 대략적인 단계를 보여줍니다.

회의실 수명 주기입니다.
그림 1. 회의실의 수명 주기

  1. spaces.create 호출 회의 공간이 생성되고 반환된 spaces 객체에 meetingUri 문자열이 포함됩니다. 그런 다음 meetingUri가 참여자에게 배포됩니다.

  2. 새 회의 공간에 대한 설문조사 spaces.get 메서드를 호출하여 회의 상태를 확인합니다.

    폴링 대신 Meet 이벤트를 구독하여 푸시 알림을 받을 수도 있습니다.

  3. 컨퍼런스를 시작합니다. 첫 번째 참석자가 회의 스페이스 내에서 meetingUri를 클릭하면 회의가 시작됩니다. activeConference 객체가 채워지고 activeConference.conferenceRecord 문자열이 설정됩니다.

  4. (선택사항) 컨퍼런스 데이터 가져오기 활성 회의 중에 일부 conferenceRecord 값에 액세스할 수 있습니다. 예를 들어 conferenceRecords.participants.list 메서드를 호출하여 회의의 모든 참여자를 확인합니다. 컨퍼런스 후 최대 30일 동안 이 정보에 액세스할 수도 있습니다.

  5. (선택사항) 컨퍼런스를 종료합니다. 회의 중에 회의 소유자는 spaces.endActiveConference 메서드를 호출하여 모든 참여자의 활성 회의를 프로그래매틱 방식으로 종료할 수 있습니다.

  6. 회의가 종료됩니다. 마지막 참여자가 나가면 회의가 종료됩니다.

  7. 회의 후 아티팩트 폴링 회의가 종료되었지만(STATE=ENDED) 아직 아티팩트가 생성되지 않았습니다. 회의의 startTime 및 endTime도 채워집니다. 아티팩트 객체 STATE가 FILE_GENERATED을 읽을 때까지 아티팩트 엔드포인트를 폴링해야 합니다.

    폴링 대신 Meet 이벤트를 구독하여 푸시 알림을 받을 수 있습니다.

  8. 회의 후 아티팩트 받기 녹음 파일 및 스크립트와 같은 아티팩트는 생성된 후 검색할 수 있습니다. 예를 들어 conferenceRecords.recordings.get 메서드를 호출하여 녹음 파일 ID로 녹음 파일을 가져옵니다.

    준비가 완료되면 아티팩트 객체의 URI가 채워지고 리소스 객체의 일부로 반환됩니다.