Panoramica dell'API REST di Google Meet

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

Con l'API REST di Meet puoi:

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

Puoi anche abbonarti agli eventi di Meet utilizzando l'API Google Workspace Events. Per ricevere una notifica delle modifiche, puoi abbonarti a uno spazio per le riunioni specifico o a tutti gli spazi per le riunioni appartenenti a un utente specifico. Per saperne di più, vedi:

Casi d'uso

Le app possono integrarsi con l'API REST di Meet per eseguire 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 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 utilizzo dell'API REST di Meet:

  • Vendite e gestione dell'account

    • Recupera 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 ed efficacia delle vendite.

  • Apprendimento e sviluppo

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

  • Operazioni per sviluppatori

    • Crea riunioni per connettere immediatamente 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 di Google Workspace, come l'API Chat, nella tua app per migliorare ulteriormente la collaborazione. Per saperne di più, vedi 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. Gli artefatti vengono salvati sul Google 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.
Chiamata
Una sessione che utilizza Meet o per informare gli altri 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 le riunioni. In genere, gli utenti considerano questo scenario una singola riunione.
Record di conference
Un ID univoco per ogni istanza di una conferenza. Viene creato automaticamente all'avvio della conferenza. La conferenceRecords risorsa utilizza il formato conferenceRecords/{conferenceRecord}. Ad esempio, conferenceRecords/kRyYx8b7vNDsLpR1tG_cNjFUQBoBRhHIMoGJAJkBCQ.
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.
Connessione via telefono
Utilizzare un telefono per partecipare a una chiamata o per ascoltare una chiamata in streaming.
Organizzatore
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ò 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 per le riunioni utilizzato all'interno dell'URI della riunione di uno spazio per le 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 archiviati a lungo termine, in quanto possono essere dissociati da uno spazio per le riunioni e possono essere riutilizzati per spazi per le riunioni diversi in futuro. In genere, i codici riunione scadono 365 giorni dopo l'ultimo utilizzo. Per saperne di più, 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. Fa distinzione tra maiuscole e minuscole. Ad esempio, jQCFfuBOdN5z. L'ID riunione viene restituito nel name campo di una spaces risorsa. Per saperne di più, vedi Come Meet identifica uno spazio per le riunioni.

Organizzatore della riunione

L'utente che ha creato lo spazio per le riunioni. 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 le riunioni aiuta anche gli utenti a incontrarsi e a trovare risorse condivise.

URI della riunione

Un URL su cui è possibile fare clic che avvia o aggiunge 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 della sala connesso a una chiamata. Esiste una participants risorsa per ogni persona. Quando un partecipante partecipa 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 participantSessions risorsa per ogni sessione. Se il partecipante partecipa alla stessa chiamata più volte dalla stessa coppia partecipante-dispositivo, a ciascuna viene assegnato un ID sessione univoco.

Indirizzo SIP

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