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

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

SpaceReadStateทรัพยากร เป็นทรัพยากรแบบ Singleton ที่แสดงรายละเอียดเกี่ยวกับข้อความที่อ่านล่าสุดของผู้ใช้ที่ ระบุในพื้นที่ทำงานของ 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 ตรงกับเวลาสร้างข้อความล่าสุด โปรดทราบว่าสถานะการอ่านของพื้นที่ทำงานจะมีผลกับสถานะการอ่าน ของข้อความที่มองเห็นได้ในการสนทนาระดับบนสุดของพื้นที่ทำงานเท่านั้น การตอบกลับในชุดข้อความจะไม่ได้รับผลกระทบจากแสตมป์เวลาดังกล่าว แต่จะขึ้นอยู่กับ สถานะการอ่านชุดข้อความแทน

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

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

หัวข้อที่เกี่ยวข้อง

• รับสถานะการอ่านของสเปซของผู้ใช้ที่โทร
• รับสถานะการอ่านเธรดของผู้ใช้ที่โทร