Questa guida spiega come ottenere i dettagli dei partecipanti che hanno partecipato a una conferenza passata o che sono in una conferenza attiva, insieme alle informazioni sulla sessione, utilizzando l'API REST di Google Meet.
Un partecipante è una persona
che ha partecipato a una chiamata o che utilizza la modalità Complementare, che guarda come spettatore o
un dispositivo della sala connesso a una chiamata. Esiste una
participants
risorsa per ogni persona.
Una sessione partecipante
è un ID sessione univoco creato per ogni coppia partecipante-dispositivo che partecipa a una
chiamata. Esiste una
participantSessions
risorsa per ogni sessione. Se il partecipante partecipa alla stessa chiamata più volte dalla stessa coppia partecipante-dispositivo, a ciascuna viene assegnato un ID sessione univoco.
Se sei il proprietario o il partecipante di uno spazio riunioni, puoi chiamare i metodi get e list sulle risorse participants e participantSessions per recuperare i record dei partecipanti.
L'autenticazione e l'autorizzazione con le credenziali utente consentono alle app di Google Meet di accedere ai dati utente ed eseguire operazioni per conto dell'utente autenticato. L'autenticazione con la delega a livello di dominio consente di autorizzare l'account di servizio di un'applicazione ad accedere ai dati degli utenti senza che sia necessario il loro consenso.
Partecipanti
Le sezioni seguenti descrivono in dettaglio come ottenere informazioni sui partecipanti in un record di conferenza.
La
participants
risorsa si unisce al campo user. Un user può essere solo uno dei seguenti oggetti:
Un
signedinUserè:Un singolo utente che partecipa da un computer, 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.A
phoneUserè un utente che chiama da un telefono in cui l'identità dell'utente è sconosciuta perché non ha eseguito l'accesso con un Account Google.
Tieni presente che, sebbene tutti e tre gli oggetti restituiscano un displayName, signedinUser restituisce anche un user ID univoco interoperabile con l'API SDK Admin e l'API People. Formato: users/{user}. Per ulteriori informazioni sull'utilizzo dell'user
ID con l'API People, consulta Recuperare i dettagli dei partecipanti con l'
API People.
Ottenere i dettagli di un partecipante
Per ottenere i dettagli di un partecipante specifico, utilizza il
get
metodo sulla
participants
risorsa. Imposta il parametro del percorso name utilizzando il formato conferenceRecords/{conferenceRecord}/participants/{participantRecord}.
Se non conosci il nome del partecipante, puoi elencare tutti i nomi dei partecipanti
utilizzando il metodo list.
Il metodo restituisce i dati del partecipante come istanza di una risorsa participants.
Il seguente esempio di codice mostra come recuperare un partecipante specifico:
Java
Node.js
Python
cURL
curl -X GET "https://meet.googleapis.com/v2/conferenceRecords/CONFERENCE_RECORD_NAME/participants/PARTICIPANT_NAME" \
-H "Authorization: Bearer ACCESS_TOKEN"
Sostituisci ACCESS_TOKEN con il token di accesso che concede l'accesso all'API.
Sostituisci quanto segue:
- Il nome del record della conferenza con il nome dell'ID conferenza specifico in un record della conferenza.
- Il nome del partecipante con il nome dell'ID partecipante specifico in un record della conferenza.
Elencare tutti i partecipanti
Per elencare i dettagli di tutti i partecipanti in un record della conferenza, utilizza il
list
metodo sulla
participants
risorsa. Imposta il parametro del percorso parent utilizzando il formato conferenceRecords/{conferenceRecord}.
Il metodo restituisce un elenco dei partecipanti alla conferenza, ordinati per earliestStartTime in ordine decrescente, come istanza di una risorsa participants. Per regolare le dimensioni della pagina e filtrare i risultati della query, consulta Personalizzare
la paginazione o filtrare l'elenco dei partecipanti.
Il seguente esempio di codice mostra come elencare tutti i partecipanti in un record della conferenza:
Java
Node.js
Python
cURL
curl -X GET "https://meet.googleapis.com/v2/conferenceRecords/PARENT_NAME/participants" \
-H "Authorization: Bearer ACCESS_TOKEN"
Sostituisci ACCESS_TOKEN con il token di accesso che concede l'accesso all'API.
Sostituisci il nome del parent con il nome dell'ID conferenza specifico in un record della conferenza.
Personalizzare la paginazione o filtrare l'elenco dei partecipanti
Trasmetti i seguenti parametri di query per personalizzare la paginazione o filtrare i partecipanti:
pageSize: il numero massimo di partecipanti da restituire. Il servizio potrebbe restituire un valore inferiore. Se non è specificato, vengono restituiti al massimo 100 partecipanti. Il valore massimo è 250; i valori superiori a 250 vengono modificati automaticamente in 250.pageToken: un token di pagina ricevuto da una chiamata di elenco precedente. Fornisci questo token per recuperare la pagina successiva.filter: (facoltativo) Un filtro di query per recuperare elementi specifici nei risultati della risorsaparticipants.Puoi utilizzare i campi
earliestStartTimeolatestEndTimeper filtrare gli utenti che hanno partecipato prima o sono usciti dopo un determinato orario. Entrambi i campi utilizzano il Timestamp formato in RFC 3339 UTC "Zulu" formato, con risoluzione al nanosecondo e fino a nove cifre frazionarie:{year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z. Ad esempio:earliestStartTime < 2023-10-01T15:01:23ZlatestEndTime < 2023-10-01T15:01:23Z
Per elencare tutti i partecipanti attivi in una conferenza esistente, utilizza
latestEndTime IS NULL.
Recuperare i dettagli dei partecipanti con l'API People
Per recuperare i dettagli di un partecipante, utilizza il
get metodo sulla
people risorsa nell'API People.
Estrai l'ID della persona dalla risorsa
participantutilizzando il componente finale del percorso. Ad esempio, se il valore della risorsaparticipantèconferenceRecords/abc-123/participants/12345, l'ID per l'API People è12345.Includi
READ_SOURCE_TYPE_PROFILE,READ_SOURCE_TYPE_CONTACTeREAD_SOURCE_TYPE_OTHER_CONTACTReadSourceType. In questo modo, nella risposta vengono inclusi sia gli utenti interni di un'organizzazione Google Workspace sia i contatti esterni.
Il seguente esempio di codice mostra come cercare una persona nei profili e nei contatti dell'organizzazione:
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
Sostituisci quanto segue:
- PERSON_ID: l'ID della persona da trovare.
- ACCESS_TOKEN: il token di accesso che concede l'accesso a più API.
Sessioni dei partecipanti
Le sezioni seguenti descrivono in dettaglio come ottenere informazioni sulle sessioni dei partecipanti di un partecipante in un record della conferenza.
Ottenere i dettagli di una sessione partecipante
Per ottenere i dettagli di una sessione partecipante specifica, utilizza il
get
metodo sulla
participantSessions
risorsa. Imposta il parametro del percorso name utilizzando il formato conferenceRecords/{conferenceRecord}/participants/{participantRecord}/participantSessions/{participantSessionRecord}.
Se non conosci il nome della sessione partecipante, puoi elencare tutte le sessioni partecipanti di un partecipante utilizzando il metodo list.
Il metodo restituisce il nome del partecipante come istanza di una risorsa participantSessions.
Il seguente esempio di codice mostra come recuperare una sessione partecipante specifica:
Java
Node.js
Python
cURL
curl -X GET "https://meet.googleapis.com/v2/conferenceRecords/CONFERENCE_RECORD_NAME/participants/PARTICIPANT_NAME/participantSessions/PARTICIPANT_SESSION_ID" \
-H "Authorization: Bearer ACCESS_TOKEN"
Sostituisci ACCESS_TOKEN con il token di accesso che concede l'accesso all'API.
Sostituisci quanto segue:
- Il nome del record della conferenza con il nome dell'ID conferenza specifico in un record della conferenza.
- Il nome del partecipante con il nome dell'ID partecipante specifico in un record della conferenza.
- L'ID sessione partecipante con l'ID della sessione partecipante specifica.
Elencare tutte le sessioni partecipanti
Per elencare i dettagli di tutte le sessioni partecipanti di un partecipante in un record della conferenza, utilizza il
list()
metodo sulla
participantSessions
risorsa. Imposta il parametro del percorso parent utilizzando il formato conferenceRecords/{conferenceRecord}/participants/{participantRecord}.
Il metodo restituisce un elenco di sessioni partecipanti, ordinate per startTime in ordine decrescente, come istanza di una risorsa participantSession. Per regolare
le dimensioni della pagina e filtrare i risultati della query, consulta Personalizzare la paginazione o filtrare
l'elenco delle sessioni partecipanti.
Il seguente esempio di codice mostra come elencare tutte le sessioni partecipanti in un record della conferenza:
Java
Node.js
Python
cURL
curl -X GET "https://meet.googleapis.com/v2/conferenceRecords/CONFERENCE_RECORD_NAME/participants/PARENT_NAME/participantSessions" \
-H "Authorization: Bearer ACCESS_TOKEN"
Sostituisci ACCESS_TOKEN con il token di accesso che concede l'accesso all'API.
Sostituisci quanto segue:
- Il nome del record della conferenza con il nome dell'ID conferenza specifico in un record della conferenza.
- Il nome del parent con il nome delle sessioni partecipanti di un partecipante in un record della conferenza.
Personalizzare la paginazione o filtrare l'elenco delle sessioni partecipanti
Trasmetti i seguenti parametri di query facoltativi per personalizzare la paginazione o filtrare le sessioni partecipanti:
pageSize: il numero massimo di sessioni partecipanti da restituire. Il servizio potrebbe restituire un valore inferiore. Se non è specificato, vengono restituite al massimo 100 sessioni partecipanti. Il valore massimo è 250; i valori superiori a 250 vengono modificati automaticamente in 250.pageToken: un token di pagina ricevuto da una chiamata di elenco precedente. Fornisci questo token per recuperare la pagina successiva.filter: (facoltativo) Un filtro di query per recuperare elementi specifici nei risultati della risorsaparticipants.Puoi utilizzare i campi
startTimeoendTimeper filtrare gli utenti che hanno partecipato prima o sono usciti dopo un determinato orario. Entrambi i campi utilizzano il Timestamp formato in RFC 3339 UTC "Zulu" formato, con risoluzione al nanosecondo e fino a nove cifre frazionarie:{year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z. Ad esempio:startTime < 2023-10-01T15:01:23ZendTime < 2023-10-01T15:01:23Z
Per elencare tutte le sessioni partecipanti attive nel record della conferenza, utilizza
endTime IS NULL.