Method: spaces.spaceEvents.list

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

string

Obligatorio. El 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 que este valor.

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.

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

string

Obligatorio. Un filtro de consulta.

Debes especificar, al menos, un tipo de evento (eventType) con el operador :. 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 muestra eventos de reacciones nuevos por lotes (google.workspace.chat.reaction.v1.batchCreated). Para obtener una lista de los tipos de eventos compatibles, 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: Marca de tiempo exclusiva a partir de la cual se comienza a enumerar los eventos espaciales. Puedes enumerar los eventos que ocurrieron hace hasta 28 días. Si no se especifica, se enumeran los eventos espaciales de los últimos 28 días.
  • endTime: Es la marca de tiempo inclusiva hasta la que se enumeran los eventos espaciales. 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 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 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 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.