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

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

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

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

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

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

Node.js

  • บัญชี Google Workspace รุ่น Business หรือ Enterprise ที่มีสิทธิ์เข้าถึง 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);
}

main().catch(console.error);

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

  • 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 พร้อมรายละเอียดเกี่ยวกับเหตุการณ์