ดูรายละเอียดเกี่ยวกับกิจกรรมในพื้นที่ใน Google Chat

คู่มือนี้อธิบายวิธีใช้เมธอด get() ในทรัพยากร SpaceEvent ของ Google Chat API เพื่อดูรายละเอียดเกี่ยวกับ กิจกรรมจากพื้นที่ทำงาน Google Chat

SpaceEventทรัพยากร แสดงถึงการเปลี่ยนแปลงในพื้นที่ทำงานหรือทรัพยากรย่อยของพื้นที่ทำงาน เช่น ข้อความ รีแอ็กชัน และการเป็นสมาชิก ดูข้อมูลเกี่ยวกับประเภทเหตุการณ์ที่รองรับได้ที่ฟิลด์ eventType ของเอกสารอ้างอิงSpaceEvent

คุณขอรับกิจกรรมได้ล่วงหน้าสูงสุด 28 วันก่อนเวลาที่ขอ เหตุการณ์ มีทรัพยากรเวอร์ชันล่าสุดที่มีการเปลี่ยนแปลง เช่น หากคุณขอเหตุการณ์เกี่ยวกับข้อความใหม่ แต่ต่อมามีการอัปเดตข้อความ เซิร์ฟเวอร์จะแสดงผลMessageทรัพยากรที่อัปเดตแล้วในเพย์โหลดของเหตุการณ์

หากต้องการเรียกใช้เมธอดนี้ คุณต้องใช้การตรวจสอบสิทธิ์ผู้ใช้ หากต้องการรับกิจกรรม ผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์ต้องเป็นสมาชิกของพื้นที่ที่เกิดกิจกรรม

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

Node.js

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

ดูรายละเอียดเกี่ยวกับกิจกรรมในพื้นที่ทำงาน

หากต้องการดูรายละเอียดเกี่ยวกับกิจกรรมในพื้นที่ใน Google Chat ให้ส่งข้อมูลต่อไปนี้ในคำขอ

  • ระบุขอบเขตการให้สิทธิ์ที่รองรับประเภทเหตุการณ์ในคำขอ แนวทางปฏิบัติแนะนำคือให้เลือกขอบเขตที่จำกัดที่สุดซึ่งยังคงอนุญาตให้แอปทำงานได้
  • เรียกใช้เมธอด GetSpaceEvent() โดยส่ง name ของกิจกรรมในพื้นที่ทำงานที่จะรับ

ตัวอย่างต่อไปนี้จะดึงข้อมูลเหตุการณ์ในพื้นที่ทำงาน

Node.js

chat/client-libraries/cloud/get-space-event-user-cred.js
import {createClientWithUserCredentials} from './authentication-utils.js';

// Replace SCOPE_NAME here with an authorization scope based on the event type
const USER_AUTH_OAUTH_SCOPES = ['SCOPE_NAME'];

// This sample shows how to get space event with user credential
async function main() {
  // Create a client
  const chatClient = await createClientWithUserCredentials(
      USER_AUTH_OAUTH_SCOPES,
  );

  // Initialize request argument(s)
  const request = {
    // Replace SPACE_NAME and SPACE_EVENT_NAME here
    name: 'spaces/SPACE_NAME/spaceEvents/SPACE_EVENT_NAME',
  };

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

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

await main();

หากต้องการเรียกใช้ตัวอย่างนี้ ให้แทนที่รายการต่อไปนี้

  • SCOPE_NAME: ขอบเขตการให้สิทธิ์ตามประเภทเหตุการณ์ เช่น หากคุณได้รับเหตุการณ์ในพื้นที่ทำงาน เกี่ยวกับการเป็นสมาชิกใหม่ ให้ใช้ขอบเขต chat.memberships.readonly ในรูปแบบ https://www.googleapis.com/auth/chat.memberships.readonly คุณดูประเภทเหตุการณ์ได้จากเมธอด ListSpaceEvents() ดูวิธีใช้วิธีนี้ได้ที่ แสดงรายการกิจกรรมจากพื้นที่ทำงาน
  • SPACE_NAME: รหัสจากnameของพื้นที่ทำงาน คุณรับรหัสได้โดยการเรียกใช้เมธอด ListSpaces() หรือจาก URL ของพื้นที่ทำงาน
  • SPACE_EVENT_NAME: รหัสจากnameของกิจกรรมในพื้นที่ทำงาน คุณรับรหัสได้จากเมธอด ListSpaceEvents() ดูวิธีใช้วิธีนี้ได้ที่ แสดงรายการกิจกรรมจากพื้นที่ทำงาน

Chat API จะแสดงอินสแตนซ์ของ SpaceEvent พร้อมรายละเอียดเกี่ยวกับเหตุการณ์