Method: users.spaces.threads.updateThreadReadState

Aktualizuje stan odczytu użytkownika w wątku, który służy do identyfikowania przeczytanych i nieprzeczytanych wiadomości. Przykład znajdziesz w artykule Aktualizowanie stanu przeczytania wątku użytkownika.

Wymaga uwierzytelnienia użytkownika z zakresem autoryzacji:

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

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
threadReadState.name

string

Nazwa zasobu stanu odczytu wątku.

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

Parametry zapytania

Parametry
updateMask

string (FieldMask format)

Wymagane. Ścieżki pól do zaktualizowania. Obecnie obsługiwane ścieżki pól:

  • lastReadTime

Jeśli wartość lastReadTime jest wcześniejsza niż czas utworzenia ostatniej wiadomości, wątek jest wyświetlany w interfejsie jako nieprzeczytany.

Aby oznaczyć wątek jako przeczytany, ustaw lastReadTime na sygnaturę czasową równą lub późniejszą niż czas utworzenia najnowszej wiadomości. Sygnatury czasowe z przyszłości są wymuszane na bieżący czas żądania. Ustawienie ujemnej sygnatury czasowej (przed 1970-01-01T00:00:00Z) zwraca błąd INVALID_ARGUMENT.

Treść żądania

Treść żądania zawiera wystąpienie elementu ThreadReadState.

Treść odpowiedzi

W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu ThreadReadState.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w przewodniku po autoryzacji.