หน้านี้อธิบายวิธีที่แอป Google Chat รับและตอบกลับ เหตุการณ์ใน Google Chat
กิจกรรมใน Google Chat แสดงถึงกิจกรรมหรือการเปลี่ยนแปลงใน Chat เช่น ข้อความใหม่ในพื้นที่ทำงาน แอป Chat สามารถใช้ เหตุการณ์เพื่อทำความเข้าใจสิ่งที่เกิดขึ้นและดำเนินการหรือตอบสนองในลักษณะที่มีความหมาย ต่อผู้ใช้
ตัวอย่างวิธีใช้เหตุการณ์มีดังนี้
- ตรวจสอบและตอบกลับข้อความใหม่ในพื้นที่ทำงาน เช่น ตรวจสอบคีย์เวิร์ดหรือวลีสำคัญ
- ส่งข้อความต้อนรับให้ผู้ใช้เมื่อเข้าร่วมพื้นที่เพื่ออธิบายหลักเกณฑ์ของพื้นที่ หรือแชร์เคล็ดลับเกี่ยวกับวิธีใช้แอป Chat อย่างมีประสิทธิภาพ
- ติดตามและวิเคราะห์กิจกรรมใน Chat เช่น ส่งรายงานรายเดือนเกี่ยวกับสมาชิกใหม่หรือข้อความที่ได้รับการรีแอ็กชันหรือคำตอบมากที่สุด
- สื่อสารผ่านแพลตฟอร์มการรับส่งข้อความ เช่น ผู้ใช้สามารถส่ง และรับข้อความจากผู้ใช้ในแพลตฟอร์มการรับส่งข้อความอื่นได้โดยไม่ต้อง ออกจาก Chat
วิธีการทำงานของกิจกรรม
เมื่อใดก็ตามที่มีการดำเนินการใน Google Chat ระบบจะสร้าง อัปเดต หรือลบทรัพยากร Google Chat API Chat ใช้เหตุการณ์เพื่อส่งข้อมูลไปยังแอป Chat เกี่ยวกับประเภทกิจกรรมที่เกิดขึ้นและทรัพยากร Chat API ที่ได้รับผลกระทบ
Messageทรัพยากร
จากนั้นแชทจะสร้างเหตุการณ์ที่มีข้อมูลเกี่ยวกับข้อความใหม่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 |
| แหล่งที่มาของเหตุการณ์ | พื้นที่ทำงานและผู้ใช้ | เฉพาะพื้นที่ทำงาน |
| เหตุการณ์ที่รองรับ |
ดูรายการประเภทกิจกรรมที่รองรับได้ที่ ประเภทกิจกรรมสำหรับการสร้างการสมัครรับข้อมูลใน เอกสารประกอบของ Google Workspace Events API |
ดูรายการประเภทเหตุการณ์ที่รองรับได้ที่ 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