Method: spaces.spaceEvents.list

Muestra una lista de eventos de un espacio de Google Chat. Para cada evento, la carga útil contiene la versión más reciente del recurso de Chat. Por ejemplo, si enumeras eventos sobre miembros nuevos de un espacio, el servidor muestra recursos Membership que contienen los detalles de membresía más recientes. Si se quitaron miembros nuevos durante el período solicitado, la carga útil del evento contendrá un recurso Membership vacío.

Se requiere la autenticación del usuario. Para enumerar los 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

string

Obligatorio. Nombre del recurso del espacio de Google Chat en el que ocurrieron los eventos.

Formato: spaces/{space}.

Parámetros de consulta

Parámetros
pageSize

integer

Opcional. La cantidad máxima de eventos de espacio que se muestran. Es posible que el servicio muestre menos valores que este.

Los valores negativos muestran un error INVALID_ARGUMENT.
pageToken

string

Un token de página, recibido de una llamada anterior de eventos de espacio de lista. Proporciona esto para recuperar la página siguiente.

Durante 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

string

Obligatorio. Un filtro de consulta

Debes especificar, al menos, un tipo de evento (eventType) con el operador que tiene :. Para filtrar por varios tipos de eventos, usa el operador OR. Omite los tipos de eventos por lotes en el filtro. La solicitud muestra automáticamente cualquier evento por lotes relacionado. Por ejemplo, si filtras por reacciones nuevas (google.workspace.chat.reaction.v1.created), el servidor también mostrará eventos de reacciones nuevos por lotes (google.workspace.chat.reaction.v1.batchCreated). Para obtener una lista de los tipos de eventos admitidos, consulta la documentación de referencia de SpaceEvents.

De manera opcional, también puedes filtrar por hora de inicio (startTime) y hora de finalización (endTime):

  • startTime: Es una marca de tiempo exclusiva desde la que se deben comenzar a mostrar los eventos del espacio. Puedes enumerar los eventos que ocurrieron hace hasta 28 días. Si no se especifica, se muestran los eventos de espacio de los últimos 28 días.
  • endTime: Es la marca de tiempo inclusiva hasta la que se enumeran los eventos de espacio. Si no se especifica, enumera los eventos hasta el momento de la solicitud.

Para especificar una hora de inicio o finalización, usa el operador signo igual = y el formato en RFC-3339. Para filtrar por startTime y endTime, usa el operador AND.

Por ejemplo, las siguientes consultas son válidas:

startTime="2023-08-23T19:20:33+00:00" AND
endTime="2023-08-23T19:21:54+00:00"

startTime="2023-08-23T19:20:33+00:00" AND
(eventTypes:"google.workspace.chat.space.v1.updated" OR
eventTypes:"google.workspace.chat.message.v1.created")

Las siguientes consultas no son válidas:

startTime="2023-08-23T19:20:33+00:00" OR
endTime="2023-08-23T19:21:54+00:00"

eventTypes:"google.workspace.chat.space.v1.updated" AND
eventTypes:"google.workspace.chat.message.v1.created"

El servidor rechaza las consultas no válidas con un error INVALID_ARGUMENT.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Mensaje de respuesta para enumerar los eventos del espacio.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "spaceEvents": [
    {
      object (SpaceEvent)
    }
  ],
  "nextPageToken": string
}
Campos
spaceEvents[]

object (SpaceEvent)

Los resultados se muestran en orden cronológico (el evento más antiguo primero).
nextPageToken

string

Token de continuación usado para recuperar más eventos. Si se omite este campo, no habrá páginas siguientes.

Alcances de autorización

Se necesita uno de los siguientes permisos 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.