Un participante es una persona unida a un
llamada o que use Companion
mirando como oyente
un dispositivo de la sala conectado a una llamada. Hay uno
conferenceRecords.participants
recurso para cada persona.
Una sesión de participante es una
Es un ID de sesión único que se crea para cada par participante y dispositivo que se une a una llamada.
Hay uno
conferenceRecords.participants.participantSessions
recurso para cada sesión. Si el participante se une a la misma llamada varias veces
del mismo par participante y dispositivo, a cada uno se les asigna IDs de sesión únicos.
En esta página, se describe cómo obtener información sobre todos los participantes que asistieron o que están en una conferencia, o son sobre una de 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
conferenceRecords.participants
incluye el campo user
. Un user
puede ser solo una de las siguientes opciones:
objetos:
Un objeto
signedinUser
es una de las siguientes:Una persona que se une desde una computadora personal, un dispositivo móvil o mediante el Modo complementario.
Una cuenta robot usada por los dispositivos de la sala de conferencias.
Un objeto
anonymousUser
es un usuario no identificado que no accedió a una Cuenta de Google.Un objeto
phoneUser
es un usuario que llama para entrar a la reunión desde un teléfono y se desconoce su identidad porque no accedieron con una Cuenta de Google.
Buscar a todos los participantes
Para obtener detalles sobre todos los participantes del registro de una conferencia, usa el
list()
en la
conferenceRecords.participants
recurso con el parámetro de ruta de acceso parent
.
Puedes usar los campos earliestStartTime
o latestEndTime
para filtrar
usuarios que se unieron antes o después de cierto tiempo. Ambos campos usan el
Marca de tiempo
en RFC 3339
UTC "Zulú" 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 devuelve una lista de participantes de la conferencia, ordenados por hora de unión en
en orden descendente, como instancia de un recurso conferenceRecords.participants
.
En la siguiente muestra de código, se indica cómo obtener una lista de todos los participantes de una conferencia. registro:
Java
Node.js
Python
Reemplaza el valor superior por el nombre del registro de la conferencia.
Buscar a un participante específico
Para buscar a un participante específico, usa el
get()
en la
conferenceRecords.participants
recurso con el parámetro de ruta de acceso name
. Para recuperar el nombre del
participante, usa el método conferenceRecords.participants.list
.
El método devuelve el nombre de un participante como una instancia de un
conferenceRecords.participants
recurso.
En la siguiente muestra de código, se indica cómo obtener un participante específico:
Java
Node.js
Python
Reemplaza el nombre del participante por el nombre del participante específico que vas a encontrar.
Sesiones para participantes
En las siguientes secciones, se detalla cómo obtener información sobre las sesiones de los participantes.
Buscar todas las sesiones de participantes
Para obtener detalles sobre todas las sesiones de un participante en una conferencia
de registro, usa el
list()
en la
conferenceRecords.participants.participantSessions
recurso con el parámetro de ruta de acceso parent
.
Puedes usar los campos startTime
o endTime
para filtrar los usuarios que se unieron
antes o después de cierto tiempo. Ambos campos usan el
Marca de tiempo
formato en RFC,
3339 UTC
"Zulú" 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 devuelve una lista de las sesiones de los participantes, ordenadas por hora de incorporación en
descendente, como instancia de un
conferenceRecords.participants.participantSession
recurso.
En la siguiente muestra de código, se indica cómo enumerar todas las sesiones de los participantes en una registro de la conferencia:
Java
Node.js
Python
Reemplaza el valor superior por el nombre del registro de la conferencia y el nombre del participante.
Buscar la sesión de un participante específico
Para buscar la sesión de un participante específico, usa el
get()
en la
conferenceRecords.participants.participantSessions
recurso con el parámetro de ruta de acceso name
. Para recuperar el nombre del
participante, usa el método list()
.
El método devuelve el nombre de un participante como una instancia de un
conferenceRecords.participants.participantSessions
recurso.
En la siguiente muestra de código, se indica cómo recuperar la sesión de un participante específico:
Java
Node.js
Python
Reemplaza el nombre del participante por el nombre del participante específico que vas a encontrar.
Recupera los detalles de los participantes con la API de People
Para recuperar detalles sobre un participante, usa el
people.get
en
API de People
- Extrae el ID de la persona del nombre del recurso del participante mediante el
componente final de la ruta. Por ejemplo, si el nombre del recurso del participante
es
conferenceRecords/abc-123/participants/12345
, el ID del La API de People está12345
. - Incluye las fuentes
READ_SOURCE_TYPE_PROFILE
,READ_SOURCE_TYPE_CONTACT
y yREAD_SOURCE_TYPE_OTHER_CONTACT
. Esto garantiza que tanto los usuarios internos una organización de Google Workspace y los contactos externos están incluidos en la respuesta.
El siguiente ejemplo busca en los perfiles y contactos de la organización un 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