Ottenere dettagli su un evento dello spazio di Google Chat

Questa guida spiega come utilizzare il metodo get() nella risorsa SpaceEvent dell'API Google Chat per ottenere dettagli su un evento da uno spazio di Google Chat.

La risorsa SpaceEvent rappresenta una modifica a uno spazio o alle relative risorse figlio, ad esempio messaggi, reazioni e adesioni. Per informazioni sui tipi di eventi supportati, consulta il campo eventType della documentazione di riferimento della risorsa SpaceEvent.

Puoi richiedere eventi fino a 28 giorni prima dell'ora della richiesta. L'evento contiene la versione più recente della risorsa modificata. Ad esempio, se richiedi un evento relativo a un nuovo messaggio, ma il messaggio è stato successivamente aggiornato, il server restituisce la risorsa Message aggiornata nel payload dell'evento.

Per chiamare questo metodo, devi utilizzare l'autenticazione utente. Per ricevere un evento, l'utente autenticato deve essere un membro dello spazio in cui si è verificato l'evento.

Prerequisiti

Node.js

Visualizzare i dettagli di un evento nello spazio

Per ottenere i dettagli di un evento dello spazio in Google Chat, passa quanto segue nella richiesta:

  • Specifica un ambito di autorizzazione che supporti il tipo di evento nella richiesta. Come best practice, scegli l'ambito più restrittivo che consenta comunque il funzionamento della tua app.
  • Chiama il metodo GetSpaceEvent(), passando il name dell'evento spaziale per ottenere.

L'esempio seguente recupera un evento spazio:

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);

Per eseguire questo esempio, sostituisci quanto segue:

  • SCOPE_NAME: un ambito di autorizzazione basato sul tipo di evento. Ad esempio, se ricevi un evento dello spazio relativo a un nuovo abbonamento, utilizza l'ambito chat.memberships.readonly, formattato come https://www.googleapis.com/auth/chat.memberships.readonly. Puoi ottenere il tipo di evento dal metodo ListSpaceEvents(). Per scoprire come utilizzare questo metodo, consulta Elenca gli eventi di uno spazio.
  • SPACE_NAME: l'ID del name dello spazio. Puoi ottenere l'ID chiamando il metodo ListSpaces() o dall'URL dello spazio.
  • SPACE_EVENT_NAME: l'ID del name dell'evento dello spazio. Puoi ottenere l'ID dal metodo ListSpaceEvents(). Per scoprire come utilizzare questo metodo, consulta Elenca gli eventi di uno spazio.

L'API Chat restituisce un'istanza di SpaceEvent con i dettagli dell'evento.