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

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

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

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

Node.js

  • บัญชี Google Workspace รุ่น Business หรือ Enterprise ที่มีสิทธิ์เข้าถึง 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