- Solicitud HTTP
- Parámetros de ruta de acceso
- Parámetros de consulta
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Alcances de la autorización
- Pruébala
Muestra una lista de eventos de un espacio de Google Chat. Para cada evento, payload contiene la versión más reciente del recurso de Chat. Por ejemplo, si enumeras eventos sobre nuevos miembros del espacio, el servidor muestra recursos Membership
que contienen los detalles más recientes de la membresía. Si se quitaron miembros nuevos durante el período solicitado, la carga útil del evento contiene un recurso Membership
vacío.
Requiere la autenticación del usuario. Para mostrar una lista de eventos, el usuario autenticado debe ser miembro del espacio.
Para ver un ejemplo, consulta Enumera eventos de un espacio de Google Chat.
Solicitud HTTP
GET https://chat.googleapis.com/v1/{parent=spaces/*}/spaceEvents
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
Parámetros | |
---|---|
parent |
Obligatorio. El nombre del recurso del espacio de Google Chat en el que ocurrieron los eventos. Formato: |
Parámetros de consulta
Parámetros | |
---|---|
pageSize |
Opcional. La cantidad máxima de eventos de espacio que se muestran. Es posible que el servicio muestre menos que este valor. Los valores negativos muestran un error |
pageToken |
Un token de página, recibido de una llamada anterior de eventos de espacio de lista. Proporciona esto para recuperar la página siguiente. Cuando se utiliza la paginación, todos los demás parámetros proporcionados para enumerar los eventos de espacio deben coincidir con la llamada que proporcionó el token de la página. Pasar valores diferentes a los otros parámetros puede generar resultados inesperados. |
filter |
Obligatorio. Un filtro de consulta. Debes especificar, al menos, un tipo de evento ( De manera opcional, también puedes filtrar por hora de inicio (
Para especificar una hora de inicio o finalización, usa el operador igual Por ejemplo, las siguientes consultas son válidas:
Las siguientes consultas no son válidas:
El servidor rechaza las consultas no válidas con un error |
Cuerpo de la solicitud
El cuerpo de la solicitud debe estar vacío.
Cuerpo de la respuesta
Mensaje de respuesta para enumerar eventos del espacio.
Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:
Representación JSON |
---|
{
"spaceEvents": [
{
object ( |
Campos | |
---|---|
spaceEvents[] |
Los resultados se muestran en orden cronológico (el evento más antiguo primero). |
nextPageToken |
Token de continuación que se usa para recuperar más eventos. Si se omite este campo, no habrá páginas siguientes. |
Permisos de autorización
Se necesita uno de los siguientes alcances de OAuth:
https://www.googleapis.com/auth/chat.spaces
https://www.googleapis.com/auth/chat.spaces.readonly
https://www.googleapis.com/auth/chat.messages
https://www.googleapis.com/auth/chat.messages.readonly
https://www.googleapis.com/auth/chat.memberships
https://www.googleapis.com/auth/chat.memberships.readonly
https://www.googleapis.com/auth/chat.messages.reactions
https://www.googleapis.com/auth/chat.messages.reactions.readonly
Para obtener más información, consulta la guía de autorización.