L'API REST Google Meet ti consente di creare e gestire riunioni per Google Meet e offre punti di ingresso agli utenti direttamente dalla tua app.
Con l'API REST Meet, puoi:
- Crea uno spazio per le riunioni per mettere in contatto gli utenti tramite video.
- Ottieni uno spazio per le riunioni o una conferenza in base al nome della risorsa.
- Recuperare un elenco dei partecipanti e delle sessioni dei partecipanti.
- Recupera gli elementi delle riunioni (registrazioni, trascrizioni e voci della trascrizione).
Puoi anche abbonarti 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 maggiori informazioni, vedi Abbonarsi agli eventi utilizzando l'API Google Workspace Events e Abbonarsi agli eventi Google Meet.
Casi d'uso
Le app possono integrarsi con l'API REST Meet per eseguire le seguenti attività:
Prima di una conferenza: personalizza l'esperienza della conferenza in base alle tue 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.
Ecco alcuni esempi di ciò per cui potresti voler utilizzare l'API REST Meet:
Vendite e gestione dell'account
- Recuperare le informazioni sulla riunione e sui partecipanti per la registrazione.
- Recupera gli elementi della riunione 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 riunioni per la formazione.
- Assegnare 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 degli sviluppatori
- Crea riunioni per mettere in contatto istantaneamente i membri del tuo team.
- Consenti ad altri stakeholder di partecipare alle riunioni in corso condividendo le informazioni sulle riunioni e sui partecipanti in tempo reale.
- Esegui i dati della trascrizione attraverso 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.](https://developers.google.cn/static/meet/api/images/join-google-meet-using-third-party-chat-app-animated-gif-850-px-wide.gif?authuser=7&hl=it)
Nella tua app puoi anche incorporare altre API Google Workspace, come l'API Chat, per portare ulteriormente la collaborazione. Per maggiori informazioni, vedi 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 poco dopo la fine di una conferenza.
- Evento nel calendario
- Un evento in Google Calendar con più partecipanti, in genere creato da un organizzatore di riunione, contenente le informazioni per partecipare di una riunione. Meet potrebbe essere la soluzione per conferenza per l'evento.
- Call
- Una sessione con Meet o per informare altre persone 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 riunioni. Gli utenti in genere 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, 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 l'organizzatore può organizzare la riunione, ma non essere presente. Un organizzatore può anche delegare i privilegi dell'organizzatore a un co-organizzatore.
- Codice riunione
Una stringa univoca digitabile di 10 caratteri per uno spazio per le riunioni utilizzato all'interno dell'URI della riunione di uno spazio per riunioni. Non distingue maiuscole e minuscole. Ad esempio,
abc-mnop-xyz
. La lunghezza massima è di 128 caratteri.I codici riunione non devono essere archiviati a lungo termine, perché possono essere dissociati da uno spazio per le riunioni e possono essere riutilizzati per diversi spazi riunioni in futuro. In genere, i codici riunione scadono 365 giorni dopo l'ultimo utilizzo. Per maggiori informazioni, 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. È sensibile alle maiuscole. Ad esempio,
jQCFfuBOdN5z
. L'ID riunione viene restituito nel camponame
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. 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 permanente (ad esempio una sala riunioni) in cui si tiene una conferenza. È possibile tenere una sola conferenza attiva alla volta in uno spazio. Uno spazio per le riunioni consente inoltre agli utenti di incontrare e trovare risorse condivise.
- URI riunione
Un URL cliccabile che avvia o collega 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 si è unita a una chiamata o che utilizza la modalità Complementare, sta guardando come spettatore o su un dispositivo della stanza connesso a una chiamata. Esiste 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 di dispositivo partecipante-dispositivo che partecipa a una chiamata. Esiste 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 viene assegnato un ID sessione univoco.
Informazioni su autorizzazione e autenticazione specifiche dell'API
Gli ambiti di autorizzazione sono le autorizzazioni che richiedi agli utenti di autorizzare affinché la tua app possa accedere ai contenuti della riunione. Quando un utente installa la tua app, gli viene chiesto di convalidare questi ambiti. In genere, dovresti scegliere l'ambito più ristretto possibile ed evitare di richiedere ambiti non richiesti dalla tua app. Gli utenti concedono più facilmente l'accesso ad ambiti limitati e descritti in modo chiaro.
L'API REST 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 agli spazi delle riunioni a cui l'utente ha accesso. | Sensibile |
https://www.googleapis.com/auth/meetings.space.created |
Consenti alle app di creare, modificare e leggere metadati relativi agli spazi delle riunioni creati dalla tua app. | Sensibile |
https://www.googleapis.com/auth/drive.readonly |
Consenti alle app di scaricare file di registrazioni e trascrizioni dall'API Google Drive. | Con restrizioni |
Per maggiori informazioni sugli ambiti OAuth 2.0 specifici, vedi Ambiti OAuth 2.0 per le API di Google.
Argomenti correlati
Per informazioni sullo sviluppo con le API di 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 Meet, leggi la guida Lavorare con gli spazi per riunioni.
Per scoprire come abbonarti agli eventi di Google Workspace, consulta Iscriversi agli eventi utilizzando l'API Google Workspace Events.