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
- Un account Google Workspace Business o Enterprise con accesso a Google Chat.
- Configura l'ambiente:
- Crea un progetto Google Cloud.
- Configura la schermata per il consenso OAuth.
- Attiva e configura l'API Google Chat con un nome, un'icona e una descrizione per la tua app di chat.
- Installa la libreria client Cloud di Node.js.
-
Crea le credenziali dell'ID client OAuth per un'applicazione desktop. Per eseguire l'esempio in questa guida, salva le credenziali come file JSON denominato
client_secrets.json
nella tua directory locale.
- Scegli un ambito di autorizzazione che supporti l'autenticazione utente.
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 ilname
dell'evento spaziale per ottenere.
L'esempio seguente recupera un evento spazio:
Node.js
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'ambitochat.memberships.readonly
, formattato comehttps://www.googleapis.com/auth/chat.memberships.readonly
. Puoi ottenere il tipo di evento dal metodoListSpaceEvents()
. Per scoprire come utilizzare questo metodo, consulta Elenca gli eventi di uno spazio.SPACE_NAME
: l'ID delname
dello spazio. Puoi ottenere l'ID chiamando il metodoListSpaces()
o dall'URL dello spazio.SPACE_EVENT_NAME
: l'ID delname
dell'evento dello spazio. Puoi ottenere l'ID dal metodoListSpaceEvents()
. 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.