Receber detalhes sobre um evento de um espaço do Google Chat

Este guia explica como usar o get() no recurso SpaceEvent da API Google Chat para conferir detalhes sobre um evento em um espaço do Google Chat.

O recurso SpaceEvent representa uma mudança em um espaço ou nos recursos filhos dele, como mensagens, reações e associações. Para saber mais sobre os tipos de eventos aceitos, consulte a documentação de referência do campo eventType do recurso SpaceEvent.

É possível solicitar eventos até 28 dias antes. O evento contém a versão mais recente do recurso que foi alterado. Por exemplo, se você solicitar um evento sobre uma nova mensagem, mas ela for atualizada posteriormente, o servidor retorna o recurso Message atualizado no payload do evento.

Para chamar esse método, você precisa usar autenticação do usuário. Para receber evento, o usuário autenticado precisa participar do espaço onde o evento o incidente.

Pré-requisitos

Node.js

Receber detalhes sobre um evento espacial

Para acessar detalhes sobre um evento de um espaço no Google Chat, transmita o seguinte no seu solicitação:

  • Especifique um escopo de autorização que ofereça suporte ao tipo de evento na sua solicitação. Como prática recomendada, escolha o escopo mais restritivo que ainda permite que sua para funcionar.
  • Chame o método GetSpaceEvent(), transmitindo o name do evento de espaço a ser recebido.

O exemplo a seguir recebe um evento de espaço:

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 executar este exemplo, substitua o seguinte:

  • SCOPE_NAME: um escopo de autorização com base no tipo de evento. Por exemplo, se você estiver recebendo um evento espacial sobre uma nova assinatura, use o escopo chat.memberships.readonly, formatado como https://www.googleapis.com/auth/chat.memberships.readonly. É possível receber o tipo de evento do método ListSpaceEvents(). Para aprender a usar esse método, consulte Listar eventos de um espaço
  • SPACE_NAME: o ID do espaço. name. Você pode obter o ID chamando o ListSpaces() ou do URL do espaço.
  • SPACE_EVENT_NAME: o ID do name do evento no espaço. É possível extrair o ID do método ListSpaceEvents(). Para aprender a usar esse método, consulte Listar eventos de um espaço

A API Chat retorna uma instância de SpaceEvent com detalhes sobre o evento.