Un participante es una persona que se unió a una llamada o que usa el Modo complementario, mira como un usuario o usa un dispositivo de sala conectado a una llamada. Hay un recurso conferenceRecords.participants
para cada persona.
Una sesión de participante es un ID de sesión único que se crea para cada par de participante y dispositivo que se une a una llamada.
Hay un recurso conferenceRecords.participants.participantSessions
para cada sesión. Si el participante se une a la misma llamada varias veces desde el mismo par participante-dispositivo, se le asignan IDs de sesión únicos.
En esta página, se describe cómo obtener información sobre todos los participantes que asistieron a una conferencia o que se encuentran en una, o sobre un solo participante, junto con la información de su sesión.
Participantes
En las siguientes secciones, se detalla cómo obtener información sobre los participantes.
El recurso conferenceRecords.participants
incluye el campo user
. Un user
solo puede ser uno de los siguientes objetos:
Un
signedinUser
puede ser una de las siguientes opciones:Una persona que se une desde una computadora personal, un dispositivo móvil o el modo complementario.
Es una cuenta de robot que usan los dispositivos de sala de conferencias.
Un
anonymousUser
es un usuario no identificado que no accedió a una Cuenta de Google.Un
phoneUser
es un usuario que llama desde un teléfono en el que se desconoce su identidad porque no accedió con una Cuenta de Google.
Buscar a todos los participantes
Para obtener detalles sobre todos los participantes de un registro de conferencia, usa el método list()
en el recurso conferenceRecords.participants
con el parámetro de ruta parent
.
Puedes usar los campos earliestStartTime
o latestEndTime
para filtrar usuarios que se unieron antes o salieron después de un período determinado. Ambos campos usan el formato Timestamp en formato RFC 3339 UTC “Zulu”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios: {year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z
. Por ejemplo:
earliestStartTime < 2023-10-01T15:01:23Z
latestEndTime < 2023-10-01T15:01:23Z
Para obtener participantes activos en una conferencia existente, usa latestEndTime IS
NULL
.
El método muestra una lista de participantes de la conferencia, ordenados por hora de conexión en orden descendente, como una instancia de un recurso conferenceRecords.participants
.
En la siguiente muestra de código, se muestra cómo enumerar a todos los participantes de un registro de conferencia:
Java
Node.js
Python
Reemplaza el valor superior por el nombre del registro de la conferencia.
Cómo buscar un participante específico
Para buscar un participante específico, usa el método get()
en el recurso conferenceRecords.participants
con el parámetro de ruta name
. Para recuperar el nombre del participante, usa el método conferenceRecords.participants.list
.
El método muestra un nombre de participante como una instancia de un recurso conferenceRecords.participants
.
En la siguiente muestra de código, se muestra cómo recuperar un participante específico:
Java
Node.js
Python
Reemplaza el nombre del participante por el nombre del participante específico que deseas encontrar.
Sesiones de los participantes
En las siguientes secciones, se detalla cómo obtener información sobre las sesiones de los participantes.
Busca todas las sesiones de los participantes
Para obtener detalles sobre todas las sesiones de un participante en un registro de conferencia, usa el método list()
en el recurso conferenceRecords.participants.participantSessions
con el parámetro de ruta parent
.
Puedes usar los campos startTime
o endTime
para filtrar los usuarios que se unieron antes o salieron después de un período determinado. Ambos campos usan el formato Timestamp en formato RFC 3339 UTC “Zulu”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios: {year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z
. Por ejemplo:
startTime < 2023-10-01T15:01:23Z
endTime < 2023-10-01T15:01:23Z
El método muestra una lista de sesiones de participantes, ordenadas por hora de unión en orden descendente, como una instancia de un recurso conferenceRecords.participants.participantSession
.
En la siguiente muestra de código, se muestra cómo enumerar todas las sesiones de los participantes en un registro de conferencia:
Java
Node.js
Python
Reemplaza el valor superior por el nombre del registro de la conferencia y el nombre del participante.
Cómo buscar una sesión de participante específica
Para buscar una sesión de participante específica, usa el método get()
en el recurso conferenceRecords.participants.participantSessions
con el parámetro de ruta name
. Para recuperar el nombre del participante, usa el método list()
.
El método muestra un nombre de participante como una instancia de un recurso conferenceRecords.participants.participantSessions
.
En la siguiente muestra de código, se muestra cómo recuperar una sesión de participante específica:
Java
Node.js
Python
Reemplaza el nombre del participante por el nombre del participante específico que deseas encontrar.
Cómo recuperar detalles de los participantes con la API de People
Para recuperar detalles sobre un participante, usa el método people.get
en la API de People.
- Extrae el ID de la persona del nombre del recurso del participante con el componente final de la ruta. Por ejemplo, si el nombre del recurso del participante es
conferenceRecords/abc-123/participants/12345
, el ID de la API de People es12345
. - Incluye las fuentes
READ_SOURCE_TYPE_PROFILE
,READ_SOURCE_TYPE_CONTACT
yREAD_SOURCE_TYPE_OTHER_CONTACT
. Esto garantiza que se incluyan en la respuesta los usuarios internos de una organización de Google Workspace y los contactos externos.
En el siguiente ejemplo, se busca una persona en los perfiles de la organización y en los contactos:
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