Questa guida spiega come utilizzare il metodo
get()
nella risorsa SpaceEvent
dell'API Google Chat per ottenere i dettagli di 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 che è stata modificata. Ad esempio, se
richiedi un evento relativo a un nuovo messaggio, ma il messaggio è stato aggiornato successivamente,
il server restituisce la risorsa Message
aggiornata nel payload dell'evento.
Per chiamare questo metodo, devi utilizzare autenticazione degli utenti. 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.
- Abilita e configura l'API Google Chat con un nome, l'icona e la descrizione dell'app Chat.
- Installa il Node.js libreria client di Cloud.
-
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 directory locale.
- Scegli un ambito di autorizzazione che supporti l'autenticazione degli utenti.
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 che l'app funzioni.
- Chiama il metodo
GetSpaceEvent()
passando ilname
dell'evento spazio da recuperare.
L'esempio seguente restituisce un evento dello spazio:
Node.js
Per eseguire questo esempio, sostituisci quanto segue:
SCOPE_NAME
: un ambito di autorizzazione basato sul tipo di evento. Ad esempio, se vuoi ricevere un evento spaziale sui nuovi abbonamenti, usa 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 della proprietàname
Puoi ottenerlo chiamando il metodoListSpaces()
o dall'URL dello spazio.SPACE_EVENT_NAME
: l'ID dell'evento dello spazioname
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.