Un partecipante è una persona che si è unita a una chiamata o che utilizza la modalità Complementare, che guarda i video come spettatore, o un dispositivo della stanza connesso a una chiamata. C'è una risorsa conferenceRecords.participants
per ogni persona.
Una sessione partecipante è 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.
Questa pagina descrive come ottenere informazioni su tutti i partecipanti che hanno partecipato o stanno partecipando a una conferenza oppure su un solo partecipante, insieme alle relative informazioni sulla sessione.
Partecipanti
Le seguenti sezioni descrivono nel dettaglio come ottenere informazioni sui partecipanti.
La risorsa conferenceRecords.participants
include il campo user
. Un user
può essere solo uno dei seguenti oggetti:
Un
signedinUser
può essere:Una singola persona che partecipa da un personal computer, un dispositivo mobile o tramite la modalità Complementare.
Un account robot utilizzato dai dispositivi per sale conferenze.
Un utente
anonymousUser
è un utente non identificato che non ha eseguito l'accesso a un Account Google.Un
phoneUser
è una persona che si connette via telefono da un telefono il cui identità è sconosciuta perché non ha eseguito l'accesso con un Account Google.
Cerca tutti i partecipanti
Per ottenere dettagli su tutti i partecipanti in un record di conferenza, utilizza il metodo list()
nella risorsa conferenceRecords.participants
con il parametro del percorso parent
.
Puoi utilizzare i campi earliestStartTime
o latestEndTime
per filtrare in base agli utenti che si sono uniti prima o hanno abbandonato dopo un determinato periodo di tempo. Entrambi i campi utilizzano il formato
Timestamp
nel formato RFC 3339
UTC "Zulu", con risoluzione in nanosecondi e fino a nove cifre frazionarie:
{year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z
. Ad esempio:
earliestStartTime < 2023-10-01T15:01:23Z
latestEndTime < 2023-10-01T15:01:23Z
Per partecipare attivamente a una conferenza esistente, utilizza latestEndTime IS
NULL
.
Il metodo restituisce un elenco di partecipanti alla conferenza, ordinati in base all'ora di join in ordine decrescente, come un'istanza di una risorsa conferenceRecords.participants
.
Il seguente esempio di codice mostra come elencare tutti i partecipanti in un record della conferenza:
Java
Node.js
Python
Sostituisci il valore principale con il nome del record della conferenza.
Cerca un partecipante specifico
Per cercare un partecipante specifico, utilizza il metodo get()
nella risorsa conferenceRecords.participants
con il parametro del percorso name
. Per recuperare il nome del partecipante, usa il metodo conferenceRecords.participants.list
.
Il metodo restituisce il nome di un partecipante come istanza di una risorsa conferenceRecords.participants
.
Il seguente esempio di codice mostra come recuperare un partecipante specifico:
Java
Node.js
Python
Sostituisci il nome del partecipante con il nome del partecipante specifico da trovare.
Sessioni dei partecipanti
Le seguenti sezioni descrivono nel dettaglio come ottenere informazioni sulle sessioni dei partecipanti.
Cerca tutte le sessioni dei partecipanti
Per ottenere dettagli su tutte le sessioni dei partecipanti di un partecipante in un record della conferenza, utilizza il metodo list()
nella risorsa conferenceRecords.participants.participantSessions
con il parametro del percorso parent
.
Puoi utilizzare i campi startTime
o endTime
per filtrare in base agli utenti che si sono uniti prima o hanno abbandonato dopo un determinato periodo di tempo. Entrambi i campi utilizzano il formato Timestamp nel formato RFC 3339 UTC "Zulu", con risoluzione in nanosecondi e fino a nove cifre frazionarie: {year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z
. Ad esempio:
startTime < 2023-10-01T15:01:23Z
endTime < 2023-10-01T15:01:23Z
Il metodo restituisce un elenco di sessioni dei partecipanti, ordinate in base all'ora di join in ordine decrescente, come un'istanza di una risorsa conferenceRecords.participants.participantSession
.
Il seguente esempio di codice mostra come elencare tutte le sessioni dei partecipanti in un record di conferenza:
Java
Node.js
Python
Sostituisci il valore padre con il nome del record della conferenza e il nome del partecipante.
Cercare una sessione di partecipanti specifica
Per cercare una sessione del partecipante specifica, utilizza il metodo get()
nella risorsa conferenceRecords.participants.participantSessions
con il parametro del percorso name
. Per recuperare il nome del partecipante, usa il metodo list()
.
Il metodo restituisce il nome di un partecipante come istanza di una risorsa conferenceRecords.participants.participantSessions
.
Il seguente esempio di codice mostra come recuperare una sessione partecipante specifica:
Java
Node.js
Python
Sostituisci il nome del partecipante con il nome del partecipante specifico da trovare.