Method: users.spaces.updateSpaceReadState

Cập nhật trạng thái đã đọc của người dùng trong một không gian, dùng để xác định tin nhắn đã đọc và chưa đọc. Để biết ví dụ, hãy xem phần Cập nhật trạng thái đọc không gian 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/{spaceReadState.name=users/*/spaces/*/spaceReadState}

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

Tham số đường dẫn

Thông số
spaceReadState.name

string

Tên tài nguyên của trạng thái đọc không gian.

Định dạng users/{user}/spaces/{space}/spaceReadState

Tham số truy vấn

Thông 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 nằm trước thời gian tạo tin nhắn mới nhất, không gian sẽ xuất hiện dưới dạng chưa đọc trong giao diện người dùng.

Để đánh dấu không gian là đã đọc, hãy đặt lastReadTime thành bất kỳ giá trị nào sau (lớn hơn) thời gian tạo tin nhắn mới nhất. lastReadTime được buộc phải khớp với thời gian tạo tin nhắn gần đây nhất. Xin lưu ý rằng trạng thái đã đọc của không gian chỉ ảnh hưởng đến trạng thái đã đọc của những tin nhắn xuất hiện trong cuộc trò chuyện cấp cao nhất của không gian. Dấu thời gian này không ảnh hưởng đến các thư trả lời trong chuỗi thư mà thay vào đó là dựa vào trạng thái đã đọc của chuỗi thư.

Nội dung yêu cầu

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

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 phiên bản của SpaceReadState.

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.