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 e configura spazi per le riunioni per connettere gli utenti tramite video.
  • Preconfigura i livelli di accesso allo spazio, le impostazioni di moderazione e le registrazioni o le trascrizioni automatiche.
  • Gestisci i membri dello spazio riunioni e assegna i ruoli di co-organizzatore.
  • Termina una conferenza attiva in modo programmatico all'interno di uno spazio per riunioni.
  • Recupera le registrazioni delle conferenze, i dettagli della partecipazione e i metadati delle sessioni dei partecipanti.
  • Recupera gli artefatti della riunione (registrazioni, trascrizioni, voci di trascrizione e appunti intelligenti).

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 ulteriori informazioni, vedi:

Casi d'uso

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

  • Prima di una conferenza: crea spazi per le riunioni on demand, preconfigura le limitazioni di accesso (aperto, attendibile o limitato), applica i controlli di moderazione (condivisione schermo, chat, reazioni, microfono e videocamera), configura la registrazione o la trascrizione automatica e assegna ai membri dello spazio i ruoli di co-organizzatore.

  • Durante una conferenza: recupera i metadati della conferenza attiva e le sessioni dei partecipanti, gestisci i membri in modo dinamico, ascolta gli eventi del ciclo di vita in tempo reale utilizzando l'API Google Workspace Events o termina la conferenza attiva in modo programmatico.

  • Dopo una conferenza: recupera i record della conferenza e i log di partecipazione, scarica le registrazioni, le trascrizioni di Documenti Google e gli appunti intelligenti da Google Drive e accedi alle voci di trascrizione granulari per il coaching, la conformità o l'analisi dell'AI.

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 delle sessioni.
    • Recupera le registrazioni che consentono agli studenti di rivedere i materiali dopo la fine del corso.

  • Assistenza e consulenza clienti

    • Crea spazi per riunioni sicuri e con accesso limitato direttamente dai ticket dell'help desk o dai portali clienti.
    • Preconfigura la gestione dell'organizzatore in modo che solo gli addetti all'assistenza possano presentare o gestire la partecipazione.
    • Attiva la registrazione o la trascrizione automatica per i record di conformità e garanzia di qualità.
    • Terminare in modo programmatico le conferenze attive al termine degli appuntamenti o delle sessioni di assistenza.

  • 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 saperne di più, consulta Casi d'uso di Chat.

Termini comuni

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

Conferenza attiva
La conferenza in corso che si svolge all'interno di uno spazio per riunioni. In uno spazio riunioni può essere attiva una sola conferenza alla volta. Una volta terminata, diventa un record della conferenza storico.
Artefatto
Un file generato da Meet in risposta a una conferenza, ad esempio recordings, transcripts, e smartNotes. Gli artefatti vengono salvati nel Drive dell'organizzatore della riunione. In genere sono pronti per essere recuperati poco dopo la fine di una conferenza.
Evento di 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 comunicare ad altri che una chiamata sta per iniziare o è in corso e consentire loro di partecipare immediatamente.
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.
Conferenza
Una conferenza è un'istanza di una chiamata all'interno di uno spazio per le riunioni. Gli utenti in genere considerano questo scenario una singola riunione.
Record di conference
Un ID univoco per ogni istanza di una conferenza. Viene creato automaticamente all'inizio della conferenza. La risorsa conferenceRecords utilizza il formato conferenceRecords/{conferenceRecord}. Ad esempio, conferenceRecords/kRyYx8b7vNDsLpR1tG_cNjFUQBoBRhHIMoGJAJkBCQ.
Connessione via telefono
Per utilizzare uno smartphone per partecipare a una chiamata o per ascoltare una chiamata in streaming.
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 fa distinzione tra maiuscole e minuscole. 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 riunione e possono essere riutilizzati per spazi riunione diversi in futuro. In genere, i codici riunione scadono 365 giorni dopo l'ultimo utilizzo. Per maggiori informazioni, consulta Scopri di più sui codici riunione in Google Meet.

Nome riunione

Un ID univoco generato dal server utilizzato per identificare uno spazio per riunioni. Fa distinzione tra maiuscole e minuscole. Ad esempio, jQCFfuBOdN5z. L'ID riunione viene restituito nel campo name di una risorsa spaces. Per saperne di più, vedi Come Meet identifica uno spazio per le riunioni.

Organizzatore della riunione

L'utente che ha creato lo spazio riunioni. Questo utente può essere considerato anche 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. In uno spazio può essere attiva una sola conferenza 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.

Membro

Un utente aggiunto esplicitamente a uno spazio per riunioni con un ruolo designato (ad esempio COHOST). A differenza di un partecipante presente solo durante una conferenza live, un membro è associato allo spazio per riunioni persistente e mantiene i propri privilegi in più conferenze nello spazio.

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. Esiste 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 sessione vengono assegnati ID univoci.

Registrazione

Un file video MP4 e i metadati associati generati durante la registrazione di una conferenza. Le registrazioni vengono salvate sul Drive dell'organizzatore della riunione e possono essere recuperate come artefatti della riunione.

Indirizzo SIP

Un indirizzo Session Initiation Protocol (SIP) specifica in che modo l'hardware per videoconferenze di terze parti può trovare e partecipare a una conferenza Meet. Meet supporta lo schema URI SIP.

Nota intelligente

Un riepilogo conciso dei punti chiave e delle attività di una conferenza generato da Gemini ed esportato in Drive dell'organizzatore della riunione come file di Documenti.

Trascrizione

Un documento di testo che acquisisce la conversazione parlata di una conferenza, esportato sul Drive dell'organizzatore della riunione come file di Documenti.

Inserimento della trascrizione

Un segmento discreto di discorso trascritto di un partecipante a una conferenza. Ogni voce include l'identità del partecipante, il timestamp, il testo parlato e il codice lingua ed è disponibile per 30 giorni dopo la fine della conferenza.