Questa guida 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 video e altri artefatti, come le trascrizioni.
Per produrre artefatti, 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()
nelle risorse recordings
, transcripts
e
transcripts.entries
per recuperare gli artefatti.
L'autenticazione e l'autorizzazione con le credenziali utente consentono alle app Google 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 saperne di più, 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 a id
nella risorsa files
. Per
maggiori informazioni, consulta
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 dettagli su 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()
sulla risorsa recordings
con il parametro di percorso parent
. 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 delle conferenze in un record di 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 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 di conferenza, utilizza il metodo
list()
nella risorsa
transcripts
con il parametro di percorso parent
. 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 dettagli su 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 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 di trascrizione specifica:
Java
Node.js
Python
Sostituisci il nome della voce della trascrizione con l'ID della voce specifica della 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
. Formato:
conferenceRecords/{conferenceRecord}/transcripts/{transcript}
.
Il metodo restituisce un elenco di voci di trascrizione strutturate per ogni 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 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.
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