คู่มือนี้จะอธิบายถึงวิธีใช้
get()
ในทรัพยากร SpaceEvent
ของ Google Chat API เพื่อรับรายละเอียดเกี่ยวกับ
กิจกรรมจากพื้นที่ใน Google Chat
แหล่งข้อมูล SpaceEvent
รายการ
แสดงการเปลี่ยนแปลงในพื้นที่ทำงานหรือทรัพยากรย่อย เช่น ข้อความ
รีแอ็กชันและการเป็นสมาชิก ดูข้อมูลเกี่ยวกับประเภทเหตุการณ์ที่รองรับได้ที่
ช่อง eventType
ของแหล่งข้อมูล SpaceEvent
เอกสารอ้างอิง
คุณขอกิจกรรมได้สูงสุด 28 วันก่อนเวลาที่ขอ เหตุการณ์จะมีทรัพยากรเวอร์ชันล่าสุดที่มีการเปลี่ยนแปลง ตัวอย่างเช่น หาก
คุณขอกิจกรรมเกี่ยวกับข้อความใหม่ แต่ข้อความได้รับการอัปเดตในภายหลัง
เซิร์ฟเวอร์ส่งทรัพยากร Message
ที่อัปเดตแล้วในเพย์โหลดของเหตุการณ์
หากต้องการเรียกใช้เมธอดนี้ คุณต้องใช้การตรวจสอบสิทธิ์ผู้ใช้ หากต้องการดูกิจกรรม ผู้ใช้ที่ตรวจสอบสิทธิ์แล้วต้องเป็นสมาชิกของสเปซที่เกิดเหตุการณ์
ข้อกำหนดเบื้องต้น
Node.js
- ธุรกิจหรือองค์กร บัญชี Google Workspace ที่มีสิทธิ์เข้าถึง Google Chat
- ตั้งค่าสภาพแวดล้อมโดยทำดังนี้
- สร้างโปรเจ็กต์ Google Cloud
- กำหนดค่าหน้าจอขอความยินยอม OAuth
- เปิดใช้และกําหนดค่า Google Chat API พร้อมตั้งชื่อ ไอคอน และคําอธิบายสําหรับแอป Chat
- ติดตั้ง Node.js ไลบรารีของไคลเอ็นต์ระบบคลาวด์
-
สร้างข้อมูลเข้าสู่ระบบรหัสไคลเอ็นต์ OAuth สําหรับแอปพลิเคชันบนเดสก์ท็อป หากต้องการเรียกใช้ตัวอย่างในคู่มือนี้ ให้บันทึกข้อมูลเข้าสู่ระบบเป็นไฟล์ JSON ชื่อ
client_secrets.json
ลงในไดเรกทอรีในเครื่อง
- เลือกขอบเขตการให้สิทธิ์ที่รองรับการตรวจสอบสิทธิ์ผู้ใช้
ดูรายละเอียดเกี่ยวกับกิจกรรมในพื้นที่ทำงาน
หากต้องการดูรายละเอียดเกี่ยวกับกิจกรรมในพื้นที่ใน Google Chat ให้ส่งข้อมูลต่อไปนี้ในคำขอ
- ระบุขอบเขตการให้สิทธิ์ที่รองรับประเภทเหตุการณ์ในคําขอ แนวทางปฏิบัติแนะนำคือ เลือกขอบเขตที่จำกัดที่สุดซึ่งยังคง ที่จะทำงาน
- เรียกใช้
GetSpaceEvent()
โดยส่งname
ของเหตุการณ์พื้นที่ทำงานเพื่อรับ
ตัวอย่างต่อไปนี้ได้รับเหตุการณ์ในพื้นที่ทำงาน
Node.js
หากต้องการเรียกใช้ตัวอย่างนี้ ให้แทนที่ข้อมูลต่อไปนี้
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
พร้อมรายละเอียดเกี่ยวกับกิจกรรม