Panoramica dell'API REST di Google Meet

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

Con l'API REST di Meet puoi fare quanto segue:

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

Puoi anche abbonarti agli eventi di Meet utilizzando l'API Eventi di Google Workspace. Per ricevere una notifica delle modifiche, puoi abbonarti a uno spazio per le riunioni specificato o a tutti gli spazi per le riunioni appartenenti a un utente specifico. Per maggiori informazioni, consulta Iscriversi agli eventi utilizzando l'API Google Workspace Eventi e Abbonarsi agli eventi Google Meet.

casi d'uso

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

  • Prima di una conferenza: personalizza l'esperienza della conferenza in base alle 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 con l'app in base ai metadati restituiti.

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

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

  • Vendite e gestione account

    • Recuperare le informazioni sulle riunioni e sui partecipanti a scopo di registrazione.
    • Recupera gli elementi delle riunioni e pubblicali negli account.
    • Esegui trascrizioni e registrazioni tramite modelli IA per generare analisi di coaching e di efficacia delle vendite.

  • Apprendimento e sviluppo

    • Crea e preconfigura le riunioni per l'addestramento.
    • Assegna i 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 per gli sviluppatori

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

Puoi anche incorporare altre API di Google Workspace, come l'API Chat, nell'app. Per maggiori informazioni, consulta 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 subito dopo la fine di una conferenza.
Evento nel calendario
Un evento in Google Calendar con più partecipanti, in genere creato da un organizzatore di una riunione, contenente le informazioni per partecipare di una riunione. Meet potrebbe essere la soluzione per le conferenze per l'evento.
Telefono
Una sessione che utilizza Meet o per informare gli altri che una chiamata è in corso o in corso e consentire loro di partecipare immediatamente.
Conferenza
Una conferenza è un'istanza di una chiamata all'interno di uno spazio per le riunioni. In genere, gli utenti considerano questo scenario come una singola riunione.
Co-organizzatore
Una persona in una chiamata a cui sono stati concessi privilegi di gestione dell'organizzatore da un organizzatore, ad eccezione della possibilità di rimuovere l'organizzatore originale.
Host
La persona che ha creato la chiamata (l'organizzatore della riunione) o la persona che controlla la chiamata. L'organizzatore può organizzare la riunione ma non essere presente quando si svolge. Un organizzatore può anche delegare i privilegi di host a un co-organizzatore.
Codice riunione
Una stringa univoca e digitabile di 10 caratteri per uno spazio per riunioni utilizzato nell'URL di partecipazione di uno spazio per le riunioni. Ad esempio, abc-mnop-xyz. I codici riunione non devono essere archiviati a lungo termine poiché possono dissociarsi da uno spazio per le riunioni e possono essere riutilizzati in diversi spazi per le riunioni in futuro. In genere, i codici riunione scadono 365 giorni dopo l'ultimo utilizzo. Per maggiori informazioni, consulta Informazioni sui codici riunione in Google Meet.
Nome riunione
Un ID univoco generato dal server utilizzato per identificare uno spazio per le riunioni. 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. Potrebbero non essere presenti 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 persistente (ad esempio una sala riunioni) in cui si tiene una conferenza. È possibile tenere una sola conferenza attiva in un spazio in qualsiasi momento. Uno spazio per le riunioni consente inoltre agli utenti di incontrare e trovare risorse condivise.
Partecipante
Una persona partecipa a una chiamata o utilizza la modalità Complementare, come spettatore, o un dispositivo della stanza connesso a una chiamata. C'è 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 partecipante-dispositivo che partecipa a una chiamata. C'è 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 vengono assegnati ID sessione univoci.

Informazioni di autorizzazione e autenticazione specifiche per l'API

Gli ambiti di autorizzazione sono le autorizzazioni che richiedi agli utenti di autorizzare la tua app ad accedere ai contenuti delle riunioni. Quando qualcuno installa la tua app, all'utente viene chiesto di convalidare questi ambiti. In genere, dovresti scegliere l'ambito più specifico ed evitare di richiedere ambiti non richiesti dalla tua app. Gli utenti concedono più facilmente l'accesso ad ambiti limitati e descritti chiaramente.

L'API REST di 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 a qualsiasi spazio per le riunioni a cui l'utente ha accesso. Sensibile
https://www.googleapis.com/auth/meetings.space.created Consenti alle app di creare, modificare e leggere i metadati relativi agli spazi per le riunioni creati dalla tua app. Sensibile
https://www.googleapis.com/auth/drive.readonly Consenti alle app di scaricare file di registrazione e trascrizione dall'API Google Drive. Con restrizioni

Per ulteriori informazioni su specifici ambiti OAuth 2.0, consulta Ambiti OAuth 2.0 per le API di Google.