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

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

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

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

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

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

Node.js

• บัญชี Google Workspace Business หรือ Enterprise ที่มีสิทธิ์ใช้งาน Google Chat

• ตั้งค่าสภาพแวดล้อมโดยทำดังนี้
  • สร้างโปรเจ็กต์ Google Cloud
  • กำหนดค่าหน้าจอขอความยินยอม OAuth
  • เปิดใช้และกำหนดค่า Google Chat API ด้วยชื่อ ไอคอน และคำอธิบายสำหรับแอป Chat
  • ติดตั้ง ไลบรารีของไคลเอ็นต์ Cloud สำหรับ Node.js
  • สร้างข้อมูลเข้าสู่ระบบรหัสไคลเอ็นต์ OAuth สำหรับแอปพลิเคชันบนเดสก์ท็อป หากต้องการเรียกใช้ตัวอย่างในคู่มือนี้ ให้บันทึกข้อมูลเข้าสู่ระบบเป็นไฟล์ JSON ชื่อ client_secrets.json ลงในไดเรกทอรีในเครื่อง
  โปรดทําตามขั้นตอนในการตั้งค่าสภาพแวดล้อมในคู่มือเริ่มต้นใช้งานฉบับย่อนี้เพื่อดูคําแนะนํา
• เลือกขอบเขตการให้สิทธิ์ที่รองรับการตรวจสอบสิทธิ์ผู้ใช้

ตัวอย่างโค้ดในหน้านี้ใช้อินเทอร์เฟซ gRPC API กับไลบรารีไคลเอ็นต์ Google Cloud หรือจะใช้อินเทอร์เฟซ REST API ก็ได้ ดูข้อมูลเพิ่มเติมเกี่ยวกับอินเทอร์เฟซ gRPC และ REST ได้ที่ภาพรวมของ Google Chat API

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

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

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

ตัวอย่างต่อไปนี้ได้รับเหตุการณ์ในพื้นที่ทำงาน

Node.js

chat/client-libraries/cloud/get-space-event-user-cred.js

ดูใน GitHub

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

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

• ทำงานกับกิจกรรมจาก Google Chat
• แสดงรายการเหตุการณ์จากพื้นที่ทำงานของ Google Chat