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 ThreadReadState
của API Google Chat để biết thông tin chi tiết về trạng thái đọc của người dùng trong một chuỗi tin nhắn. Để biết trạng thái đã đọc của một tin nhắn trong không gian, hãy xem phần Nhận thông tin chi tiết về trạng thái đã đọc của người dùng trong không gian.
Tài nguyên ThreadReadState
là một tài nguyên singleton đại diện cho thông tin chi tiết về tin nhắn đã đọc gần đây nhất của một người dùng cụ thể trong chuỗi tin nhắn trên Google Chat.
Điều kiện tiên quyết
Node.js
- Tài khoản Google Workspace dành cho doanh nghiệp hoặc doanh nghiệp lớn có quyền truy cập vào Google Chat.
- Thiết lập môi trường:
- Tạo dự án trên Google Cloud.
- Định cấu hình màn hình xin phép bằng OAuth.
- Bật và định cấu hình API Google Chat bằng tên, biểu tượng và nội dung mô tả cho ứng dụng Chat.
- Cài đặt Thư viện ứng dụng đám mây Node.js.
-
Tạo thông tin xác thực mã ứng dụng khách OAuth cho ứ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 xác thực dưới dạng tệp JSON có tên
client_secrets.json
vào thư mục cục bộ.
- Chọn phạm vi uỷ quyền hỗ trợ xác thực người dùng.
Lấy trạng thái đọc luồng 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 chuỗi thư, hãy thêm nội dung 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
GetThreadReadState()
, truyềnname
của trạng thái đọc luồng để lấy, trong đó có mã nhận dạng người dùng hoặc bí danh và mã nhận dạng không gian. Việc lấy trạng thái đọc luồng chỉ hỗ trợ việc 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 đặt một trong những trạng thái sau:- Bí danh
me
. Ví dụ:users/me/spaces/SPACE/threads/THREAD/threadReadState
. - Địa chỉ email Workspace của người dùng gọi. Ví dụ:
users/user@example.com/spaces/SPACE/threads/THREAD/threadReadState
. - Mã nhận dạng người dùng của người dùng gọi. Ví dụ:
users/USER/spaces/SPACE/threads/THREAD/threadReadState
.
- Bí danh
Ví dụ sau đây sẽ lấy trạng thái đọc luồng của người dùng gọi:
Node.js
Để chạy mẫu này, hãy thay thế nội dung sau:
SPACE_NAME
: 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ứcListSpaces()
hoặc từ URL của không gian.THREAD_NAME
: mã nhận dạng từname
của luồng. Bạn có thể lấy mã nhận dạng từ phần nội dung phản hồi được trả về sau khi tạo một tin nhắn không đồng bộ bằng API Chat hoặc bằng tên tuỳ chỉnh được chỉ định cho tin nhắn khi tạo.
API Google Chat nhận trạng thái đọc luồng đã chỉ định và trả về một thực thể của ThreadReadState
.
Chủ đề có liên quan
- Cập nhật trạng thái đọc không gian của người dùng gọi.
- Lấy trạng thái đọc không gian của người dùng gọi.