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

คู่มือนี้อธิบายวิธีใช้เมธอด 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