Questa guida spiega come utilizzare
update()
sulla risorsa SpaceReadState
dell'API Google Chat per contrassegnare gli spazi come
letto o da leggere.
La
risorsa SpaceReadState
è una risorsa singleton che rappresenta i dettagli dell'ultimo messaggio letto da 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:
- Creare 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.
-
Creare le credenziali con ID client OAuth per un'applicazione desktop. Per eseguire l'esempio in questo
guida, salva le credenziali come file JSON denominato
client_secrets.json
nel tuo 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 in la tua richiesta:
- Specifica l'ambito di autorizzazione
chat.users.readstate
. - Chiama il
UpdateSpaceReadState()
. - Passa
updateMask
con il valorelastReadTime
. - Passa
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 aggiornare lo 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
è stato impostato sul valore aggiornato dell'ora quando lo stato di lettura dello spazio dell'utente è stato aggiornato. Di solito corrisponde Il timestamp dell'ultimo messaggio letto o un timestamp specificato dall'utente per contrassegnare l'ultima posizione di lettura in uno spazio. Quando il valorelastReadTime
è precedente data/ora di creazione dell'ultimo messaggio, lo spazio appare come da leggere nell'interfaccia utente. Per contrassegnare lo spazio come letto, impostalastReadTime
su un valore successivo (maggiore) rispetto all'ora di creazione dell'ultimo messaggio.lastReadTime
è costretto a corrispondere all'ultima l'ora di creazione del messaggio. 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 invece sul valore lo stato di lettura del thread.
- Il campo
L'esempio seguente aggiorna lo stato di lettura dello spazio dell'utente chiamante:
Node.js
Per eseguire questo sample, sostituisci SPACE_NAME
con l'ID di
name
dell'area.
Puoi ottenerlo 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 chiamante.
- Ottieni lo stato di lettura del thread dell'utente che chiama.