Method: users.spaces.threads.updateThreadReadState

Обновляет статус прочтения пользователем сообщений в цепочке. Используется для идентификации прочитанных и непрочитанных сообщений. Пример приведен в разделе Как обновить статус прочтения цепочки пользователем.

Требуется аутентификация пользователя с областью авторизации:

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

HTTP-запрос

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

URL имеет синтаксис gRPC Transcoding.

Параметры пути

Параметры
threadReadState.name

string

Название ресурса статуса прочтения цепочки.

Формат: users/{user}/spaces/{space}/threads/{thread}/threadReadState

Параметры запроса

Параметры
updateMask

string (FieldMask format)

Обязательно. Пути к полям, которые нужно обновить. Поддерживаемые пути полей:

  • lastReadTime

Если значение lastReadTime меньше времени создания последнего сообщения, цепочка помечается как непрочитанная.

Чтобы пометить цепочку как прочитанную, задайте для lastReadTime временную метку, которая совпадает со временем создания последнего сообщения или позже него. Временные метки, относящиеся к будущему, принудительно заменяются на время текущего запроса. Если задать отрицательную временную метку (до 1970-01-01T00:00:00Z), возвращается ошибка INVALID_ARGUMENT.

Тело запроса

Тело запроса содержит экземпляр ThreadReadState.

Тело ответа

Если ответ получен успешно, его тело содержит экземпляр ThreadReadState.

Области авторизации

Требуется следующая область действия OAuth:

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

Подробную информацию можно найти в руководстве по авторизации.