Method: users.spaces.updateSpaceReadState
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. Các đường dẫn trường cần cập nhật. Các đường dẫn trường hiện được hỗ trợ:
Khi lastReadTime xuất hiện trước thời gian tạo thông báo mới nhất, không gian sẽ có trạng thái là 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 muộn hơn (lớn hơn) thời gian tạo tin nhắn gần đây nhất. lastReadTime bị buộc phải khớp với thời gian tạo thông báo mới nhất. Xin lưu ý rằng trạng thái đọc không gian chỉ ảnh hưởng đến trạng thái đã đọc của 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 câu trả lời trong chuỗi mà thay vào đó, phụ thuộc vào trạng thái đọc chuỗi.
|
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 bài viết Hướng dẫn uỷ quyền.
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-02-27 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-02-27 UTC."],[[["This API updates a user's read state within a Google Chat space, marking messages as read or unread."],["It requires user authentication and the `chat.users.readstate` OAuth scope for authorization."],["The request uses the PATCH method and specifies the space read state resource name in the URL path."],["You can control which fields to update using the `updateMask` query parameter, such as setting the `lastReadTime` to mark a space as read."],["The request and response bodies utilize the `SpaceReadState` object to represent the user's read state information."]]],["This outlines updating a user's read state in a space using a PATCH request to `https://chat.googleapis.com/v1/{spaceReadState.name=users/*/spaces/*/spaceReadState}`. Key components include specifying the `spaceReadState.name` in the path, updating the `lastReadTime` via the `updateMask` query parameter, and providing a `SpaceReadState` instance in the request body. The response, if successful, returns a `SpaceReadState` instance. This operation requires user authentication and the `https://www.googleapis.com/auth/chat.users.readstate` authorization scope.\n"]]