Obtén detalles sobre un evento de un espacio de Google Chat

En esta guía, se explica cómo usar el método get() en el recurso SpaceEvent de la API de Google Chat para obtener detalles sobre un evento de un espacio de Google Chat.

El recurso SpaceEvent representa un cambio en un espacio o en sus recursos secundarios, como mensajes, reacciones y membresías. Para obtener información sobre los tipos de eventos admitidos, consulta el campo eventType de la documentación de referencia del recurso SpaceEvent.

Puedes solicitar eventos hasta 28 días antes de la hora de la solicitud. El evento contiene la versión más reciente del recurso que cambió. Por ejemplo, si solicitas un evento sobre un mensaje nuevo, pero el mensaje se actualizó más tarde, el servidor muestra el recurso Message actualizado en la carga útil del evento.

Para llamar a este método, debes usar la autenticación de usuario. Para obtener un evento, el usuario autenticado debe ser miembro del espacio en el que ocurrió el evento.

Requisitos previos

Node.js

Cómo obtener detalles sobre un evento espacial

Para obtener detalles sobre un evento espacial en Google Chat, pasa lo siguiente en tu solicitud:

  • Especifica un alcance de autorización que admita el tipo de evento en tu solicitud. Como práctica recomendada, elige el permiso más restrictivo que aún permita que tu app funcione.
  • Llama al método GetSpaceEvent() y pasa el name del evento espacial que deseas obtener.

En el siguiente ejemplo, se obtiene un evento de espacio:

Node.js

chat/client-libraries/cloud/get-space-event-user-cred.js
import {createClientWithUserCredentials} from './authentication-utils.js';

// Replace SCOPE_NAME here with an authorization scope based on the event type
const USER_AUTH_OAUTH_SCOPES = ['SCOPE_NAME'];

// This sample shows how to get space event with user credential
async function main() {
  // Create a client
  const chatClient = await createClientWithUserCredentials(USER_AUTH_OAUTH_SCOPES);

  // Initialize request argument(s)
  const request = {
    // Replace SPACE_NAME and SPACE_EVENT_NAME here
    name: 'spaces/SPACE_NAME/spaceEvents/SPACE_EVENT_NAME'
  };

  // Make the request
  const response = await chatClient.getSpaceEvent(request);

  // Handle the response
  console.log(response);
}

main().catch(console.error);

Para ejecutar esta muestra, reemplaza lo siguiente:

  • SCOPE_NAME: Es un alcance de autorización basado en el tipo de evento. Por ejemplo, si recibes un evento espacial sobre una membresía nueva, usa el alcance chat.memberships.readonly, con el formato https://www.googleapis.com/auth/chat.memberships.readonly. Puedes obtener el tipo de evento del método ListSpaceEvents(). Para obtener información sobre cómo usar este método, consulta Cómo crear una lista de eventos de un espacio.
  • SPACE_NAME: Es el ID del name del espacio. Para obtener el ID, llama al método ListSpaces() o desde la URL del espacio.
  • SPACE_EVENT_NAME: Es el ID del name del evento espacial. Puedes obtener el ID del método ListSpaceEvents(). Para aprender a usar este método, consulta Crea una lista de eventos de un espacio.

La API de Chat muestra una instancia de SpaceEvent con detalles sobre el evento.