Panoramica dell'API REST di Google Meet

L'API REST Google Meet ti consente di creare e gestire riunioni per Google Meet e offre punti di ingresso agli utenti direttamente dalla tua app.

Con l'API REST Meet, puoi:

  • Crea uno spazio per le riunioni per mettere in contatto gli utenti tramite video.
  • Ottieni uno spazio per le riunioni o una conferenza in base al nome della risorsa.
  • Recuperare un elenco dei partecipanti e delle sessioni dei partecipanti.
  • Recupera gli elementi delle riunioni (registrazioni, trascrizioni e voci della trascrizione).

Puoi anche abbonarti agli eventi di Meet utilizzando l'API Google Workspace Events. Per ricevere notifiche sulle modifiche, puoi iscriverti a uno spazio riunioni specifico o a tutti gli spazi riunioni appartenenti a un determinato utente. Per maggiori informazioni, vedi Abbonarsi agli eventi utilizzando l'API Google Workspace Events e Abbonarsi agli eventi Google Meet.

Casi d'uso

Le app possono integrarsi con l'API REST Meet per eseguire le seguenti attività:

  • Prima di una conferenza: personalizza l'esperienza della conferenza in base alle tue esigenze creando lo spazio per le riunioni. Puoi anche gestire gli invitati e preconfigurare le impostazioni.

  • Durante una conferenza: recupera le informazioni sulla conferenza per modificare l'esperienza dell'app in base ai metadati restituiti.

  • Dopo una conferenza: recupera gli artefatti della conferenza, come la registrazione e la trascrizione.

Ecco alcuni esempi di ciò per cui potresti voler utilizzare l'API REST Meet:

  • Vendite e gestione dell'account

    • Recuperare le informazioni sulla riunione e sui partecipanti per la registrazione.
    • Recupera gli elementi della riunione e pubblicali negli account.
    • Esegui trascrizioni e registrazioni tramite modelli di IA per generare coaching e analisi dell'efficacia delle vendite.

  • Apprendimento e sviluppo

    • Crea e preconfigura riunioni per la formazione.
    • Assegnare ruoli di co-organizzatore a formatori e lead di sessione.
    • Recupera le registrazioni che consentono agli studenti di rivedere i materiali al termine del corso.

  • Operazioni degli sviluppatori

    • Crea riunioni per mettere in contatto istantaneamente i membri del tuo team.
    • Consenti ad altri stakeholder di partecipare alle riunioni in corso condividendo le informazioni sulle riunioni e sui partecipanti in tempo reale.
    • Esegui i dati della trascrizione attraverso modelli di IA per generare i passaggi successivi corretti.
Crea e partecipa a una riunione dinamica con i tuoi colleghi all'interno di uno spazio di Chat.
Figura 1. Crea e partecipa a una riunione dinamica con i tuoi colleghi all'interno di uno spazio di Chat.

Nella tua app puoi anche incorporare altre API Google Workspace, come l'API Chat, per portare ulteriormente la collaborazione. Per maggiori informazioni, vedi Casi d'uso di Chat.

Termini comuni

Di seguito è riportato un elenco dei termini comuni utilizzati in questa API:

Artefatto
Un file generato da Meet in risposta a una conferenza, ad esempio registrazioni e transcripts. In genere un artefatto è pronto per essere recuperato poco dopo la fine di una conferenza.
Evento nel calendario
Un evento in Google Calendar con più partecipanti, in genere creato da un organizzatore di riunione, contenente le informazioni per partecipare di una riunione. Meet potrebbe essere la soluzione per conferenza per l'evento.
Call
Una sessione con Meet o per informare altre persone che una chiamata sta iniziando o è in corso e consentire loro di partecipare immediatamente.
Conferenza
Una conferenza è un'istanza di una chiamata all'interno di uno spazio per riunioni. Gli utenti in genere considerano questo scenario come una singola riunione.
Co-organizzatore
Una persona in una chiamata a cui sono stati concessi i privilegi di gestione dell'organizzatore da un organizzatore, ad eccezione della possibilità di rimuovere l'organizzatore originale.
Host
La persona che ha creato una chiamata (l'organizzatore della riunione) o la persona che controlla la chiamata. Tieni presente che l'organizzatore può organizzare la riunione, ma non essere presente. Un organizzatore può anche delegare i privilegi dell'organizzatore a un co-organizzatore.
Codice riunione

Una stringa univoca digitabile di 10 caratteri per uno spazio per le riunioni utilizzato all'interno dell'URI della riunione di uno spazio per riunioni. Non distingue maiuscole e minuscole. Ad esempio, abc-mnop-xyz. La lunghezza massima è di 128 caratteri.

I codici riunione non devono essere archiviati a lungo termine, perché possono essere dissociati da uno spazio per le riunioni e possono essere riutilizzati per diversi spazi riunioni in futuro. In genere, i codici riunione scadono 365 giorni dopo l'ultimo utilizzo. Per maggiori informazioni, vedi Scopri di più sui codici riunione in Google Meet.

Nome riunione

Un ID univoco generato dal server utilizzato per identificare uno spazio per le riunioni. È sensibile alle maiuscole. Ad esempio, jQCFfuBOdN5z. L'ID riunione viene restituito nel campo name di una risorsa spaces.

Organizzatore della riunione

L'utente che ha creato lo spazio per le riunioni. Questo utente può anche essere considerato il proprietario della riunione. Potrebbe non essere presente durante la chiamata o essere l'organizzatore della riunione. Può esserci un solo organizzatore della riunione.

Spazio per le riunioni

Un luogo virtuale o un oggetto permanente (ad esempio una sala riunioni) in cui si tiene una conferenza. È possibile tenere una sola conferenza attiva alla volta in uno spazio. Uno spazio per le riunioni consente inoltre agli utenti di incontrare e trovare risorse condivise.

URI riunione

Un URL cliccabile che avvia o collega un utente a una chiamata. Ogni chiamata ha un URL univoco composto da https://meet.google.com/ seguito dal codice riunione. Ad esempio: https://meet.google.com/abc-mnop-xyz.

Partecipante

Una persona si è unita a una chiamata o che utilizza la modalità Complementare, sta guardando come spettatore o su un dispositivo della stanza connesso a una chiamata. Esiste una risorsa conferenceRecords.participants per ogni persona. Quando un partecipante partecipa alla conferenza, viene assegnato un ID univoco.

Sessione per i partecipanti

Un ID sessione univoco creato per ogni coppia di dispositivo partecipante-dispositivo che partecipa a una chiamata. Esiste una risorsa conferenceRecords.participants.participantSessions per ogni sessione. Se il partecipante partecipa alla stessa chiamata più volte dalla stessa coppia partecipante-dispositivo, a ogni partecipante viene assegnato un ID sessione univoco.

Informazioni su autorizzazione e autenticazione specifiche dell'API

Gli ambiti di autorizzazione sono le autorizzazioni che richiedi agli utenti di autorizzare affinché la tua app possa accedere ai contenuti della riunione. Quando un utente installa la tua app, gli viene chiesto di convalidare questi ambiti. In genere, dovresti scegliere l'ambito più ristretto possibile ed evitare di richiedere ambiti non richiesti dalla tua app. Gli utenti concedono più facilmente l'accesso ad ambiti limitati e descritti in modo chiaro.

L'API REST Meet supporta i seguenti ambiti OAuth 2.0:

Codice ambito Descrizione Utilizzo
https://www.googleapis.com/auth/meetings.space.readonly Consenti alle app di leggere i metadati relativi agli spazi delle riunioni a cui l'utente ha accesso. Sensibile
https://www.googleapis.com/auth/meetings.space.created Consenti alle app di creare, modificare e leggere metadati relativi agli spazi delle riunioni creati dalla tua app. Sensibile
https://www.googleapis.com/auth/drive.readonly Consenti alle app di scaricare file di registrazioni e trascrizioni dall'API Google Drive. Con restrizioni

Per maggiori informazioni sugli ambiti OAuth 2.0 specifici, vedi Ambiti OAuth 2.0 per le API di Google.