ใช้งานกิจกรรมจาก 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 จะเรียกใช้เมธอด subscriptions.create() ของ Google Workspace Events API เพื่อสมัครรับข้อมูลพื้นที่สำหรับเหตุการณ์การเป็นสมาชิกทุกประเภท หลังจาก สร้างการสมัครใช้บริการแล้ว แอป 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 การจัดการปัญหาใน Codelab สร้างแอปสำหรับ Google Chat ด้วย Gemini