Un participant est une personne qui a rejoint un appel ou qui utilise le mode Compagnon, qui regarde en tant que spectateur ou un appareil de salle connecté à un appel. Il y en a un
conferenceRecords.participants
ressource pour chaque personne.
Une session de participant est un ID de session unique créé pour chaque paire participant-appareil qui rejoint un appel.
Il y en a un
conferenceRecords.participants.participantSessions
ressource pour chaque session. Si le participant rejoint plusieurs fois le même appel
de la même paire participant-appareil, ils se voient tous attribuer des ID de session uniques.
Cette page explique comment obtenir des informations sur tous les participants qui ont participé ou participez à une conférence, ou à propos participant unique, ainsi que les informations sur sa session.
Participants
Les sections suivantes expliquent en détail comment obtenir des informations sur les participants.
La
conferenceRecords.participants
la ressource inclut le champ user
. Un élément user
ne peut être que l'un des éléments suivants
Objets:
Un
signedinUser
est soit:une personne participant depuis un ordinateur personnel, un appareil mobile ou en mode Compagnon.
Compte robot utilisé par les appareils d'une salle de conférence.
Un
anonymousUser
est un utilisateur non identifié qui n'est pas connecté à un compte Google.Un
phoneUser
est un utilisateur participant par téléphone à partir d'un téléphone dont l'identité est inconnue. car elle ne s'est pas connectée avec un compte Google.
Rechercher tous les participants
Pour obtenir des informations sur tous les participants à un enregistrement de conférence, utilisez l'
list()
sur la
conferenceRecords.participants
avec le paramètre de chemin parent
.
Vous pouvez utiliser les champs earliestStartTime
ou latestEndTime
pour filtrer
les utilisateurs qui ont rejoint la réunion
avant ou l'ont quittée après un certain temps. Les deux champs utilisent le format Code temporel au format RFC 3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux : {year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z
. Exemple :
earliestStartTime < 2023-10-01T15:01:23Z
latestEndTime < 2023-10-01T15:01:23Z
Pour ajouter des participants actifs à une conférence existante, utilisez latestEndTime IS
NULL
.
Cette méthode renvoie la liste des participants à la conférence, classés par heure de connexion dans
dans l'ordre décroissant, en tant qu'instance d'une ressource conferenceRecords.participants
.
L'exemple de code suivant montre comment répertorier tous les participants à une conférence enregistrement:
Java
Node.js
Python
Remplacez la valeur parent par le nom de l'enregistrement de la conférence.
Rechercher un participant spécifique
Pour rechercher un participant spécifique, utilisez la
get()
sur la
conferenceRecords.participants
avec le paramètre de chemin name
. Pour récupérer le nom
utilisez la méthode conferenceRecords.participants.list
.
Cette méthode renvoie un nom de participant en tant qu'instance d'une
conferenceRecords.participants
.
L'exemple de code suivant montre comment récupérer un participant spécifique :
Java
Node.js
Python
Remplacez le nom du participant par celui du participant spécifique que vous recherchez.
Sessions des participants
Les sections suivantes expliquent en détail comment obtenir des informations sur les sessions des participants.
Rechercher toutes les sessions des participants
Pour obtenir des détails sur toutes les sessions d'un participant à une conférence
à l'aide de la méthode
list()
sur la
conferenceRecords.participants.participantSessions
avec le paramètre de chemin parent
.
Vous pouvez utiliser les champs startTime
ou endTime
pour filtrer les utilisateurs qui ont rejoint ou quitté un groupe avant ou après une certaine date. Les deux champs utilisent
Code temporel
format en RFC
3339 UTC
"Zoulou" avec une résolution à la nanoseconde et jusqu'à neuf chiffres fractionnaires:
{year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z
Exemple :
startTime < 2023-10-01T15:01:23Z
endTime < 2023-10-01T15:01:23Z
Cette méthode renvoie la liste des sessions des participants, triées par heure de connexion dans
par ordre décroissant, comme une instance
conferenceRecords.participants.participantSession
.
L'exemple de code suivant montre comment répertorier toutes les sessions des participants dans un enregistrement de la conférence:
Java
Node.js
Python
Remplacez la valeur parent par le nom de l'enregistrement de la conférence et le nom du participant.
Rechercher une session spécifique pour les participants
Pour rechercher une session de participants spécifique, utilisez la
get()
sur la
conferenceRecords.participants.participantSessions
avec le paramètre de chemin name
. Pour récupérer le nom
utilisez la méthode list()
.
Cette méthode renvoie un nom de participant en tant qu'instance d'une
conferenceRecords.participants.participantSessions
.
L'exemple de code suivant montre comment récupérer une session de participant spécifique:
Java
Node.js
Python
Remplacez le nom du participant par celui du participant spécifique que vous recherchez.
Récupérer les informations sur les participants avec l'API People
Pour obtenir des informations sur un participant, utilisez l'
people.get
dans
API People :
- Extrayez l'identifiant de la personne à partir du nom de ressource du participant à l'aide de la méthode
composant final du chemin. Par exemple, si le nom de ressource du participant
est
conferenceRecords/abc-123/participants/12345
l'ID de L'API People est12345
. - Incluez les sources
READ_SOURCE_TYPE_PROFILE
,READ_SOURCE_TYPE_CONTACT
, etREAD_SOURCE_TYPE_OTHER_CONTACT
. Ainsi, les utilisateurs internes dans une organisation Google Workspace et des contacts externes la réponse.
L'exemple suivant recherche à la fois les profils d'organisation et les contacts pour un personne:
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