Method: users.spaces.threads.updateThreadReadState

Aggiorna lo stato di lettura di un utente all'interno di un thread, utilizzato per identificare i messaggi letti e non letti. Per un esempio, consulta Aggiorna lo stato di lettura del thread di un utente.

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

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

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri di percorso

Parametri
threadReadState.name

string

Nome della risorsa dello stato di lettura del thread.

Formato: users/{user}/spaces/{space}/threads/{thread}/threadReadState

Parametri di query

Parametri
updateMask

string (FieldMask format)

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

  • lastReadTime

Quando lastReadTime è precedente all'ora di creazione dell'ultimo messaggio, il thread viene visualizzato come non letto nella UI.

Per contrassegnare il thread come letto, imposta lastReadTime su un timestamp uguale o successivo all'ora di creazione dell'ultimo messaggio. I timestamp futuri vengono forzati all'ora della richiesta corrente. L'impostazione di un timestamp negativo (prima di 1970-01-01T00:00:00Z) restituisce un errore INVALID_ARGUMENT.

Corpo della richiesta

Il corpo della richiesta contiene un'istanza di ThreadReadState.

Corpo della risposta

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

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per saperne di più, consulta la guida all'autorizzazione.