อัปเดตสถานะการอ่านพื้นที่ทำงานของผู้ใช้

คู่มือนี้จะอธิบายวิธีใช้เมธอด update() ในทรัพยากร SpaceReadState ของ Google Chat API เพื่อทําเครื่องหมายพื้นที่ใน Chat ว่าอ่านแล้วหรือยังไม่ได้อ่าน

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

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

Node.js

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

อัปเดตสถานะการอ่านพื้นที่ทำงานของผู้ใช้ที่โทร

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

  • ระบุchat.users.readstateขอบเขตการให้สิทธิ์
  • เรียกใช้เมธอด UpdateSpaceReadState()
  • ส่ง updateMask พร้อมค่า lastReadTime
  • ส่ง spaceReadState เป็นอินสแตนซ์ของ SpaceReadState พร้อมข้อมูลต่อไปนี้
    • ฟิลด์ name ที่ตั้งค่าเป็นสถานะอ่านอย่างเดียวของพื้นที่ทำงานเพื่ออัปเดต ซึ่งรวมถึงรหัสผู้ใช้หรืออีเมลแทนและรหัสพื้นที่ทำงาน การอัปเดตสถานะการอ่านในพื้นที่ทำงานจะรองรับเฉพาะการอัปเดตสถานะการอ่านของผู้ใช้ที่โทรเท่านั้น ซึ่งจะระบุได้โดยการตั้งค่าอย่างใดอย่างหนึ่งต่อไปนี้
      • ชื่อแทน me เช่น users/me/spaces/SPACE/spaceReadState
      • อีเมล Workspace ของผู้ใช้ที่โทร เช่น users/user@example.com/spaces/SPACE/spaceReadState
      • รหัสผู้ใช้ของผู้ใช้ที่โทร เช่น users/USER/spaces/SPACE/spaceReadState
    • ฟิลด์ lastReadTime ตั้งค่าเป็นค่าที่อัปเดตแล้วของเวลาที่อัปเดตสถานะการอ่านพื้นที่ทำงานของผู้ใช้ โดยปกติแล้วจะสอดคล้องกับการประทับเวลาของข้อความที่อ่านล่าสุดหรือการประทับเวลาที่ผู้ใช้ระบุเพื่อทำเครื่องหมายตำแหน่งที่อ่านล่าสุดในพื้นที่ทำงาน เมื่อ lastReadTime อยู่ก่อนเวลาสร้างข้อความล่าสุด พื้นที่ทำงานจะปรากฏว่ายังไม่อ่านใน UI หากต้องการทําเครื่องหมายพื้นที่ทํางานว่าอ่านแล้ว ให้ตั้งค่า lastReadTime เป็นค่าใดก็ได้ที่ภายหลัง (มากกว่า) เวลาสร้างข้อความล่าสุด ระบบจะบังคับให้ lastReadTime ตรงกับเวลาที่สร้างข้อความล่าสุด โปรดทราบว่าสถานะการอ่านของพื้นที่ทำงานจะส่งผลต่อสถานะการอ่านของข้อความที่ปรากฏในการสนทนาระดับบนสุดของพื้นที่ทำงานเท่านั้น การตอบกลับในชุดข้อความจะไม่ได้รับผลกระทบจากการประทับเวลานี้ แต่จะอิงตามสถานะการอ่านชุดข้อความแทน

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

Node.js

chat/client-libraries/cloud/update-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'];

// This sample shows how to update a 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 timestamp = new Date('2000-01-01').getTime();
  const request = {
    spaceReadState: {
      // Replace SPACE_NAME here
      name: 'users/me/spaces/SPACE_NAME/spaceReadState',
      lastReadTime: {
        seconds: Math.floor(timestamp / 1000),
        nanos: (timestamp % 1000) * 1000000
      }
    },
    updateMask: {
      // The field paths to update.
      paths: ['last_read_time']
    }
  };

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

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

main().catch(console.error);

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

Google Chat API จะอัปเดตสถานะการอ่านของพื้นที่ทำงานที่ระบุและแสดงผลSpaceReadState อินสแตนซ์