Method: users.spaces.updateSpaceReadState

Aggiorna lo stato di lettura di un utente all'interno di uno spazio, utilizzato per identificare i messaggi letti e da leggere. Per un esempio, vedi Aggiornare lo stato di lettura dello spazio di un utente.

Richiede l'autenticazione dell'utente con l'ambito di autorizzazione:

  • https://www.googleapis.com/auth/chat.users.readstate

Richiesta HTTP

PATCH https://chat.googleapis.com/v1/{spaceReadState.name=users/*/spaces/*/spaceReadState}

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
spaceReadState.name

string

Nome della risorsa dello stato di lettura dello spazio.

Formato: users/{user}/spaces/{space}/spaceReadState

Parametri di query

Parametri
updateMask

string (FieldMask format)

Obbligatorio. I percorsi dei campi da aggiornare. Percorsi dei campi attualmente supportati:

  • lastReadTime

Quando lastReadTime è 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, imposta lastReadTime su un valore successivo (maggiore) all'ora di creazione dell'ultimo messaggio. Il valore lastReadTime viene forzato in modo che corrisponda all'ora di creazione dell'ultimo 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 sullo stato di lettura del thread.

Corpo della richiesta

Il corpo della richiesta contiene un'istanza di SpaceReadState.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di SpaceReadState.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/chat.users.readstate

Per ulteriori informazioni, consulta la Guida all'autorizzazione.