Questa guida spiega come utilizzare il metodo
update()
nella risorsa SpaceReadState
dell'API Google Chat per contrassegnare gli spazi come
letti o non letti.
La risorsa SpaceReadState
è una risorsa singleton che rappresenta i dettagli dell'ultimo messaggio letto di un utente specificato in uno spazio di Google Chat.
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 per 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 directory locale.
- Scegli un ambito di autorizzazione che supporti l'autenticazione utente.
Aggiorna lo stato di lettura dello spazio dell'utente chiamante
Per aggiornare lo stato di lettura di un utente all'interno di uno spazio, includi quanto segue nella richiesta:
- Specifica l'ambito di autorizzazione
chat.users.readstate
. - Chiama il metodo
UpdateSpaceReadState()
. - Passa
updateMask
con il valorelastReadTime
. - Trasmetti
spaceReadState
come istanza diSpaceReadState
con quanto segue:- Il campo
name
impostato sullo stato di lettura dello spazio da aggiornare, che include un ID utente o un alias e un ID spazio. L'aggiornamento dello stato di lettura dello spazio supporta solo l'aggiornamento dello stato di lettura dell'utente chiamante, che può essere specificato impostando una delle seguenti opzioni:- L'alias
me
. Ad esempio,users/me/spaces/SPACE/spaceReadState
. - L'indirizzo email Workspace dell'utente che ha effettuato la chiamata. Ad esempio,
users/user@example.com/spaces/SPACE/spaceReadState
. - L'ID utente dell'utente chiamante. Ad esempio,
users/USER/spaces/SPACE/spaceReadState
.
- L'alias
- Il campo
lastReadTime
impostato sul valore aggiornato dell'ora in cui è stato aggiornato lo stato di lettura dello spazio dell'utente. Di solito corrisponde al timestamp dell'ultimo messaggio letto o a un timestamp specificato dall'utente per contrassegnare l'ultima posizione letta in uno spazio. QuandolastReadTime
è precedente alla data e all'ora di creazione dell'ultimo messaggio, lo spazio viene visualizzato come non letto nell'interfaccia utente. Per contrassegnare lo spazio come letto, impostalastReadTime
su un valore successivo (più grande) rispetto all'ora di creazione dell'ultimo messaggio. Il valorelastReadTime
viene forzato in modo che corrisponda all'ora di creazione del messaggio più recente. Tieni presente che lo stato di lettura dello spazio influisce solo sullo stato di lettura dei messaggi visibili nella conversazione di primo livello dello spazio. Le risposte nei thread non sono interessate da questo timestamp e si basano sullo stato di lettura del thread.
- Il campo
L'esempio seguente aggiorna lo stato di lettura dello spazio dell'utente che chiama:
Node.js
Per eseguire questo esempio, sostituisci SPACE_NAME
con l'ID
del name
dello spazio.
Puoi ottenere l'ID chiamando il metodo
ListSpaces()
o dall'URL dello spazio.
L'API Google Chat aggiorna lo stato di lettura dello spazio specificato e restituisce un'istanza di SpaceReadState
.
Argomenti correlati
- Ottieni lo stato di lettura dello spazio dell'utente che chiama.
- Ottieni lo stato di lettura del thread dell'utente che chiama.