Xem thông tin chi tiết về trạng thái đọc không gian 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 SpaceReadState 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 không gian. Để biết trạng thái đã đọc của một thư trong chuỗi thư, hãy xem phần Nhận thông tin chi tiết về trạng thái đã đọc chuỗi thư của người dùng.

Tài nguyên SpaceReadState là một tài nguyên singleton biểu thị 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 chỉ định trong phòng Google Chat.

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

Node.js

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 không gian, hãy thêm 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 GetSpaceReadState(), truyền name của trạng thái đọc không gian để lấy, bao gồm mã nhận dạng người dùng hoặc bí danh và mã không gian. Việc thu thập trạng thái đọc không gian chỉ hỗ trợ nhận 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 các tuỳ chọn 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.

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

Node.js

chat/client-libraries/cloud/get-space-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 space read state for the 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 here
    name: 'users/me/spaces/SPACE_NAME/spaceReadState'
  };

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

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

main().catch(console.error);

Để 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.

API Google Chat nhận trạng thái đọc không gian đã chỉ định và trả về một thực thể của SpaceReadState.