Un partecipante è una persona che ha partecipato a una chiamata o che utilizza la modalità Complementare, che guarda la chiamata come spettatore o un dispositivo della sala connesso a una chiamata. Esiste una
conferenceRecords.participants
risorsa per ogni persona.
Una sessione partecipante è un ID sessione univoco creato per ogni coppia di partecipante e dispositivo che partecipa a una chiamata.
Esiste una
conferenceRecords.participants.participantSessions
risorsa 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 sono in una conferenza oppure su un singolo partecipante, insieme alle informazioni sulla sessione.
Partecipanti
Le sezioni seguenti descrivono in 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
è: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.
Cercare tutti i partecipanti
Per ottenere i dettagli di tutti i partecipanti in un record della conferenza, utilizza il metodo
list()
nella risorsa
conferenceRecords.participants
con il parametro di percorso parent
.
Puoi utilizzare i campi earliestStartTime
o latestEndTime
per filtrare in base agli utenti che si sono uniti prima o che sono usciti dopo un determinato momento. Entrambi i campi utilizzano il formato
Timestamp
in RFC 3339
formato "Zulu" UTC, con risoluzione in nanosecondi e fino a nove cifre decimali:
{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 visualizzare i partecipanti attivi di una conferenza esistente, usa latestEndTime IS
NULL
.
Il metodo restituisce un elenco di partecipanti alla conferenza, ordinati in ordine decrescente in base all'ora di partecipazione, come istanza di una risorsa conferenceRecords.participants
.
Il seguente esempio di codice mostra come elencare tutti i partecipanti di una registrazione della conferenza:
Java
Node.js
Python
Sostituisci il valore principale con il nome del record della conferenza.
Cercare un partecipante specifico
Per cercare un partecipante specifico, utilizza il metodo
get()
nella risorsa
conferenceRecords.participants
con il parametro di 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 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 sezioni seguenti descrivono in dettaglio come ottenere informazioni sulle sessioni dei partecipanti.
Cercare tutte le sessioni dei partecipanti
Per ottenere i dettagli di tutte le sessioni di un partecipante in un record della conferenza, utilizza il metodo list()
nella risorsa conferenceRecords.participants.participantSessions
con il parametro di percorso parent
.
Puoi utilizzare i campi startTime
o endTime
per filtrare gli utenti che si sono uniti
prima o che sono usciti dopo un determinato periodo di tempo. Entrambi i campi utilizzano il formato
Timestamp
in formato RFC
3339 UTC
"Zulu", con risoluzione in nanosecondi e fino a nove cifre decimali:
{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 ordine decrescente in base all'ora di partecipazione, come istanza di una risorsa conferenceRecords.participants.participantSession
.
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 principale con il nome del record della conferenza e il nome del partecipante.
Cercare una sessione di un partecipante specifico
Per cercare una sessione del partecipante specifica, utilizza il metodo
get()
nella risorsa
conferenceRecords.participants.participantSessions
con il parametro di percorso name
. Per recuperare il nome del partecipante, utilizza 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 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 metodo
people.get
nell'API People.
- Estrai l'ID della persona dal nome della risorsa del partecipante utilizzando il componente finale del percorso. Ad esempio, se il nome della risorsa del 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, gli utenti interni di un'organizzazione Google Workspace e i contatti esterni sono inclusi nella risposta.
Nel seguente esempio viene eseguita una ricerca sia nei profili dell'organizzazione sia nei contatti per una 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