Method: users.spaces.threads.updateThreadReadState

Cập nhật trạng thái đọc của người dùng trong một chuỗi tin nhắn, dùng để xác định tin nhắn đã đọc và chưa đọc. Để xem ví dụ, hãy xem phần Cập nhật trạng thái đọc chuỗi tin nhắn của người dùng.

Yêu cầu xác thực người dùng bằng phạm vi uỷ quyền:

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

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Thông số
threadReadState.name

string

Tên tài nguyên của trạng thái đọc chuỗi tin nhắn.

Định dạng users/{user}/spaces/{space}/threads/{thread}/threadReadState

Tham số truy vấn

Tham số
updateMask

string (FieldMask format)

Bắt buộc. Đường dẫn trường cần cập nhật. Các đường dẫn trường hiện được hỗ trợ:

  • lastReadTime

Khi lastReadTime trước thời gian tạo tin nhắn mới nhất, chuỗi tin nhắn sẽ xuất hiện dưới dạng chưa đọc trong giao diện người dùng.

Để đánh dấu chuỗi tin nhắn là đã đọc, hãy đặt lastReadTime thành dấu thời gian bằng hoặc muộn hơn thời gian tạo tin nhắn mới nhất. Dấu thời gian trong tương lai sẽ được chuyển thành thời gian của yêu cầu hiện tại. Việc đặt dấu thời gian âm (trước 1970-01-01T00:00:00Z) sẽ trả về lỗi INVALID_ARGUMENT.

Nội dung yêu cầu

Nội dung yêu cầu chứa một bản sao của ThreadReadState.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa một thực thể của ThreadReadState.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem Hướng dẫn uỷ quyền.