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 agli 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 per riunioni o una conferenza in base al nome della risorsa.
  • Visualizza un elenco di partecipanti e sessioni dei partecipanti.
  • Ricevere gli elementi della riunione (registrazioni, trascrizioni e voci di trascrizione).

Puoi anche iscriverti 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 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 tue esigenze creando lo spazio di riunione. Puoi anche gestire gli invitati e preconfigurare le impostazioni.

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

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

Ecco alcuni esempi di casi d'uso per cui potresti utilizzare l'API REST di Meet:

  • Vendite e gestione degli account

    • Recuperare le informazioni sulla riunione e sui partecipanti a fini di registrazione.
    • Recupera gli elementi delle riunioni 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 le riunioni per la formazione.
    • Assegna i ruoli di co-organizzatore ai formatori e ai responsabili della sessione.
    • Recuperare le registrazioni che consentono agli studenti di rivedere i materiali al termine del corso.

  • Operazioni per sviluppatori

    • Crea riunioni per mettere in contatto istantaneamente i membri del team.
    • Consenti ad altri stakeholder di partecipare alle riunioni in corso condividendo informazioni in tempo reale sulla riunione e sui partecipanti.
    • Esegui i dati della trascrizione tramite 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.

Puoi anche incorporare altre API di Google Workspace, come l'API Chat, nella tua app per migliorare ulteriormente la collaborazione. Per ulteriori informazioni, consulta 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 registrazioni e trascrizioni. In genere, un elemento è 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 della riunione, contenente le informazioni di partecipazione a una riunione. Meet potrebbe essere la soluzione per le conferenze per l'evento.
Chiama
Una sessione che utilizza Meet o per notificare ad altri che una chiamata è in corso o sta per iniziare e consentire loro di partecipare immediatamente.
Conferenza
Una conferenza è un'istanza di una chiamata all'interno di uno spazio di riunione. Gli utenti solitamente 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, tranne la 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 della riunione può organizzarla, ma non essere presente quando si svolge. Un organizzatore può anche delegare i propri privilegi a un co-organizzatore.
Codice riunione

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

I codici riunione non devono essere archiviati a lungo termine, in quanto possono essere dissociati da uno spazio di riunione e riutilizzati per spazi di riunione diversi 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 di riunione. È sensibile alle maiuscole. Ad esempio, jQCFfuBOdN5z. L'ID riunione viene restituito nel name campo di una risorsa spaces.

Organizzatore della riunione

L'utente che ha creato lo spazio di riunione. 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 persistente (ad esempio una sala riunioni) in cui si svolge una conferenza. In uno spazio è possibile tenere una sola conferenza attiva alla volta. Uno spazio di riunione aiuta inoltre gli utenti a incontrarsi e trovare risorse condivise.

URI riunione

Un URL cliccabile che avvia o fa partecipare un utente a una chiamata. Ogni chiamata ha un URL univoco costituito 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 visualizzatore o un dispositivo della stanza connesso a una chiamata. Esiste una conferenceRecords.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 di partecipante e dispositivo che partecipa a una chiamata. Esiste una conferenceRecords.participants.participantSessions risorsa per ogni sessione. Se il partecipante partecipa alla stessa chiamata più volte dalla stessa coppia partecipante-dispositivo, a ogni volta viene assegnato un ID sessione univoco.