Panoramica dell'API REST di Google Meet

L'API REST di Google Meet 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:

  • Crea uno spazio per le riunioni per connettere gli utenti tramite video.
  • Trova uno spazio riunioni o una conferenza in base al nome della risorsa.
  • Visualizza un elenco dei partecipanti e delle sessioni dei partecipanti.
  • Ricevere gli artefatti della riunione (registrazioni, trascrizioni e voci di trascrizione).

Puoi anche iscriverti agli eventi di Meet utilizzando l'API Google Workspace Events. Per ricevere una notifica delle modifiche, puoi iscriverti a uno spazio riunioni specifico o a tutti gli spazi riunioni appartenenti a un utente specifico. Per saperne di più, vedi Iscriversi agli eventi utilizzando l'API Google Workspace Events e Iscriversi agli eventi di 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 della riunione. 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.

Di seguito sono riportati alcuni esempi di operazioni per cui potresti voler utilizzare l'API REST di Meet:

  • Vendite e gestione degli account

    • Recuperare le informazioni sulla riunione e sui partecipanti a scopo di registrazione.
    • Recupera gli artefatti della riunione e pubblicali negli account.
    • Esegui trascrizioni e registrazioni tramite modelli di AI per generare analisi di coaching e di efficacia delle vendite.

  • Apprendimento e sviluppo

    • Crea e preconfigura riunioni per l'addestramento.
    • Assegna ruoli di co-organizzatore a formatori e responsabili di sessione.
    • Recupera le registrazioni che consentono agli studenti di rivedere i materiali dopo la fine del corso.

  • Operazioni per sviluppatori

    • Crea riunioni per entrare subito in contatto con i colleghi.
    • Consenti ad altri stakeholder di partecipare alle riunioni in corso condividendo informazioni in tempo reale sulla riunione e sui partecipanti.
    • Esegui i dati di trascrizione tramite modelli di AI 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.

Puoi anche incorporare altre API Google Workspace, come l'API Chat, nella tua app per migliorare ulteriormente la collaborazione. Per ulteriori informazioni, consulta la sezione Casi d'uso di Chat.

Termini comuni

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

Artefatto
Un file generato da Meet in risposta a una conferenza, ad esempio recordings e transcripts. In genere, un artefatto è pronto per essere recuperato poco dopo la fine della conferenza.
Evento nel calendario
Un evento in Google Calendar con più partecipanti, in genere creato da un organizzatore della riunione, contenente le informazioni per partecipare a una riunione. Meet potrebbe essere la soluzione di conferenza per l'evento.
Call
Una sessione che utilizza Meet o per notificare ad altri che una chiamata sta per iniziare o è in corso e consentire loro di partecipare immediatamente.
Conferenza
Una conferenza è un'istanza di una chiamata all'interno di uno spazio riunioni. Gli utenti in genere considerano questo scenario 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 una chiamata (l'organizzatore della riunione) o la persona che controlla la chiamata. Tieni presente che un organizzatore può organizzare la riunione ma non essere presente quando si svolge. Un organizzatore può anche delegare i privilegi di organizzatore a un co-organizzatore.
Codice riunione

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

I codici riunione non devono essere memorizzati a lungo termine, in quanto possono essere dissociati da uno spazio riunioni e possono essere riutilizzati per spazi riunioni diversi in futuro. In genere, i codici riunione scadono 365 giorni dopo l'ultimo utilizzo. Per maggiori informazioni, vedi Informazioni sui codici riunione in Google Meet.

Nome della riunione

Un ID univoco generato dal server utilizzato per identificare uno spazio per le riunioni. Fa distinzione tra maiuscole e minuscole. 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 di incontro. Questo utente può essere considerato anche 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 persistente (ad esempio una sala riunioni) in cui si tiene una conferenza. In uno spazio può essere tenuta una sola conferenza attiva alla volta. Uno spazio per riunioni aiuta anche gli utenti a incontrarsi e trovare risorse condivise.

URI riunione

Un URL cliccabile che avvia o unisce 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 che ha partecipato a una chiamata o che utilizza la modalità Complementare, che guarda come spettatore o un dispositivo per sale connesso a una chiamata. C'è una participants risorsa per ogni persona. Quando un partecipante si unisce alla conferenza, viene assegnato un ID univoco.

Sessione del partecipante

Un ID sessione univoco creato per ogni coppia partecipante-dispositivo che partecipa a una chiamata. Esiste una risorsa participantSessions per ogni sessione. Se lo stesso partecipante partecipa più volte alla stessa chiamata dalla stessa coppia partecipante-dispositivo, a ciascuna partecipazione vengono assegnati ID sessione univoci.