Method: users.spaces.threads.updateThreadReadState

Aktualisiert den Lesestatus eines Nutzers in einem Thread, um gelesene und ungelesene Nachrichten zu identifizieren. Ein Beispiel finden Sie unter Lesestatus eines Threads für einen Nutzer aktualisieren.

Erfordert eine Nutzerauthentifizierung mit dem Autorisierungsbereich:

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

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
threadReadState.name

string

Ressourcenname des Lesestatus des Threads.

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

Suchparameter

Parameter
updateMask

string (FieldMask format)

Erforderlich. Die zu aktualisierenden Feldpfade. Derzeit unterstützte Feldpfade:

  • lastReadTime

Wenn lastReadTime vor dem Erstellungszeitpunkt der neuesten Nachricht liegt, wird der Thread in der Benutzeroberfläche als ungelesen angezeigt.

Wenn Sie den Thread als gelesen markieren möchten, setzen Sie lastReadTime auf einen Zeitstempel, der dem Erstellungszeitpunkt der letzten Nachricht entspricht oder danach liegt. Zeitstempel in der Zukunft werden implizit in die aktuelle Anfragezeit umgewandelt. Wenn Sie einen negativen Zeitstempel (vor 1970-01-01T00:00:00Z) festlegen, wird der Fehler INVALID_ARGUMENT zurückgegeben.

Anfragetext

Der Anfragetext enthält eine Instanz von ThreadReadState.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von ThreadReadState.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.