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.
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 risorsaspaces
. - 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.
Argomenti correlati
Per scoprire di più sullo sviluppo con le API Google Workspace, inclusa la gestione dell'autenticazione e dell'autorizzazione, consulta Sviluppare su Google Workspace.
Per informazioni su come creare uno spazio per le riunioni con l'API REST di Meet, leggi la guida Lavorare con gli spazi per le riunioni.
Per scoprire come abbonarti agli eventi di Google Workspace, consulta la pagina Iscriversi agli eventi utilizzando l'API Eventi di Google Workspace.