Google Meet Media API 및 연결된 OAuth 2.0 범위를 사용하려면 앱이 다음 요구사항을 준수해야 합니다.
기술 요구사항
Meet Media API를 사용할 때는 다음과 같은 제약조건이 적용됩니다.
클라이언트는 다음 코덱을 모두 지원해야 합니다.
AV1VP9VP8
클라이언트는 다음을 포함하여 Meet Media API의 코덱 요구사항을 준수하는 코덱 구현을 사용해야 합니다.
VP8또는VP9를 디코딩하는libvpx(Google)AV1을 디코딩하는dav1d(VideoLAN)
클라이언트는 다음 WebRTC 헤더 확장을 지원해야 합니다.
- 절대 전송 시간
- 전송 전반의 혼잡 제어
- 절대 캡처 시간
- 종속 항목 설명어
- 오디오 수준 표시
(
urn:ietf:params:rtp-hdrext:ssrc-audio-level)
클라이언트는 전체 측정항목 모음을 주기적으로 전송해야 합니다. 자세한 내용은 클라이언트 측정항목 페이지를 참고하세요.
최상의 결과와 지원을 위해 다음을 따르세요.
클라이언트는 사용해야 하며 버전은 최신
STABLEChromium 출시 버전보다 12개월 이상 뒤처지지 않아야 합니다.libwebrtcChromium 브라우저는libwebrtc를 사용하여 WebRTC 자바스크립트 API를 구현합니다.클라이언트는 최소 4Mbps 의 대역폭을 유지해야 합니다.
Meet REST API 사용 설정
Google API를 사용하려면 먼저 Google Cloud 프로젝트에서 API를 사용 설정해야 합니다. 단일 Google Cloud 프로젝트에서 하나 이상의 API를 사용 설정할 수 있습니다.Google Cloud 콘솔에서 Google Meet REST API를 사용 설정합니다.
코덱 지원 중단 정책
Google은 언제든지 코덱 사용을 중단할 권리를 보유합니다.
새 코덱이 도입되면 개발자는 클라이언트가 이 코덱을 지원해야 하기 12개월 전에 알림을 받게 됩니다.
인증 및 승인
Google Meet Media API 클라이언트는 인증 및 승인을 위해 OAuth 2.0을 사용하여 특정 사용자를 대신하여 회의에 연결합니다.
적절한 액세스
을 참고하세요.Meet Media API 범위
승인 범위는 앱이 회의 콘텐츠에 액세스할 수 있도록 사용자에게 승인을 요청하는 권한입니다. 사용자가 앱을 설치하면 이러한 범위를 확인하라는 메시지가 표시됩니다. 일반적으로 가능한 한 가장 좁은 범위의 범위를 선택하고 앱에 필요하지 않은 범위를 요청하지 않아야 합니다. 사용자는 제한적이고 명확하게 설명된 범위에 더 쉽게 액세스 권한을 부여합니다.
Meet Media API는 다음 OAuth 2.0 범위를 지원합니다.
| 범위 코드 | 설명 | 사용 |
|---|---|---|
https://www.googleapis.com/auth/meetings.conference.media.readonly |
Google Meet 영상 통화에서 실시간 동영상 및 오디오를 캡처합니다. | 제한됨 |
https://www.googleapis.com/auth/meetings.conference.media.audio.readonly |
Google Meet 영상 통화에서 실시간 오디오를 캡처합니다. | 제한됨 |
https://www.googleapis.com/auth/meetings.conference.media.video.readonly |
Google Meet 영상 통화에서 실시간 동영상을 캡처합니다. | 제한됨 |
회의의 민감한 특성으로 인해 모든 Meet Media API 범위가 제한됩니다.
- 제한됨: 이러한 범위는 Google 사용자 데이터에 대한 광범위한 액세스 권한을 제공하며 제한된 범위 확인 절차를 거쳐야 합니다. 이 요구사항에 관한 자세한 내용은 Google API 서비스 사용자 데이터 정책 및 특정 API 범위의 추가 요구사항을 참고하세요. 서버에 제한된 범위 데이터를 저장하거나 전송하는 경우 보안 평가를 거쳐야 합니다.
Meet Media API 범위 외에도 OAuth를 사용하여 일반 읽기 회의 범위를 요청해야 합니다. 이 범위는 참석자 및 미디어 항목 정보와 같은 회의 메타데이터에 액세스하고 성공적인 연결을 협상하는 데 필요합니다.
| 범위 코드 | 설명 | 사용 |
|---|---|---|
https://www.googleapis.com/auth/meetings.space.read |
앱이 사용자에게 액세스 권한이 있는 회의 공간에 관한 메타데이터를 읽을 수 있도록 허용합니다. | 민감한 콘텐츠 |
앱에 다른 Google API에 대한 액세스 권한이 필요한 경우 이러한 범위도 추가할 수 있습니다. Google API 범위에 관한 자세한 내용은 OAuth 2.0을 사용하여 Google API에 액세스를 참고하세요.
사용자와 앱 검토자에게 표시되는 정보를 정의하려면 OAuth 동의 화면 구성 및 범위 선택을 참고하세요.
특정 OAuth 2.0 범위에 관한 자세한 내용은 Google API의 OAuth 2.0 범위 를 참고하세요.
최종 사용자 요구사항
Meet Media API를 사용하려면 회의가 자격 요건을 충족하기 위해 Meet 참석자도 몇 가지 최소 요구사항을 충족해야 합니다.
모바일 앱 버전
모바일 사용자의 경우 다음 버전으로 업데이트해야 합니다.
| 플랫폼 | 앱 | 버전 |
|---|---|---|
| Android | Meet 앱 | 309 |
| iOS | Meet 앱 | 308 |
| Android | Gmail 앱 | 2025.05.30 |
| iOS | Gmail 앱 | 6.0.250518 |
지원되지 않는 플랫폼
Meet을 실행하는 서드 파티 하드웨어 클라이언트는 지원되지 않습니다. 예를 들어 최종 사용자가 Meet을 실행하는 Cisco 하드웨어 회의실 기기를 사용하는 경우 Meet Media API 인스턴스가 통화에 참여할 수 없습니다.
연령 제한
Meet Media API는 미성년자에게 등록된 계정에서 미디어를 수집하는 것이 제한됩니다.
이러한 계정은 일반적으로 각 국가의 동의 연령 미만 (일반적으로 만 18세 미만)이거나 Google Family Link 애플리케이션에서 부모가 계정을 만들 때 동의 연령 미만이었습니다.
일부 지역 (예: EU)에서는 미성년자로 간주되는 계정 유형에 추가 제한사항이 있습니다.
사용자 계정 중 하나가 제한되어 있다고 생각되면 연령 인증을 제공하여 계정의 연령이 인증되었는지 확인할 수 있습니다. 연령 인증에 관해 자세히 알아보기.