ดูรายละเอียดเกี่ยวกับสถานะการอ่านชุดข้อความของผู้ใช้

คู่มือนี้อธิบายวิธีใช้เมธอด get() ในทรัพยากร ThreadReadState ของ Google Chat API เพื่อดูรายละเอียด เกี่ยวกับสถานะการอ่านของผู้ใช้ภายในเธรดข้อความ หากต้องการดูสถานะการอ่านของ ข้อความในพื้นที่ทำงาน โปรดดู ดูรายละเอียดเกี่ยวกับสถานะการอ่านพื้นที่ทำงานของผู้ใช้

ThreadReadStateทรัพยากร เป็นทรัพยากรแบบ Singleton ที่แสดงรายละเอียดเกี่ยวกับข้อความที่อ่านล่าสุดของผู้ใช้ที่ระบุในชุดข้อความของ Google Chat

ข้อกำหนดเบื้องต้น

Node.js

  • บัญชี Google Workspace สำหรับธุรกิจหรือองค์กร ที่มีสิทธิ์เข้าถึง Google Chat

รับสถานะการอ่านชุดข้อความของผู้ใช้ที่โทร

หากต้องการดูรายละเอียดเกี่ยวกับสถานะการอ่านของผู้ใช้ภายในชุดข้อความ ให้ระบุข้อมูลต่อไปนี้ในคำขอ

  • ระบุขอบเขตการให้สิทธิ์ chat.users.readstate หรือ chat.users.readstate.readonly
  • เรียกใช้เมธอด GetThreadReadState() โดยส่งnameของสถานะการอ่านชุดข้อความเพื่อรับข้อมูลซึ่งรวมถึงรหัสผู้ใช้หรือชื่อแทนและรหัสพื้นที่ทำงาน การรับสถานะการอ่านของเธรดรองรับเฉพาะ การรับสถานะการอ่านของผู้ใช้ที่เรียก ซึ่งระบุได้โดย การตั้งค่าอย่างใดอย่างหนึ่งต่อไปนี้
    • อีเมลแทนของ me เช่น users/me/spaces/SPACE/threads/THREAD/threadReadState
    • อีเมล Workspace ของผู้ใช้ที่โทร เช่น users/user@example.com/spaces/SPACE/threads/THREAD/threadReadState
    • รหัสผู้ใช้ของผู้ใช้ที่โทร เช่น users/USER/spaces/SPACE/threads/THREAD/threadReadState

ตัวอย่างต่อไปนี้จะรับสถานะการอ่านเธรดของผู้ใช้ที่เรียกใช้

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);

หากต้องการเรียกใช้ตัวอย่างนี้ ให้แทนที่รายการต่อไปนี้

  • SPACE_NAME: รหัสจากnameของพื้นที่ทำงาน คุณรับรหัสได้โดยเรียกใช้เมธอด ListSpaces() หรือจาก URL ของพื้นที่ทำงาน
  • THREAD_NAME: รหัสจากnameของชุดข้อความ คุณขอรับรหัสได้จากเนื้อหาการตอบกลับที่ส่งคืนหลังจากสร้างข้อความแบบไม่พร้อมกันด้วย Chat API หรือด้วยชื่อที่กำหนดเองที่กำหนดให้กับข้อความตอนสร้าง

Google Chat API จะรับสถานะการอ่านของเธรดที่ระบุและแสดงอินสแตนซ์ของ ThreadReadState