Un partecipante è una persona che partecipa a un
chiamata o che utilizza la modalità Complementare
, guardando come spettatore oppure
un dispositivo della stanza connesso a una chiamata. Ce n'è uno
conferenceRecords.participants
risorse per ogni persona.
Una sessione con partecipanti è una
ID sessione univoco creato per ogni coppia di dispositivo partecipante-dispositivo che partecipa a una chiamata.
Ce n'è uno
conferenceRecords.participants.participantSessions
risorse per ogni sessione. Se il partecipante partecipa alla stessa chiamata più volte
dalla stessa coppia partecipante-dispositivo, a ciascuno di essi vengono assegnati ID sessione univoci.
In questa pagina viene descritto come ottenere informazioni su tutti i partecipanti che hanno partecipato. o stai partecipando a una conferenza o semplicemente singolo partecipante, oltre alle informazioni sulla sessione.
Partecipanti
Le seguenti sezioni descrivono nel dettaglio come ottenere informazioni sui partecipanti.
La
conferenceRecords.participants
include il campo user
. Un user
può essere solo uno dei seguenti
oggetti:
Un
signedinUser
è:Una persona che partecipa da un PC, un dispositivo mobile o tramite la modalità Complementare.
Un account robot utilizzato dai dispositivi per sale conferenze.
Un
anonymousUser
è un utente non identificato che non ha eseguito l'accesso a un Account Google.Un
phoneUser
è un utente che si connette da un telefono la cui identità è sconosciuta perché non hanno effettuato l'accesso con un Account Google.
Cerca tutti i partecipanti
Per informazioni dettagliate su tutti i partecipanti a una conferenza, utilizza
list()
nella
conferenceRecords.participants
risorsa con il parametro del percorso parent
.
Puoi utilizzare i campi earliestStartTime
o latestEndTime
per filtrare in base a
utenti che si sono uniti prima o hanno abbandonato dopo un determinato periodo di tempo. Entrambi i campi utilizzano
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 ricevere partecipanti attivi a una conferenza esistente, utilizza latestEndTime IS
NULL
.
Il metodo restituisce un elenco dei partecipanti alla conferenza, ordinati in base all'ora di partecipazione nel
in ordine decrescente, come un'istanza di una risorsa conferenceRecords.participants
.
Il seguente esempio di codice mostra come elencare tutti i partecipanti a una conferenza record:
Java
Node.js
Python
Sostituisci il valore padre con il nome del record della conferenza.
Cercare un partecipante specifico
Per cercare un partecipante specifico, utilizza il
get()
nella
conferenceRecords.participants
risorsa con il parametro del percorso name
. Per recuperare il nome del
partecipante, utilizza il metodo conferenceRecords.participants.list
.
Il metodo restituisce il nome di un partecipante come istanza di un
conferenceRecords.participants
risorsa.
Il seguente esempio di codice mostra come recuperare uno specifico partecipante:
Java
Node.js
Python
Sostituisci il nome del partecipante con il nome di quello 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 visualizzare i dettagli sulle sessioni di tutti i partecipanti di un partecipante a una conferenza
utilizza il comando
list()
nella
conferenceRecords.participants.participantSessions
risorsa con il parametro del percorso parent
.
Puoi utilizzare i campi startTime
o endTime
per filtrare gli utenti che partecipano
prima o dopo un certo periodo di tempo. Entrambi i campi utilizzano
Timestamp
in 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 per ora di partecipazione in
in ordine decrescente, come un'istanza di un
conferenceRecords.participants.participantSession
risorsa.
Il seguente esempio di codice mostra come elencare tutte le sessioni dei partecipanti in un registrazione della conferenza:
Java
Node.js
Python
Sostituisci il valore padre con il nome del record della conferenza e nome del partecipante.
Cercare una sessione di partecipanti specifica
Per cercare una sessione di partecipanti specifica, utilizza il
get()
nella
conferenceRecords.participants.participantSessions
risorsa con il parametro del percorso name
. Per recuperare il nome del
partecipante, utilizza il metodo list()
.
Il metodo restituisce il nome di un partecipante come istanza di un
conferenceRecords.participants.participantSessions
risorsa.
Il seguente esempio di codice mostra come recuperare una sessione di partecipante specifica:
Java
Node.js
Python
Sostituisci il nome del partecipante con il nome di quello specifico da trovare.
Recuperare i dettagli dei partecipanti con l'API People
Per recuperare i dettagli di un partecipante, utilizza il
people.get
nel
API People:
- Estrai l'ID della persona dal nome della risorsa partecipante utilizzando
componente finale del percorso. Ad esempio, se il nome risorsa partecipante
è
conferenceRecords/abc-123/participants/12345
l'ID per L'API People è12345
. - Includi le fonti
READ_SOURCE_TYPE_PROFILE
,READ_SOURCE_TYPE_CONTACT
, eREAD_SOURCE_TYPE_OTHER_CONTACT
. In questo modo sia gli utenti interni un'organizzazione Google Workspace e i contatti esterni sono inclusi la risposta.
L'esempio seguente consente di cercare nei profili dell'organizzazione e nei contatti un persona:
cURL
curl \
'https://people.googleapis.com/v1/people/PERSON_ID?personFields=names%2CemailAddresses&sources=READ_SOURCE_TYPE_OTHER_CONTACT&sources=READ_SOURCE_TYPE_PROFILE&sources=READ_SOURCE_TYPE_CONTACT' \
--header 'Authorization: Bearer ACCESS_TOKEN' \
--header 'Accept: application/json' \
--compressed