Xem thông tin chi tiết về trạng thái đọc chuỗi bài đăng của người dùng

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 Google Chat API để 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 một không gian, hãy xem phần Lấy thông tin chi tiết về trạng thái đã đọc không gian của người dùng.

Tài nguyên ThreadReadState là một tài nguyên đơn lẻ, thể hiện thông tin chi tiết về tin nhắn gần đây nhất mà một người dùng cụ thể đã đọc trong một chuỗi tin nhắn trên Google Chat.

Điều kiện tiên quyết

Node.js

Lấy trạng thái đã đọc của 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 tin nhắn, 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ặc chat.users.readstate.readonly.
  • Gọi phương thức GetThreadReadState(), truyền name của trạng thái đã đọc của luồng để 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 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 thiết lập 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.

Ví dụ sau đây lấy trạng thái đã đọc của luồng của người dùng gọi:

Node.js

chat/client-libraries/cloud/get-thread-read-state-user-cred.js
import {createClientWithUserCredentials} from './authentication-utils.js';

const USER_AUTH_OAUTH_SCOPES = ['https://www.googleapis.com/auth/chat.users.readstate.readonly'];

// This sample shows how to get the thread read state for a space and calling user
async function main() {
  // Create a client
  const chatClient = await createClientWithUserCredentials(USER_AUTH_OAUTH_SCOPES);

  // Initialize request argument(s)
  const request = {
    // Replace SPACE_NAME and THREAD_NAME here
    name: 'users/me/spaces/SPACE_NAME/threads/THREAD_NAME/threadReadState',
  };

  // Make the request
  const response = await chatClient.getThreadReadState(request);

  // Handle the response
  console.log(response);
}

main().catch(console.error);

Để chạy mẫu này, hãy thay thế các giá trị 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ức ListSpaces() 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 này từ 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 Chat API hoặc bằng tên tuỳ chỉnh được chỉ định cho tin nhắn tại thời điểm tạo.

Google Chat API nhận trạng thái đã đọc của chuỗi được chỉ định và trả về một thực thể của ThreadReadState.