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

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

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

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

Node.js

  • บัญชี Google Workspace สำหรับธุรกิจหรือ 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);
}

await main();

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

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