หน้านี้จะอธิบายวิธีที่แอป Google Chat รับและตอบสนองต่อกิจกรรมใน Google Chat
กิจกรรม Google Chat แสดงถึงกิจกรรมหรือการเปลี่ยนแปลงใน Chat เช่น ข้อความใหม่ในพื้นที่ทำงาน แอป Chat สามารถใช้เหตุการณ์เพื่อทำความเข้าใจสิ่งที่เกิดขึ้น แล้วดำเนินการ หรือตอบสนองในเชิงที่มีความหมายต่อผู้ใช้
ต่อไปนี้คือตัวอย่างวิธีการใช้เหตุการณ์
- ตรวจสอบและตอบกลับข้อความใหม่ๆ ในพื้นที่ทำงาน เช่น การตรวจหาคำหรือวลีสำคัญ
- ส่งข้อความต้อนรับถึงผู้ใช้เมื่อเข้าร่วมพื้นที่ทำงาน เพื่ออธิบายหลักเกณฑ์ของพื้นที่ทำงาน หรือแชร์เคล็ดลับเกี่ยวกับวิธีใช้แอป Chat อย่างมีประสิทธิภาพ
- ติดตามและวิเคราะห์กิจกรรมใน Chat เช่น การส่งรายงานประจำเดือนเกี่ยวกับสมาชิกใหม่หรือข้อความที่ได้รับรีแอ็กชันหรือการตอบกลับมากที่สุด
- สื่อสารข้ามแพลตฟอร์มการรับส่งข้อความ เช่น ผู้ใช้จะส่งและรับข้อความจากผู้ใช้จากแพลตฟอร์มการรับส่งข้อความอื่นได้โดยไม่ต้องออกจาก Chat
วิธีการทำงานของกิจกรรม
เมื่อใดก็ตามที่เกิดอะไรขึ้นใน Google Chat ระบบจะสร้าง อัปเดต หรือลบทรัพยากรของ Google Chat API โดยเหตุการณ์จะแสดงข้อมูลเกี่ยวกับเวลาของกิจกรรมและทรัพยากรของ Chat API ที่ได้รับผลกระทบ
Chat จะจัดหมวดหมู่เหตุการณ์ตามประเภท ประเภทเหตุการณ์ช่วยให้คุณกรองและขอเฉพาะข้อมูลประเภทที่คุณต้องการ และให้คุณจัดการเหตุการณ์ที่คล้ายกันได้ในลักษณะเดียวกัน
ตารางต่อไปนี้แสดงผลกระทบที่กิจกรรมใน Chat มีต่อทรัพยากรของ Chat API ที่เกี่ยวข้องและประเภทเหตุการณ์ที่แอป Chat ได้รับ
| กิจกรรม | แหล่งข้อมูล Chat API | ประเภทเหตุการณ์ |
|---|---|---|
ผู้ใช้โพสต์ข้อความในพื้นที่ทำงาน Chat |
สร้างทรัพยากร Message แล้ว |
ข้อความใหม่ |
| ผู้ใช้จะเป็นผู้จัดการพื้นที่ทำงาน | อัปเดตทรัพยากร Membership แล้ว |
อัปเดตการเป็นสมาชิกแล้ว |
| ผู้ใช้แสดงความรู้สึกต่อข้อความ | สร้างทรัพยากร Reaction แล้ว |
ความรู้สึกใหม่ |
| ผู้ใช้ออกจากพื้นที่ทำงาน | ลบทรัพยากร Membership แล้ว |
ลบการเป็นสมาชิกแล้ว |
รับกิจกรรมจาก Google Chat
หากต้องการรับกิจกรรม แอป Chat จะดำเนินการอย่างใดอย่างหนึ่งต่อไปนี้
- สมัครรับข้อมูลกิจกรรมโดยใช้ Google Workspace Events API เพื่อรับกิจกรรมที่จัดขึ้น
- ค้นหาเหตุการณ์โดยการเรียกใช้ Chat API
Google Workspace Events API และ Chat API รองรับและแสดงเหตุการณ์ประเภทเดียวกัน โปรดตรวจสอบตารางต่อไปนี้เพื่อให้ทราบว่าคุณควรติดตามหรือค้นหาเหตุการณ์หรือไม่
| สมัครรับข้อมูลกิจกรรม | ค้นหากิจกรรม | |
|---|---|---|
| Use Case |
|
|
| API | Google Workspace Events API | Chat API |
| แหล่งที่มาของเหตุการณ์ | พื้นที่ทำงานและผู้ใช้ | พื้นที่ทำงานเท่านั้น |
| รูปแบบกิจกรรม | ข้อความ Google Cloud Pub/Sub ที่มีการจัดรูปแบบตามข้อกำหนดของ CloudEvent โปรดดูรายละเอียดที่หัวข้อโครงสร้างของกิจกรรมใน Google Workspace |
ทรัพยากรของ Chat API
(
spaces.spaceEvent)
|
| ข้อมูลเหตุการณ์ | สตริงที่เข้ารหัสแบบ Base64 โดยมีหรือไม่มีข้อมูลทรัพยากร ตัวอย่างเช่น เพย์โหลด โปรดดูข้อมูลเหตุการณ์ | เพย์โหลด JSON ที่มีข้อมูลทรัพยากร เหตุการณ์บางประเภทจะรวมช่องทรัพยากรบางช่องเท่านั้น โปรดดูตัวอย่างเพย์โหลดในเอกสารประกอบอ้างอิงของ SpaceEvents |
หากต้องการดูข้อมูลเกี่ยวกับการสร้างการสมัครใช้บริการโดยใช้ Google Workspace Events API โปรดดูเอกสารประกอบเกี่ยวกับ Google Workspace Events API หากต้องการค้นหาเหตุการณ์โดยใช้ Chat API โปรดดูคำแนะนำต่อไปนี้
ข้อจำกัด
-
สำหรับการสมัครรับข้อมูลจากผู้ใช้ กิจกรรมเกี่ยวกับสมาชิกใหม่ในข้อความส่วนตัวหรือแชทเป็นกลุ่มที่ไม่มีชื่อ (
google.workspace.chat.membership.v1.created) จะเริ่มขึ้นหลังจากโพสต์ข้อความแรกแล้วเท่านั้น - การเปลี่ยนแปลงประวัติพื้นที่ทำงานจะไม่ทริกเกอร์กิจกรรมในพื้นที่ทำงานที่อัปเดต (ประเภทเหตุการณ์:
google.workspace.chat.spaces.v1.updated) - หากต้องการรับกิจกรรมการเป็นสมาชิก ผู้ใช้ต้องเป็นสมาชิกโดยตรงของพื้นที่ทำงาน หากมีการเพิ่ม อัปเดต หรือนำผู้ใช้ออกจากพื้นที่ทำงานโดยอ้อมผ่าน Google Group การสมัครใช้บริการจะไม่ได้รับกิจกรรมการเป็นสมาชิกเหล่านั้น หากต้องการทำความเข้าใจวิธีการทำงานของการเป็นสมาชิกกลุ่มของ Google โปรดดู เพิ่ม Google Group ในพื้นที่ทำงาน