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. Une ressource conferenceRecords.participants
est attribuée à chaque personne.
Une session de participant est un ID de session unique créé pour chaque paire participant-appareil qui rejoint un appel.
Il existe une ressource conferenceRecords.participants.participantSessions
pour chaque session. Si le participant rejoint le même appel plusieurs fois à partir de la même paire participant-appareil, des ID de session uniques lui sont attribués.
Cette page explique comment obtenir des informations sur tous les participants à une conférence ou sur un seul participant, ainsi que sur leur session.
Participants
Les sections suivantes expliquent comment obtenir des informations sur les participants.
La ressource conferenceRecords.participants
inclut le champ user
. Un user
ne peut être qu'un des objets suivants:
Un
signedinUser
est soit:Personne participant depuis un ordinateur personnel, un appareil mobile ou le mode Compagnon
Compte robot utilisé par les appareils de salle de conférence.
Un
anonymousUser
est un utilisateur non identifié qui n'est pas connecté à un compte Google.Un
phoneUser
est un utilisateur qui participe à une réunion par téléphone, mais dont l'identité est inconnue, car il ne s'est pas connecté avec un compte Google.
Rechercher tous les participants
Pour obtenir des informations sur tous les participants à un enregistrement de conférence, utilisez la méthode list()
sur la ressource conferenceRecords.participants
avec le paramètre de chemin parent
.
Vous pouvez utiliser les champs earliestStartTime
ou latestEndTime
pour filtrer les utilisateurs qui ont rejoint ou quitté un groupe avant ou après une certaine date. 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 obtenir les participants actifs d'une conférence existante, utilisez latestEndTime IS
NULL
.
La méthode renvoie une liste des participants à la conférence, classés par ordre décroissant de l'heure de connexion, en tant qu'instance d'une ressource conferenceRecords.participants
.
L'exemple de code suivant montre comment lister tous les participants à un enregistrement de conférence:
Java
Node.js
Python
Remplacez la valeur parente par le nom de l'enregistrement de la conférence.
Rechercher un participant spécifique
Pour rechercher un participant spécifique, utilisez la méthode get()
sur la ressource conferenceRecords.participants
avec le paramètre de chemin name
. Pour récupérer le nom du participant, utilisez la méthode conferenceRecords.participants.list
.
La méthode renvoie un nom de participant en tant qu'instance d'une ressource 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 à rechercher.
Sessions des participants
Les sections suivantes expliquent comment obtenir des informations sur les sessions des participants.
Rechercher toutes les sessions des participants
Pour obtenir des informations sur toutes les sessions d'un participant dans un enregistrement de conférence, utilisez la méthode list()
sur la ressource 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é la communauté avant ou après une certaine date. 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 :
startTime < 2023-10-01T15:01:23Z
endTime < 2023-10-01T15:01:23Z
La méthode renvoie une liste de sessions de participants, triées par heure d'adhésion par ordre décroissant, en tant qu'instance d'une ressource conferenceRecords.participants.participantSession
.
L'exemple de code suivant montre comment lister toutes les sessions des participants dans un enregistrement de conférence:
Java
Node.js
Python
Remplacez la valeur parente par le nom de l'enregistrement de la conférence et le nom du participant.
Rechercher une session de participant spécifique
Pour rechercher une session de participant spécifique, utilisez la méthode get()
sur la ressource conferenceRecords.participants.participantSessions
avec le paramètre de chemin name
. Pour récupérer le nom du participant, utilisez la méthode list()
.
La méthode renvoie un nom de participant en tant qu'instance d'une ressource 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 à rechercher.
Récupérez les informations sur les participants avec l'API People
Pour récupérer des informations sur un participant, utilisez la méthode people.get
dans l'API People.
- Extrayez l'ID de la personne à partir du nom de la ressource participant à l'aide du composant de fin du chemin d'accès. Par exemple, si le nom de la ressource 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
. Cela garantit que les utilisateurs internes d'une organisation Google Workspace et les contacts externes sont inclus dans la réponse.
L'exemple suivant recherche à la fois les profils d'organisation et les contacts d'une 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