Introdução à API Meet Media

Para usar a API Google Meet Media e os escopos do OAuth 2.0 associados, seu app precisa obedecer aos seguintes requisitos.

Requisitos técnicos

As restrições a seguir são aplicadas ao trabalhar com a API Meet Media:

Para ter os melhores resultados e suporte:

  • Os clientes devem usar a biblioteca libwebrtc, e a versão não pode estar mais de 12 meses atrás da versão mais recente do STABLE Chromium. Os navegadores Chromium usam libwebrtc para implementar as APIs JavaScript do WebRTC.

  • Os clientes precisam manter uma largura de banda mínima de 4 Mbps.

Ativar a API REST do Meet

Antes de usar as APIs do Google, é necessário ativá-las em um projeto do Google Cloud. É possível ativar uma ou mais APIs em um único projeto do Google Cloud.

  • No console do Google Cloud, ative a API REST do Google Meet.

    Ativar a API

Política de suspensão de uso de codecs

  • O Google se reserva o direito de parar de usar um codec a qualquer momento.

  • Quando um novo codec for lançado, os desenvolvedores vão receber um aviso com 12 meses de antecedência antes que os clientes precisem oferecer suporte a ele.

Autenticação e autorização

Os clientes da API Google Meet Media se conectam a uma conferência em nome de um usuário específico, usando o OAuth 2.0 para autenticação e autorização.

Acesso adequado

Conhecer os escopos da API Media

Os escopos de autorização são as permissões que você pede aos usuários para autorizar o acesso do app ao conteúdo da reunião. Quando alguém instala seu app, o usuário precisa validar esses escopos. Em geral, escolha o escopo mais específico possível e evite solicitar escopos que seu app não precisa. Os usuários concedem acesso mais facilmente a escopos limitados e claramente descritos.

A API Meet Media é compatível com o seguinte escopo do OAuth 2.0:

Código do escopo Descrição Uso
https://www.googleapis.com/auth/meetings.conference.media.readonly Capture vídeo e áudio em tempo real nas videochamadas do Google Meet. Restrito
https://www.googleapis.com/auth/meetings.conference.media.audio.readonly Capture áudio em tempo real nas videochamadas do Google Meet. Restrito
https://www.googleapis.com/auth/meetings.conference.media.video.readonly Capture vídeos em tempo real nas videochamadas do Google Meet. Restrito

Devido à natureza sensível das conferências, todos os escopos da API Meet Media são restritos:

Se o app precisar de acesso a outras APIs do Google, adicione esses escopos também. Para mais informações sobre os escopos das APIs do Google, consulte Como usar o OAuth 2.0 para acessar as APIs do Google.

Para definir quais informações são mostradas aos usuários e revisores de apps, consulte Configurar a tela de consentimento OAuth e escolher escopos.

Para mais informações sobre escopos específicos do OAuth 2.0, consulte Escopos do OAuth 2.0 para APIs do Google.

Requisitos do usuário final

Para usar a API Meet Media, os participantes do Meet também precisam atender a alguns requisitos mínimos para que a conferência seja qualificada.

Versões de apps para dispositivos móveis

Para usuários de dispositivos móveis, é necessário atualizar para estas versões:

Plataforma App Versão
Android App Meet 309
iOS App Meet 308
Android App do Gmail 30/05/2025
iOS App do Gmail 6.0.250518

Plataformas não compatíveis

Não oferecemos suporte a clientes de hardware de terceiros que executam o Meet. Por exemplo, se os usuários finais estiverem usando um dispositivo de sala de conferências de hardware da Cisco que executa o Meet, a instância da API Meet Media não poderá participar da chamada.

Restrições de idade

A API Meet Media não pode coletar mídia de contas registradas para menores de idade.

Geralmente, são contas de pessoas menores de idade no país em questão (normalmente menores de 18 anos) ou que tinham menos de 18 anos quando foram criadas por um familiar responsável no aplicativo Google Family Link.

Algumas regiões, como a UE, têm restrições adicionais sobre quais tipos de contas são consideradas de menores de idade.