ใช้งานกิจกรรมจาก Google Chat

หน้านี้จะอธิบายวิธีที่แอป Google Chat รับและตอบสนองต่อเหตุการณ์ใน Google Chat

กิจกรรม Google Chat แสดงถึงกิจกรรมหรือการเปลี่ยนแปลงใน Chat เช่น ข้อความใหม่ในพื้นที่ทำงาน แอป Chat สามารถใช้เหตุการณ์เพื่อทำความเข้าใจสิ่งที่เกิดขึ้นและดำเนินการหรือตอบกลับในลักษณะที่เป็นประโยชน์ต่อผู้ใช้

ตัวอย่างวิธีใช้เหตุการณ์มีดังนี้

• ตรวจสอบและตอบกลับข้อความใหม่ในพื้นที่ทำงาน เช่น ตรวจสอบคีย์เวิร์ดหรือวลี
• ส่งข้อความต้อนรับให้ผู้ใช้เมื่อเข้าร่วมพื้นที่ทำงาน เพื่ออธิบายหลักเกณฑ์ของพื้นที่ทำงานหรือแชร์เคล็ดลับเกี่ยวกับวิธีใช้แอป Chat อย่างมีประสิทธิภาพ
• ติดตามและวิเคราะห์กิจกรรมใน Chat เช่น หากต้องการส่งรายงานรายเดือนเกี่ยวกับสมาชิกใหม่หรือข้อความที่ได้รับการรีแอ็กชันหรือตอบกลับมากที่สุด
• สื่อสารในแพลตฟอร์มการรับส่งข้อความต่างๆ เช่น ผู้ใช้สามารถส่งและรับข้อความจากผู้ใช้ในแพลตฟอร์มการรับส่งข้อความอื่นได้โดยไม่ต้องออกจาก Chat

วิธีการทํางานของเหตุการณ์

เมื่อเกิดเหตุการณ์บางอย่างใน Google Chat ระบบจะสร้าง อัปเดต หรือลบทรัพยากร Google Chat API Chat ใช้เหตุการณ์เพื่อส่งข้อมูลไปยังแอป Chat เกี่ยวกับประเภทกิจกรรมที่เกิดขึ้นและแหล่งข้อมูล Chat API ที่ได้รับผลกระทบ

Chat จะจัดหมวดหมู่เหตุการณ์ตามประเภท ประเภทเหตุการณ์ช่วยให้คุณกรองและรับเฉพาะประเภทข้อมูลที่จําเป็น และช่วยให้คุณจัดการกิจกรรมที่คล้ายกันในลักษณะเดียวกัน

ตารางต่อไปนี้แสดงวิธีที่กิจกรรมใน Chat ส่งผลต่อทรัพยากร Chat API ที่เกี่ยวข้อง และประเภทเหตุการณ์ที่แอป Chat ของคุณได้รับ

กิจกรรม	ทรัพยากร Chat API	ประเภทของกิจกรรม
ผู้ใช้โพสต์ข้อความในพื้นที่ใน Chat	สร้างทรัพยากร Message แล้ว	ข้อความใหม่
ผู้ใช้กลายเป็นผู้จัดการพื้นที่ทำงาน	อัปเดตทรัพยากร Membership แล้ว	การเป็นสมาชิกที่อัปเดตแล้ว
ผู้ใช้แสดงความรู้สึกต่อข้อความ	สร้างทรัพยากร Reaction แล้ว	รีแอ็กชันใหม่
ผู้ใช้ออกจากพื้นที่ทำงาน	ลบทรัพยากร Membership	การเป็นสมาชิกที่ลบแล้ว

รับเหตุการณ์จาก Google Chat

หากต้องการรับเหตุการณ์ แอป Chat จะทำอย่างใดอย่างหนึ่งต่อไปนี้

• สมัครรับข้อมูลกิจกรรมโดยใช้ Google Workspace Events API เพื่อรับเหตุการณ์ในขณะที่เกิดขึ้น
• ค้นหาเหตุการณ์ล่าสุดโดยการเรียกใช้ Chat API

ตารางต่อไปนี้อธิบายความแตกต่างและเหตุผลในการค้นหาหรือการติดตามเหตุการณ์

	สมัครรับข้อมูลเหตุการณ์	ค้นหาเหตุการณ์
กรณีการใช้งาน	ประมวลผลหรือตอบสนองต่อเหตุการณ์แบบเรียลไทม์ ตรวจสอบกิจกรรมการเป็นสมาชิกของผู้ใช้และค้นพบพื้นที่ทำงานใหม่ที่จะตรวจสอบ	ประมวลผลหรือตอบสนองต่อเหตุการณ์เป็นระยะๆ หรือผ่านทริกเกอร์ ดึงข้อมูลเหตุการณ์ที่พลาดไปจากการสมัครใช้บริการ (เนื่องจากการหยุดทำงานหรือการสมัครใช้บริการที่ไม่มีการใช้งาน)
API	Google Workspace Events API	Chat API
แหล่งที่มาของเหตุการณ์	พื้นที่ทำงานและผู้ใช้	พื้นที่ทำงานเท่านั้น
เหตุการณ์ที่รองรับ	ข้อความ การเป็นสมาชิก รีแอ็กชัน Space ดูรายการประเภทเหตุการณ์ที่รองรับได้ที่ ประเภทเหตุการณ์สำหรับการสร้างการสมัครใช้บริการในเอกสารประกอบ Google Workspace Events API	ข้อความ การเป็นสมาชิก รีแอ็กชัน Space ดูรายการประเภทเหตุการณ์ที่รองรับได้ใน spaceEventsแหล่งข้อมูลในเอกสารอ้างอิง Chat API
รูปแบบกิจกรรม	ข้อความ Google Cloud Pub/Sub ที่จัดรูปแบบตามข้อกำหนดของ CloudEvent โปรดดูรายละเอียดที่หัวข้อโครงสร้างของกิจกรรม Google Workspace	ทรัพยากร Chat API ( spaces.spaceEvent)
ข้อมูลเหตุการณ์	สตริงที่เข้ารหัส Base64 ที่มีหรือไม่มีข้อมูลทรัพยากร โปรดดูตัวอย่างเพย์โหลดที่หัวข้อข้อมูลเหตุการณ์	เพย์โหลด JSON ที่มีข้อมูลทรัพยากร เหตุการณ์บางประเภทจะมีเฉพาะฟิลด์แหล่งข้อมูลบางฟิลด์เท่านั้น ดูตัวอย่างเพย์โหลดได้ที่ เอกสารอ้างอิง

ตัวอย่าง: ค้นหาหรือติดตามเหตุการณ์เกี่ยวกับการเป็นสมาชิกในพื้นที่ทำงาน

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

• ผู้ใช้เข้าร่วมพื้นที่ทำงาน ซึ่งจะสร้างทรัพยากร Membership และทริกเกอร์เหตุการณ์สมาชิกใหม่
• ผู้ใช้กลายเป็นผู้จัดการพื้นที่ทำงาน ซึ่งจะอัปเดตทรัพยากร Membership ให้กับผู้ใช้และทริกเกอร์เหตุการณ์สมาชิกที่อัปเดต
• ผู้ใช้ออกจากพื้นที่ทำงาน ซึ่งจะลบทรัพยากร Membership ของผู้ใช้และทริกเกอร์เหตุการณ์ "สมาชิกถูกลบ"

สมัครรับข้อมูลกิจกรรมการเป็นสมาชิก

หากต้องการรับเหตุการณ์แบบเรียลไทม์ แอป Chat จะเรียกใช้เมธอด Google Workspace Events APIsubscriptions.create()เพื่อสมัครรับข้อมูลพื้นที่ทำงานสำหรับกิจกรรมการเป็นสมาชิกทุกประเภท หลังจากสร้างการสมัครใช้บริการแล้ว แอป Chat จะเริ่มรับเหตุการณ์การเป็นสมาชิก

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

ดูข้อมูลเกี่ยวกับการสร้างการสมัครใช้บริการโดยใช้ Google Workspace Events API ได้ที่เอกสารประกอบของ Google Workspace Events API

ค้นหากิจกรรมการเป็นสมาชิกล่าสุด

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

ในรูปที่ 3 แอป Chat จะเรียกใช้เมธอด Chat API spaces.spaceEvents.list() หลังจากกิจกรรมการเป็นสมาชิกทั้งหมดเกิดขึ้นแล้ว และกรองการค้นหาเพื่อหาเหตุการณ์การเป็นสมาชิกใหม่ อัปเดต และลบ Chat API จะแสดงรายการทรัพยากร spaceEvent ที่แสดงการเปลี่ยนแปลงการเป็นสมาชิกแต่ละรายการ จากนั้นแอป Chat จะประมวลผลหรือตอบกลับตามกิจกรรมล่าสุด เช่น โพสต์ข้อความรายสัปดาห์พร้อมสรุปกิจกรรมการเป็นสมาชิกของพื้นที่ทำงานในช่วง 7 วันที่ผ่านมา

หากต้องการค้นหาเหตุการณ์โดยใช้ Chat API โปรดดูหัวข้อแสดงเหตุการณ์จากพื้นที่ทำงาน Google Chat

ข้อจำกัด

• สำหรับการติดตามผู้ใช้ เหตุการณ์เกี่ยวกับสมาชิกใหม่ในข้อความส่วนตัวหรือแชทเป็นกลุ่มที่ไม่มีชื่อ (google.workspace.chat.membership.v1.created) จะทริกเกอร์หลังจากมีการโพสต์ข้อความแรกเท่านั้น
• หากต้องการรับกิจกรรมการเป็นสมาชิก ผู้ใช้ต้องเป็นสมาชิกโดยตรงของพื้นที่ทำงาน หากมีการเพิ่ม อัปเดต หรือนำผู้ใช้ออกจากพื้นที่ทำงานผ่าน Google Group โดยอ้อม การสมัครใช้บริการจะไม่ได้รับการแจ้งเตือนกิจกรรมการเป็นสมาชิกเหล่านั้น หากต้องการทำความเข้าใจวิธีการทำงานของการเป็นสมาชิก Google Group โปรดดูหัวข้อเพิ่ม Google Group ในพื้นที่ทำงาน

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

• ภาพรวมของ Google Workspace Events API
• สร้างการสมัครใช้บริการ
• ดูรายละเอียดเกี่ยวกับกิจกรรมในพื้นที่ทำงานของ Google Chat
• แสดงรายการเหตุการณ์จากพื้นที่ทำงานของ Google Chat
• ดูตัวอย่างวิธีใช้เหตุการณ์ได้ในบทแนะนำตอบคำถามโดยอิงตามการสนทนาใน Chat ด้วย AI ของ Gemini แอป Chat หรือฟีเจอร์ความช่วยเหลือที่ครอบคลุมของการจัดการปัญหาใน แอป Chat ในโค้ดแล็บสร้างแอปสำหรับ Google Chat ด้วย Gemini