Per utilizzare l'API Google Meet Media e gli ambiti OAuth associati, la tua app deve soddisfare i seguenti requisiti.
Requisiti tecnici
I seguenti vincoli vengono applicati quando si utilizza l'API Meet Media:
I client devono supportare tutti i seguenti codec:
AV1
VP9
VP8
I client devono utilizzare implementazioni di codec conformi ai requisiti dei codec dell'API Meet Media, tra cui:
libvpx
(Google) per decodificareVP8
oVP9
dav1d
(VideoLAN) per decodificareAV1
I client devono supportare le seguenti estensioni di intestazione WebRTC:
- Ora di invio assoluta
- Controllo della congestione a livello di trasporto
- Ora di acquisizione assoluta
- Descrittore dipendenza
- Indicazione del livello audio
(
urn:ietf:params:rtp-hdrext:ssrc-audio-level
)
I clienti devono inviare periodicamente una suite completa di metriche. Per ulteriori informazioni, consulta la pagina Metriche client.
Per ottenere risultati ottimali e assistenza:
I client devono utilizzare la libreria
libwebrtc
e la versione non deve essere più vecchia di 12 mesi rispetto all'ultima release diSTABLE
Chromium. I browser Chromium utilizzanolibwebrtc
per implementare le API JavaScript WebRTC.I client devono mantenere una larghezza di banda minima di 4 Mbps.
Norme sulla deprecazione dei codec
Google si riserva il diritto di interrompere l'utilizzo di un codec in qualsiasi momento.
Quando viene introdotto un nuovo codec, gli sviluppatori riceveranno un preavviso di 12 mesi prima che i clienti debbano supportarlo.
Autenticazione e autorizzazione
I client dell'API Google Meet Media si connettono a una conferenza per conto di un utente specifico utilizzando OAuth 2.0 per l'autenticazione e l'autorizzazione.
Accesso appropriato
Ambiti dell'API Meet Media
Gli ambiti di autorizzazione sono le autorizzazioni che chiedi agli utenti di concedere per consentire alla tua app di accedere ai contenuti della riunione. Quando un utente installa la tua app, gli viene chiesto di convalidare questi ambiti. In genere, devi scegliere l'ambito più specifico possibile ed evitare di richiedere ambiti non necessari per la tua app. Gli utenti concedono più facilmente l'accesso a ambiti limitati e descritti in modo chiaro.
L'API Meet Media supporta il seguente ambito OAuth 2.0:
Codice ambito | Descrizione | Utilizzo |
---|---|---|
https://www.googleapis.com/auth/meetings.conference.media.readonly |
Acquisire video e audio in tempo reale nelle videochiamate di Google Meet. | Con restrizioni |
https://www.googleapis.com/auth/meetings.conference.media.audio.readonly |
Acquisire l'audio in tempo reale nelle videochiamate di Google Meet. | Con restrizioni |
https://www.googleapis.com/auth/meetings.conference.media.video.readonly |
Acquisire video in tempo reale nelle videochiamate di Google Meet. | Con restrizioni |
A causa della natura sensibile delle conferenze, tutti gli ambiti dell'API Meet Media sono soggetti a restrizioni:
- Con restrizioni: questi ambiti forniscono un accesso ampio ai dati utente di Google e richiedono di seguire una procedura di verifica dell'ambito con restrizioni. Per informazioni su questo requisito, consulta le Norme relative ai dati utente dei servizi API di Google e i Requisiti aggiuntivi per ambiti API specifici. Se archivi (o trasmetti) dati con ambito limitato sui server, devi eseguire una valutazione della sicurezza.
Se la tua app richiede l'accesso ad altre API di Google, puoi aggiungere anche questi ambiti. Per ulteriori informazioni sugli ambiti delle API di Google, consulta l'articolo Utilizzare OAuth 2.0 per accedere alle API di Google.
Per definire le informazioni da mostrare agli utenti e ai revisori delle app, consulta Configurare la schermata per il consenso OAuth e scegliere gli ambiti.
Per ulteriori informazioni su ambiti OAuth 2.0 specifici, consulta Ambiti OAuth 2.0 per le API di Google.