Questa guida spiega come ottenere dettagli sui diversi elementi della riunione generati da una conferenza utilizzando l'API REST di Google Meet.
Un elemento è un file o dei dati generati da Google Meet in risposta a una conferenza. Sono inclusi i video e altri elementi, come le trascrizioni.
Per produrre gli elementi, i partecipanti devono generarli in Meet prima della fine della conferenza. Le trascrizioni funzionano indipendentemente dalle registrazioni e non è necessario registrare la riunione per generare una trascrizione. Per ulteriori informazioni, vedi Registrare una riunione video e Utilizzare le trascrizioni con Google Meet.
Se sei il proprietario o un partecipante di uno spazio di riunione, puoi chiamare i metodi get()
e
list()
sulle risorse recordings
, transcripts
e
transcripts.entries
per recuperare gli elementi.
L'autenticazione e l'autorizzazione con le credenziali dell'utente consentono alle app Google Meet di accedere ai dati dell'utente ed eseguire operazioni per conto dell'utente autenticato. L'autenticazione con la delega a livello di dominio ti consente di autorizzare l'account di servizio di un'applicazione ad accedere ai dati dei tuoi utenti senza che sia necessario il consenso di ogni utente.
Conservazione degli artefatti
Al termine di una conferenza, Meet salva le registrazioni e le trascrizioni su Google Drive dell'organizzatore della riunione. Per impostazione predefinita, gli elementi di Meet vengono conservati in base alle regole di Drive.
Le voci della trascrizione fornite dall'API REST di Meet vengono eliminate 30 giorni dopo la fine della conferenza.
Puoi anche gestire la conservazione degli elementi di Meet separatamente utilizzando regole di conservazione specifiche per Meet in Google Vault. Per scoprire di più, consulta la sezione Conservare i dati di Google Meet con Vault.
Registrazioni
Le sezioni seguenti descrivono in dettaglio come ottenere informazioni sulle registrazioni in un record della conferenza.
Meet ha accesso all'ID registrazione dopo la generazione del file della registrazione. È possibile che un utente elimini il file della registrazione da Google Drive, ma il nome univoco venga comunque restituito in Meet.
La risorsa recordings
include sia gli oggetti DriveDestination
sia gli oggetti State
.
L'oggetto DriveDestination
contiene la posizione di esportazione su Drive
dove la registrazione viene salvata come file MP4. Per scaricare la registrazione o riprodurla in un browser, utilizza il valore del campo exportUri
dell'oggetto. Se hai familiarità con l'API Google Drive, il valore del campo file
corrisponde a id
nella risorsa files
. Per maggiori informazioni, consulta la sezione Scaricare ed esportare i file.
L'oggetto State
contiene lo stato della sessione di registrazione. In questo modo puoi eseguire query per sapere se la registrazione è iniziata, se è terminata, ma il file della registrazione non è pronto o se il file della registrazione è generato e pronto per il download.
Visualizzare i dettagli di una registrazione
Per visualizzare i dettagli di una registrazione specifica, utilizza il metodo
get()
nella risorsa recordings
con il parametro di percorso name
. Se non conosci il nome della registrazione,
puoi elencare tutti i nomi delle registrazioni utilizzando il metodo list()
.
Il metodo restituisce un'istanza di una risorsa recordings
.
Il seguente esempio di codice mostra come recuperare una registrazione specifica:
Java
Node.js
Python
Sostituisci il nome della registrazione con il nome dell'ID registrazione specifico in un record della conferenza.
Elenca tutte le registrazioni
Per elencare i dettagli di tutte le registrazioni in un record della conferenza, utilizza il metodo
list()
nella risorsa recordings
con il parametro di percorso parent
. Formato:
conferenceRecords/{conferenceRecord}
.
Il metodo restituisce un elenco di registrazioni delle conferenze, ordinate per startTime
in ordine crescente, come istanza di una risorsa recordings
. Per regolare le dimensioni della pagina, vedi Personalizzare la paginazione .
Il seguente esempio di codice mostra come elencare tutte le registrazioni in un record della conferenza:
Java
Node.js
Python
Sostituisci il valore principale con il nome del record della conferenza.
Trascrizioni
Le sezioni seguenti descrivono in dettaglio come ottenere informazioni sulle trascrizioni delle conferenze in un record della conferenza.
Meet ha accesso all'ID trascrizione una volta che i dati della trascrizione sono stati generati. È possibile che un utente elimini il file della trascrizione da Drive, ma il nome univoco venga comunque restituito in Meet.
La risorsa transcripts
include sia gli oggetti DocsDestination
sia gli oggetti State
.
L'oggetto DocsDestination
contiene la posizione di esportazione su Drive
dove viene salvato il file della trascrizione di Documenti Google. Per recuperare i contenuti o per esaminare la trascrizione in un browser, utilizza il valore del campo exportUri
dell'oggetto. Se hai familiarità con l'API Google Docs, il valore del campo document
corrisponde a documentId
nella risorsa documents
.
L'oggetto State
contiene lo stato della sessione di trascrizione. In questo modo puoi eseguire query per sapere se la sessione di trascrizione è iniziata, se è terminata, ma il file di trascrizione non è pronto o se il file di trascrizione è generato e pronto per il download.
Visualizzare i dettagli di una trascrizione
Per visualizzare i dettagli di una trascrizione specifica, utilizza il metodo
get()
nella risorsa
transcripts
con il parametro di percorso name
. Se non conosci il nome della trascrizione, puoi elencare tutti i nomi delle trascrizioni utilizzando il metodo list()
.
Il metodo restituisce un'istanza di una risorsa transcripts
.
Il seguente esempio di codice mostra come recuperare una trascrizione specifica:
Java
Node.js
Python
Sostituisci il nome della trascrizione con il nome dell'ID trascrizione specifico in un record della conferenza.
Elenco di tutte le trascrizioni
Per elencare i dettagli di tutte le trascrizioni in un record della conferenza, utilizza il metodo
list()
nella risorsa
transcripts
con il parametro di percorso parent
. Formato:
conferenceRecords/{conferenceRecord}
.
Il metodo restituisce un elenco di trascrizioni delle conferenze, ordinate per startTime
in ordine crescente, come istanza di una risorsa transcripts
. Per regolare le dimensioni della pagina, vedi Personalizzare la paginazione .
Il seguente esempio di codice mostra come elencare tutte le trascrizioni di una registrazione della conferenza:
Java
Node.js
Python
Sostituisci il valore principale con il nome del record della conferenza.
Voce trascrizione
Le sezioni seguenti descrivono in dettaglio come ottenere il parlato di ciascun partecipante come voci della trascrizione durante una sessione di trascrizione della conferenza.
La voce della trascrizione contiene il testo trascritto della voce del partecipante, fino a un massimo di 10.000 parole. Il testo parlato languageCode
(ad es. en-US
)
è incluso anche come sintassi IETF BCP 47.
Ogni voce della trascrizione è collegata a un nome participant
nella conferenza. Per recuperare i dettagli dei partecipanti, vedi Ottenere i dettagli di un partecipante.
I dati di inserimento della trascrizione sono disponibili per 30 giorni dopo la fine della conferenza.
Tieni presente che le voci della trascrizione restituite dall'API REST di Meet potrebbero non corrispondere alla trascrizione trovata nel file della trascrizione di Documenti. Questo accade quando il file della trascrizione viene modificato dopo la generazione.
Visualizzare i dettagli di una voce della trascrizione
Per visualizzare i dettagli di una voce della trascrizione specifica, utilizza il metodo
get()
nella risorsa
transcripts.entries
con il parametro di percorso name
. Se non conosci il nome della voce della trascrizione, puoi elencare tutti i nomi delle trascrizioni utilizzando il metodo list()
.
Il metodo restituisce un'istanza di una risorsa transcripts.entries
.
Il seguente esempio di codice mostra come recuperare una voce della trascrizione specifica:
Java
Node.js
Python
Sostituisci il nome della voce della trascrizione con il nome dell'ID voce della trascrizione specifico in una trascrizione.
Elenco di tutte le voci della trascrizione
Per elencare i dettagli di tutte le voci della trascrizione, utilizza il metodo
list()
nella risorsa
transcripts.entries
con il parametro di percorso parent
. Formato:
conferenceRecords/{conferenceRecord}/transcripts/{transcript}
.
Il metodo restituisce un elenco di voci di trascrizione strutturate per trascrizione
della conferenza, ordinate per startTime
in ordine crescente, come istanza di una
risorsa transcripts.entries
. Per regolare le dimensioni della pagina, vedi Personalizzare la paginazione .
Il seguente esempio di codice mostra come elencare tutte le voci della trascrizione in una trascrizione:
Java
Node.js
Python
Sostituisci il valore principale con il nome del record della conferenza e il nome della trascrizione.
Personalizzare l'impaginazione
Passa i seguenti parametri di query per personalizzare la paginazione di registrazioni, trascrizioni e voci di trascrizione:
pageSize
: il numero massimo di articoli da restituire. Il servizio potrebbe restituire meno di questo valore. Se non specificato, vengono restituiti al massimo 10 elementi. Il valore massimizzante è 100; i valori superiori a 100 vengono modificati automaticamente in 100.pageToken
: un token di pagina ricevuto da una precedente chiamata dell'elenco. Fornisci questo token per recuperare la pagina successiva.
Argomenti correlati
- Registrare una riunione video
- Utilizzare le trascrizioni con Google Meet
- Conservare i dati di Google Meet con Vault
- Personalizzare le funzionalità di Meet come amministratore