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