Hướng dẫn này giải thích cách sử dụng phương thức get()
trên tài nguyên SpaceReadState
của Google Chat API để lấy thông tin chi tiết về trạng thái đã đọc của người dùng trong một không gian. Để biết trạng thái đã đọc của một thư trong chuỗi thư, hãy xem phần Lấy thông tin chi tiết về trạng thái đã đọc của chuỗi thư của người dùng.
Tài nguyên SpaceReadState
là một tài nguyên đơn lẻ, thể hiện thông tin chi tiết về tin nhắn đã đọc lần gần đây nhất của một người dùng cụ thể trong một không gian trên Google Chat.
Điều kiện tiên quyết
Node.js
- Tài khoản Google Workspace Business hoặc Enterprise có quyền truy cập vào Google Chat.
- Thiết lập môi trường:
- Tạo một dự án trên Google Cloud.
- Định cấu hình màn hình đồng ý OAuth.
- Bật và định cấu hình Google Chat API bằng tên, biểu tượng và nội dung mô tả cho ứng dụng Chat của bạn.
- Cài đặt Thư viện ứng dụng Cloud Node.js.
-
Tạo thông tin đăng nhập mã ứng dụng khách OAuth cho một ứng dụng dành cho máy tính. Để chạy mẫu trong hướng dẫn này, hãy lưu thông tin đăng nhập dưới dạng tệp JSON có tên là
credentials.json
vào thư mục cục bộ của bạn.
- Chọn một phạm vi uỷ quyền hỗ trợ xác thực người dùng.
Lấy trạng thái đã đọc không gian của người dùng gọi
Để biết thông tin chi tiết về trạng thái đã đọc của người dùng trong một không gian, hãy thêm những thông tin sau vào yêu cầu của bạn:
- Chỉ định phạm vi uỷ quyền
chat.users.readstate
hoặcchat.users.readstate.readonly
. - Gọi phương thức
GetSpaceReadState()
, truyềnname
của trạng thái đã đọc không gian để biết trạng thái này bao gồm mã nhận dạng người dùng hoặc biệt hiệu và mã nhận dạng không gian. Thao tác lấy trạng thái đã đọc của không gian chỉ hỗ trợ lấy trạng thái đã đọc của người dùng gọi. Bạn có thể chỉ định trạng thái này bằng cách thiết lập một trong những trạng thái sau:- Bí danh
me
. Ví dụ:users/me/spaces/SPACE/spaceReadState
. - Địa chỉ email Workspace của người dùng gọi. Ví dụ:
users/user@example.com/spaces/SPACE/spaceReadState
. - Mã nhận dạng người dùng của người dùng gọi. Ví dụ:
users/USER/spaces/SPACE/spaceReadState
.
- Bí danh
Ví dụ sau đây lấy trạng thái đọc không gian của người dùng gọi:
Node.js
Để chạy mẫu này, hãy thay thế SPACE_NAME
bằng mã nhận dạng từ name
của không gian.
Bạn có thể lấy mã nhận dạng bằng cách gọi phương thức ListSpaces()
hoặc từ URL của không gian.
Google Chat API nhận trạng thái đã đọc của không gian được chỉ định và trả về một phiên bản của SpaceReadState
.
Chủ đề có liên quan
- Cập nhật trạng thái đã đọc của không gian của người dùng gọi.
- Lấy trạng thái đã đọc của luồng của người dùng gọi.