Per utilizzare l'API Google Meet Media e i relativi ambiti OAuth 2.0, la tua app deve rispettare i seguenti requisiti.
Requisiti tecnici
Quando si utilizza l'API Meet Media, vengono applicate le seguenti limitazioni:
I client devono supportare tutti i seguenti codec:
AV1VP9VP8
I client devono utilizzare implementazioni di codec conformi ai requisiti dei codec dell'API Meet Media, tra cui:
libvpx(Google) per decodificareVP8oVP9dav1d(VideoLAN) per decodificareAV1
I client devono supportare le seguenti estensioni dell'intestazione WebRTC:
- Absolute Send Time
- Transport-Wide Congestion Control
- Absolute Capture Time
- Dependency Descriptor
- Audio Level Indication
(
urn:ietf:params:rtp-hdrext:ssrc-audio-level)
I client devono inviare periodicamente una suite completa di metriche. Per ulteriori informazioni, consulta la pagina delle metriche dei client.
Per risultati e assistenza ottimali:
I client devono utilizzare la
libwebrtclibreria e la versione non deve essere più vecchia di 12 mesi rispetto all'ultimaSTABLErelease di Chromium. I browser Chromium utilizzanolibwebrtcper implementare le API JavaScript WebRTC.I client devono mantenere una larghezza di banda minima di 4 Mbps.
Abilitare l'API REST di Meet
Prima di utilizzare le API di Google, devi attivarle in un progetto Google Cloud. Puoi attivare una o più API in un singolo progetto Google Cloud.Nella console Google Cloud, abilita l'API REST di Google Meet.
Norme sul ritiro 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 client siano tenuti a supportare questo codec.
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 richiedi agli utenti di autorizzare la tua app per 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 ad ambiti limitati e descritti chiaramente.
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 il 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 con restrizioni:
- Con restrizioni: questi ambiti forniscono un ampio accesso ai dati utente di Google e richiedono di completare una procedura di verifica degli ambiti 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 memorizzi (o trasmetti) dati con ambiti con restrizioni sui server, devi sottoporti a una valutazione della sicurezza.
Oltre agli ambiti dell'API Meet Media, devi anche richiedere l'ambito di lettura generale della riunione con OAuth. Questo ambito è necessario per accedere ai metadati della riunione, ad esempio alle informazioni sulle voci dei partecipanti e dei contenuti multimediali, e per negoziare una connessione riuscita.
| Codice ambito | Descrizione | Utilizzo |
|---|---|---|
https://www.googleapis.com/auth/meetings.space.read |
Consenti alle app di leggere i metadati di qualsiasi spazio riunioni a cui l'utente ha accesso. | Sensibile |
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 Utilizzare OAuth 2.0 per accedere alle API di Google.
Per definire le informazioni visualizzate dagli utenti e dai revisori delle app, consulta Configurare la schermata per il consenso OAuth e scegliere gli ambiti.
Per ulteriori informazioni sugli ambiti OAuth 2.0 specifici, consulta Ambiti OAuth 2.0 per le API di Google.
Requisiti per l'utente finale
Per poter utilizzare l'API Meet Media, i partecipanti a Meet devono soddisfare anche alcuni requisiti minimi affinché la conferenza sia idonea.
Versioni dell'app mobile
Gli utenti di dispositivi mobili devono eseguire l'aggiornamento a queste versioni:
| Piattaforma | App | Versione |
|---|---|---|
| Android | App Meet | 309 |
| iOS | App Meet | 308 |
| Android | App Gmail | 2025.05.30 |
| iOS | App Gmail | 6.0.250518 |
Piattaforme non supportate
Non supportiamo i client hardware di terze parti che eseguono Meet. Ad esempio, se gli utenti finali utilizzano un dispositivo per sale riunioni hardware Cisco che esegue Meet, la tua istanza dell'API Meet Media non può partecipare alla chiamata.
Limiti di età
L'API Meet Media non può raccogliere contenuti multimediali da account registrati a nome di minori.
Si tratta in genere di account di utenti che non hanno raggiunto l'età del consenso digitale nel rispettivo paese (in genere meno di 18 anni) o che non avevano raggiunto l'età del consenso digitale quando l'account è stato creato da un genitore nell'applicazione Google Family Link.
Tieni presente che alcune regioni (ad esempio l'UE) prevedono ulteriori limitazioni sul tipo di account considerati di utenti che non hanno raggiunto l'età del consenso.
Se ritieni che l'account di uno dei tuoi utenti sia soggetto a limitazioni, puoi fornire la verifica dell'età per controllare se l'account è verificato in base all'età. Scopri di più sulla verifica dell'età.