En esta guía, se explica cómo obtener detalles sobre los participantes que asistieron a una conferencia anterior o que están en una conferencia activa, junto con la información de su sesión, a través de la API de REST de Google Meet.
Un participante es una persona que se unió a una llamada o que usa el Modo complementario, que mira como oyente o que usa un dispositivo de sala conectado a una llamada. Hay un recurso de 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 participantSessions
para cada sesión. Si el participante se une a la misma llamada varias veces desde el mismo par dispositivo-participante, se le asigna un ID de sesión único cada vez.
Si eres propietario o participante de un espacio de reunión, puedes llamar a los métodos get()
y list()
en los recursos participants
y participantSessions
para recuperar registros de participantes.
La autenticación y autorización con credenciales de usuario permiten que las apps de Google Meet accedan a los datos del usuario y realicen operaciones en nombre del usuario autenticado. La autenticación con la delegación en todo el dominio te permite autorizar la cuenta de servicio de una aplicación para que acceda a los datos de tus usuarios sin necesidad de que cada usuario dé su consentimiento.
Participantes
En las siguientes secciones, se detalla cómo obtener información sobre los participantes en un registro de conferencia.
El recurso participants
se une con el campo user
. Un user
solo puede ser uno de los siguientes objetos:
Un
signedinUser
puede ser uno de los siguientes:Una persona que se une desde una computadora personal, un dispositivo móvil o a través del Modo complementario
Es una cuenta de robot que usan los dispositivos de la 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.
Ten en cuenta que, si bien los tres objetos devuelven un displayName
, signedinUser
también devuelve un ID de user
único que es interoperable con la API del SDK de Admin y la API de People. Formato: users/{user}
. Para obtener más información sobre cómo usar el ID de user
con la API de People, consulta Cómo recuperar detalles de participantes con la API de People.
Obtén detalles sobre un participante
Para obtener detalles sobre un participante específico, usa el método get()
en el recurso participants
con el parámetro de ruta de acceso name
. Si no conoces el nombre del participante, puedes listar todos los nombres de los participantes con el método list()
.
El método devuelve los datos del participante como una instancia de un recurso participants
.
En el siguiente ejemplo de código, se muestra cómo recuperar un participante específico:
Java
Node.js
Python
Reemplaza el nombre del participante por el ID del participante específico en un registro de conferencia.
Cómo ver a todos los participantes
Para enumerar los detalles de todos los participantes en un registro de conferencia, usa el método list()
en el recurso participants
con el parámetro de ruta de acceso parent
. Formato:
conferenceRecords/{conferenceRecord}
.
El método devuelve una lista de participantes de la conferencia, ordenados por earliestStartTime
en orden descendente, como una instancia de un recurso participants
. Para ajustar el tamaño de la página y filtrar los resultados de la consulta, consulta Cómo personalizar la paginación o filtrar la lista de participantes.
En el siguiente código de ejemplo, se muestra cómo enumerar a todos los participantes en un registro de conferencia:
Java
Node.js
Python
Reemplaza el valor principal por el nombre del registro de la conferencia.
Personaliza la paginación o filtra la lista de participantes
Pasa los siguientes parámetros de búsqueda para personalizar la paginación o filtrar participantes:
pageSize
: Es la cantidad máxima de participantes que se devolverán. El servicio podría devolver menos que este valor. Si no se especifica, se devolverán, como máximo, 100 participantes. El valor máximo es 250; los valores superiores a 250 se cambian automáticamente a 250.pageToken
: Es un token de página, recibido de una llamada a lista anterior. Proporciona este token para recuperar la página siguiente.filter
: Opcional Es un filtro de consulta para recuperar elementos específicos en los resultados del recursoparticipants
.Puedes usar los campos
earliestStartTime
olatestEndTime
para filtrar los usuarios que se unieron antes o se fueron después de un momento 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 enumerar todos los participantes activos en una conferencia existente, usa
latestEndTime IS NULL
.
Recupera detalles de los participantes con la API de People
Para recuperar detalles sobre un participante, usa el método get()
en el recurso people
de la API de People.
Extrae el ID de la persona del recurso
participant
con el componente final de la ruta de acceso. Por ejemplo, si el valor del recursoparticipant
esconferenceRecords/abc-123/participants/12345
, el ID de la API de People es12345
.Incluye
READ_SOURCE_TYPE_PROFILE
,READ_SOURCE_TYPE_CONTACT
yREAD_SOURCE_TYPE_OTHER_CONTACT
ReadSourceType
. Esto garantiza que tanto los usuarios internos de una organización de Google Workspace como los contactos externos se incluyan en la respuesta.
En la siguiente muestra de código, se muestra cómo buscar perfiles de organizaciones y contactos de una 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
Reemplaza lo siguiente:
- PERSON_ID: ID de la persona que se busca.
- ACCESS_TOKEN: Es el token de acceso que otorga acceso a varias APIs.
Sesiones de participantes
En las siguientes secciones, se detalla cómo obtener información sobre las sesiones de un participante en un registro de conferencia.
Obtén detalles sobre una sesión de participante
Para obtener detalles sobre una sesión de participante específica, usa el método get()
en el recurso participantSessions
con el parámetro de ruta de acceso name
. Si no conoces el nombre de la sesión del participante, puedes listar todas las sesiones de un participante con el método list()
.
El método devuelve un nombre de participante como una instancia de un recurso participantSessions
.
En el siguiente ejemplo 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 ID de sesión específico del participante en una sesión de participante.
Enumera todas las sesiones de participantes
Para enumerar los detalles de todas las sesiones de un participante en un registro de conferencia, usa el método list()
en el recurso participantSessions
con el parámetro de ruta de acceso parent
. Formato:
conferenceRecords/{conferenceRecord}/participants/{participant}
.
El método devuelve una lista de sesiones de participantes, ordenadas por startTime
en orden descendente, como una instancia de un recurso participantSession
. Para ajustar el tamaño de la página y filtrar los resultados de la búsqueda, consulta Cómo personalizar la paginación o filtrar la lista de sesiones de participantes.
En la siguiente muestra de código, se muestra cómo enumerar todas las sesiones de participantes en un registro de conferencia:
Java
Node.js
Python
Reemplaza el valor principal por el nombre de las sesiones del participante de un participante en un registro de conferencia.
Personaliza la paginación o filtra la lista de sesiones de participantes
Pasa los siguientes parámetros de búsqueda opcionales para personalizar la paginación o filtrar las sesiones de los participantes:
pageSize
: Es la cantidad máxima de sesiones de participantes que se devolverán. El servicio puede devolver menos que este valor. Si no se especifica, se devolverán, como máximo, 100 sesiones de participantes. El valor máximo es 250; los valores superiores a 250 se cambian automáticamente a 250.pageToken
: Es un token de página, recibido de una llamada a lista anterior. Proporciona este token para recuperar la página siguiente.filter
: Opcional Es un filtro de consulta para recuperar elementos específicos en los resultados del recursoparticipants
.Puedes usar los campos
startTime
oendTime
para filtrar a los usuarios que se unieron antes o se fueron después de un momento 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
Para enumerar todas las sesiones de participantes activos en el registro de la conferencia, usa
endTime IS NULL
.