Meet Media API 시작하기

Google Meet Media API 및 관련 OAuth 2.0 범위를 사용하려면 앱이 다음 요구사항을 준수해야 합니다.

기술 요구사항

Meet Media API를 사용할 때는 다음 제약 조건이 적용됩니다.

최상의 결과와 지원을 받으려면 다음을 참고하세요.

  • 클라이언트는 libwebrtc 라이브러리를 사용해야 합니다. 버전은 최신 STABLE Chromium 출시보다 12개월 이상 뒤처져서는 안 됩니다. Chromium 브라우저는 libwebrtc를 사용하여 WebRTC JavaScript API를 구현합니다.

  • 클라이언트는 최소 대역폭 4Mbps를 유지해야 합니다.

Meet REST API 사용 설정

Google API를 사용하려면 먼저 Google Cloud 프로젝트에서 사용 설정해야 합니다. 단일 Google Cloud 프로젝트에서 하나 이상의 API를 사용 설정할 수 있습니다.

  • Google Cloud 콘솔에서 Google Meet REST API를 사용 설정합니다.

    API 사용 설정

코덱 지원 중단 정책

  • Google은 언제든지 코덱 사용을 중지할 권리를 보유합니다.

  • 새 코덱이 도입되면 클라이언트가 이 코덱을 지원해야 하기 12개월 전에 개발자에게 알림이 전송됩니다.

인증 및 승인

Google Meet Media API 클라이언트는 인증 및 승인에 OAuth 2.0을 사용하여 특정 사용자를 대신하여 회의에 연결합니다.

적절한 액세스

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 미디어 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)에서는 미성년자로 간주되는 계정의 종류에 추가 제한사항이 있습니다.

사용자의 계정 중 하나가 제한되었다고 생각되면 연령 인증을 제공하여 계정의 연령이 인증되었는지 확인할 수 있습니다. 연령 인증에 관해 자세히 알아보기