Para usar a API Google Meet Media e os escopos do OAuth 2.0 associados a ela, seu app precisa obedecer aos seguintes requisitos.
Requisitos técnicos
As seguintes restrições são aplicadas ao trabalhar com a API Meet Media:
Os clientes precisam oferecer suporte a todos os codecs a seguir:
AV1VP9VP8
Os clientes precisam usar implementações de codec compatíveis com os requisitos de codec da API Meet Media, incluindo:
libvpx(Google) para decodificarVP8ouVP9dav1d(VideoLAN) para decodificarAV1
Os clientes precisam oferecer suporte às seguintes extensões de cabeçalho WebRTC:
- Tempo de envio absoluto
- Controle de congestionamento em toda a rede de transporte
- Tempo de captura absoluto
- Descritor de dependência
- Indicação de nível de áudio
(
urn:ietf:params:rtp-hdrext:ssrc-audio-level)
Os clientes precisam enviar periodicamente um conjunto completo de métricas. Para mais informações, consulte a página de métricas do cliente.
Para melhores resultados e suporte:
Os clientes devem usar a biblioteca
libwebrtc, e a versão não pode estar mais de 12 meses atrasada em relação à versãoSTABLEmais recente do Chromium. Os navegadores Chromium usamlibwebrtcpara implementar as APIs JavaScript do WebRTC.Os clientes devem manter uma largura de banda mínima de 4 Mbps.
Ativar a API Meet REST
Antes de usar as APIs do Google, você precisa ativá-las em um projeto na nuvem 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.
Política de descontinuação de codec
O Google se reserva o direito de interromper o uso de um codec a qualquer momento.
Quando um novo codec for introduzido, os desenvolvedores vão receber um aviso de 12 meses 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 OAuth 2.0 para autenticação e autorização.
Acesso adequado
Escopos da API Meet Media
Os escopos de autorização são as permissões que você pede aos usuários para autorizar o acesso do seu 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 restrito possível e evite pedir escopos que seu app não exige. Os usuários concedem acesso com mais facilidade a escopos limitados e claramente descritos.
A API Meet Media oferece suporte ao 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:
- Restrito: esses escopos oferecem amplo acesso aos dados do usuário do Google e exigem que você passe por um processo de verificação de escopo restrito. Para informações sobre esse requisito, consulte a Política de dados do usuário dos serviços da API do Google e os Requisitos adicionais dos escopos específicos da API. Se você armazena dados de escopo restrito em servidores (ou transmite), é necessário passar por uma avaliação de segurança.
Além dos escopos da API Meet Media, você também precisa solicitar o escopo geral de leitura de reuniões com o OAuth. Esse escopo é necessário para acessar metadados de reuniões, como informações de participantes e entradas de mídia, e para negociar uma conexão bem-sucedida.
| Código do escopo | Descrição | Uso |
|---|---|---|
https://www.googleapis.com/auth/meetings.space.read |
Permite que os apps leiam metadados sobre qualquer espaço para reuniões a que o usuário tenha acesso. | Sensível |
Se o app precisar de acesso a outras APIs do Google, você também poderá adicionar esses escopos. Para mais informações sobre os escopos da API 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 permissão 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 do app 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 | 2025.05.30 |
| 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 é restrita à coleta de mídia de contas registradas para menores de idade.
Essas são geralmente contas que estão abaixo da idade de consentimento no país em questão (normalmente menores de 18 anos) ou que estavam abaixo da idade de consentimento quando a conta foi criada por um familiar responsável no aplicativo Google Family Link.
Algumas regiões (como a UE) têm outras restrições sobre o tipo de contas consideradas menores de idade.
Se você acredita que uma das contas do usuário está restrita, pode fornecer a confirmação de idade para conferir se a conta foi verificada. Aprenda a confirmar sua idade.