ใช้งานกิจกรรมจาก 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 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 จะประมวลผลหรือตอบกลับตาม กิจกรรมล่าสุด เช่น การโพสต์ข้อความรายสัปดาห์ที่มีข้อมูลสรุป กิจกรรมการเป็นสมาชิกของ Space ในช่วง 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