이 가이드에서는 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에 {meetingCode}를 추가하여 회의 공간의 추가 전화번호를 확인할 수 있습니다. https://meet.google.com/tel/ 예를 들어 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}만 사용할 수 있습니다. 자세한 내용은 활성 회의 종료를 참고하세요.
회의 공간의 수명 주기
회의 공간은 수명 주기 동안 여러 상태를 거칩니다. 다음 다이어그램은 회의 공간 수명 주기의 대략적인 단계를 보여줍니다.
호출
spaces.create. 회의 공간이 생성되고 반환된spaces객체에meetingUri문자열이 포함됩니다. 그러면meetingUri가 참여자에게 배포됩니다.새 회의 공간을 폴링합니다.
spaces.get메서드를 호출하여 회의 상태를 확인합니다.폴링하는 대신 Meet 이벤트를 구독하여 푸시 알림을 받을 수도 있습니다.
회의를 시작합니다. 첫 번째 참여자가 회의 공간 내에서
meetingUri를 클릭하면 회의가 시작됩니다.activeConference객체 가 채워지고activeConference.conferenceRecord문자열이 설정됩니다.(선택사항) 회의 데이터를 가져옵니다. 활성 회의 중에는 일부
conferenceRecord값에 액세스할 수 있습니다. 예를 들어 회의의 모든 참여자를 확인하려면conferenceRecords.participants.list메서드를 호출합니다. 회의 후 최대 30일 동안 이 정보에 액세스할 수도 있습니다.(선택사항) 회의를 종료합니다. 회의 중에 회의 소유자는
spaces.endActiveConference메서드를 호출하여 모든 참여자의 활성 회의를 프로그래매틱 방식으로 종료할 수 있습니다.회의가 종료됩니다. 마지막 참여자가 퇴장하면 회의가 종료됩니다.
회의 후 아티팩트를 폴링합니다. 회의가 종료되었지만(
STATE=ENDED) 아티팩트가 아직 생성되지 않았습니다. 회의의startTime및endTime도 채워집니다. 아티팩트 객체STATE가FILE_GENERATED를 읽을 때까지 아티팩트 엔드포인트를 폴링해야 합니다.폴링하는 대신 Meet 이벤트를 구독하여 푸시 알림을 받을 수 있습니다.
회의 후 아티팩트를 가져옵니다. 녹화 및 회의록과 같은 아티팩트는 생성된 후 검색할 수 있습니다. 예를 들어
conferenceRecords.recordings.get메서드를 호출하여 녹화 ID로 녹화를 가져옵니다.준비가 완료되면 아티팩트 객체의 URI가 채워지고 리소스 객체의 일부로 반환됩니다.