Questo documento spiega come ottenere dettagli sui diversi artefatti della riunione generati da una conferenza utilizzando l'API REST di Google Meet.
Un artefatto è un file o un dato generato da Google Meet in risposta a una conferenza. Sono inclusi registrazioni video e altri artefatti, come le trascrizioni.
Per produrre artefatti, i partecipanti devono configurarli in Meet prima della fine della conferenza. Per saperne di più, consulta Gestire gli artefatti automatici.
Le trascrizioni funzionano indipendentemente dalle registrazioni e non è necessario registrare la riunione per generare una trascrizione. Quando tutti i partecipanti lasciano la riunione, la trascrizione si interrompe automaticamente. Per ulteriori informazioni, vedi Registrare una riunione video e Utilizzare le trascrizioni con Google Meet.
Recuperare gli artefatti
Se sei il proprietario o un partecipante di uno spazio riunioni, puoi chiamare i metodi get e
list nelle risorse recordings, transcripts, transcripts.entries e
smart notes per recuperare gli artefatti. Per saperne di più, consulta le
sezioni seguenti.
L'autenticazione e l'autorizzazione con le credenziali utente consentono alle app Meet di accedere ai dati 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 loro consenso.
Conservazione degli artefatti
Al termine di una conferenza, Meet salva le registrazioni e le trascrizioni sul Google Drive dell'organizzatore della riunione. Per impostazione predefinita, gli artefatti 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 artefatti di Meet separatamente utilizzando regole di conservazione specifiche per Meet in Google Vault. Per ulteriori informazioni, vedi Conservare i dati di Google Meet con Vault.
Registrazioni
Le sezioni seguenti descrivono in dettaglio come ottenere informazioni sulle registrazioni in un record di conferenza.
Meet ha accesso all'ID registrazione dopo la generazione del file di registrazione. È possibile che un utente elimini il file di registrazione da Google Drive, ma il nome univoco viene comunque restituito in Meet.
La risorsa
recordings
include gli oggetti
DriveDestination
e
State.
L'oggetto DriveDestination contiene la posizione di esportazione in Drive
in cui 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 al campo
id nella risorsa
files. Per maggiori
informazioni, vedi Scaricare ed esportare
file.
L'oggetto State contiene lo stato della sessione di registrazione. In questo modo puoi
chiedere se la registrazione è iniziata, se è terminata ma il file
non è pronto o se è stato generato ed è pronto per il download.
Visualizzare i dettagli di una registrazione
Per ottenere 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.
Elenco di tutte le registrazioni
Per elencare i dettagli di tutte le registrazioni in un record di conferenza, utilizza il metodo
list
nella risorsa
recordings
con il parametro di percorso parent. Il formato è
conferenceRecords/{conferenceRecord}.
Il metodo restituisce un elenco di registrazioni di 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 di 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 di una conferenza in un record della conferenza.
Meet ha accesso all'ID della trascrizione una volta generati i dati della trascrizione. È possibile che un utente elimini il file della trascrizione da Drive, ma il nome univoco viene comunque restituito in Meet.
La risorsa
transcripts
include gli oggetti
DocsDestination
e
State.
L'oggetto DocsDestination contiene la posizione di esportazione in Drive
in cui viene salvato il file di trascrizione di Documenti Google. Per recuperare i contenuti o
sfogliare 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
chiedere se la sessione di trascrizione è iniziata, se è terminata
ma il file di trascrizione non è pronto o se il file di trascrizione è stato generato e
pronto per il download.
Visualizzare i dettagli di una trascrizione
Per ottenere 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 di conferenza, utilizza il metodo list sulla risorsa transcripts con il parametro di percorso parent. Il formato è
conferenceRecords/{conferenceRecord}.
Il metodo restituisce un elenco di trascrizioni della conferenza, 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 in un record di conferenza:
Java
Node.js
Python
Sostituisci il valore principale con il nome del record della conferenza.
Voci della trascrizione
Le sezioni seguenti descrivono in dettaglio come ottenere il discorso di ogni 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 esempio, en-US)
è incluso anche come sintassi IETF BCP 47.
Ogni voce della trascrizione è collegata a un nome participant nella conferenza. Per
recuperare i dettagli di un partecipante, vedi Visualizzare 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 di trascrizione di Documenti. Questo si verifica quando il file di trascrizione viene modificato dopo la generazione.
Visualizzare i dettagli di una voce della trascrizione
Per ottenere i dettagli di una voce di 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 voci della trascrizione utilizzando il metodo list.
Il metodo restituisce un'istanza di una risorsa transcripts.entries.
Il seguente esempio di codice mostra come recuperare una voce di 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 di trascrizione in una trascrizione, utilizza il metodo list sulla risorsa transcripts.entries con il parametro di percorso parent. Il formato è
conferenceRecords/{conferenceRecord}/transcripts/{transcript}.
Il metodo restituisce un elenco di voci di trascrizione strutturate per ogni trascrizione della conferenza, ordinate in base a 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.
Appunti intelligenti
Le sezioni seguenti descrivono in dettaglio come ottenere informazioni sugli appunti intelligenti in un record della conferenza.
Meet ha accesso all'ID della nota intelligente una volta generati i dati della nota intelligente. È possibile che un utente elimini il file delle note intelligenti da Drive, ma il nome univoco viene comunque restituito in Meet.
La risorsa smartNotes include l'oggetto State.
Questo oggetto contiene lo stato della sessione degli appunti intelligenti. In questo modo puoi verificare se
la sessione di appunti intelligenti è iniziata, se è terminata ma
il file di appunti intelligenti non è pronto o se è stato generato ed è
pronto per il download.
La risorsa smartNotes include anche il tipo di oggetto DocsDestination. Questo oggetto contiene la posizione di esportazione in Drive in cui viene salvato il file di note intelligenti di Documenti Google. Per recuperare i contenuti o sfogliare le note intelligenti 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.
Puoi gestire le note intelligenti utilizzando i metodi get e
list.
Visualizzare i dettagli sugli appunti intelligenti
Per ottenere i dettagli di un file di note intelligenti specifico, utilizza il metodo
get sulla risorsa
smartNotes con
il parametro di percorso name. Se non conosci il nome delle note intelligenti, puoi elencare
tutti i file di note intelligenti utilizzando il metodo list.
Il metodo restituisce un'istanza di una risorsa smartNotes.
Elenco di tutti gli appunti intelligenti
Per elencare i dettagli di tutti i file di note intelligenti in un record della conferenza, utilizza il metodo list sulla risorsa smartNotes con il parametro di percorso parent. Il formato è
conferenceRecords/{conferenceRecord}.
Il metodo restituisce un elenco di file di note intelligenti della conferenza, ordinati per
startTime in ordine crescente, come istanza di una risorsa smartNotes. Per
regolare le dimensioni della pagina, consulta Personalizzare la paginazione .
Personalizzare la paginazione
Trasmetti i seguenti parametri di query per personalizzare la paginazione di registrazioni, trascrizioni e voci di trascrizione:
pageSize: il numero massimo di elementi da restituire. Il servizio potrebbe restituire un numero inferiore a questo valore. Se non specificato, vengono restituiti al massimo 10 elementi. Il valore massimo è 100; i valori superiori a 100 vengono automaticamente modificati in 100.pageToken: un token di pagina ricevuto da una precedente chiamata dell'elenco. Fornisci questo token per recuperare la pagina successiva.