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.
Questa pagina descrive come ottenere informazioni su tutti i partecipanti che hanno partecipato o sono in una conferenza oppure su un singolo partecipante, insieme 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
è:Un utente che partecipa da un computer personale, un dispositivo mobile o tramite la modalità Companion.
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 telefono e la cui identità è sconosciuta perché non ha eseguito l'accesso con un Account Google.
Cerca tutti i partecipanti
Per informazioni dettagliate su tutti i partecipanti a una conferenza, utilizza l'
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 sezioni seguenti descrivono in 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 in base all'ora di partecipazione nel
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 record 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 del partecipante specifica:
Java
Node.js
Python
Sostituisci il nome del partecipante con il nome del partecipante 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 origini
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