ทริกเกอร์ Apps Script ทําให้เกิดฟังก์ชันสคริปต์ที่ระบุ (ฟังก์ชันทริกเกอร์) เพื่อเรียกใช้เมื่อเหตุการณ์ที่ระบุเกิดขึ้น เฉพาะเหตุการณ์บางอย่างเท่านั้นที่จะทําให้ทริกเกอร์เริ่มทํางานได้ และแอปพลิเคชัน Google Workspace แต่ละรายการจะรองรับชุดเหตุการณ์ที่ต่างกัน
เมื่อทริกเกอร์เริ่มทํางาน ระบบจะสร้างออบเจ็กต์เหตุการณ์ โครงสร้าง JSON นี้มีรายละเอียดเกี่ยวกับเหตุการณ์ที่เกิดขึ้น ข้อมูลในโครงสร้างออบเจ็กต์เหตุการณ์จะจัดระเบียบแตกต่างกันไปตามประเภททริกเกอร์
เมื่อสร้างออบเจ็กต์เหตุการณ์แล้ว Apps Script จะส่งออบเจ็กต์ดังกล่าวเป็นพารามิเตอร์ไปยังฟังก์ชันทริกเกอร์ ฟังก์ชันทริกเกอร์เป็นฟังก์ชันเรียกกลับที่คุณ ต้องนําไปใช้งานเองเพื่อดําเนินการต่างๆ ที่เหมาะสมเพื่อตอบสนองต่อเหตุการณ์ เช่น ในส่วนเสริม Google Workspace ที่ขยาย Gmail คุณจะกําหนดทริกเกอร์ที่สร้างอินเทอร์เฟซการ์ดใหม่เมื่อผู้ใช้เปิดชุดข้อความได้ ในกรณีนี้ ให้ใช้ฟังก์ชันเรียกกลับตามบริบทเพื่อสร้างการ์ดที่สร้าง UI ใหม่โดยใช้ข้อมูลที่ส่งในออบเจ็กต์เหตุการณ์
หน้านี้มีหลักเกณฑ์ในการใช้ทริกเกอร์ในโปรเจ็กต์ส่วนเสริมของ Google Workspace
ทริกเกอร์ไฟล์ Manifest
ปัจจุบันส่วนเสริมของ Google Workspace ต่างจากส่วนเสริมของทริกเกอร์ซึ่งต่างจากส่วนเสริมของเครื่องมือแก้ไข ซึ่งจะใช้ทริกเกอร์ที่ออกแบบมาสําหรับส่วนเสริมของ Google Workspace โดยเฉพาะได้: ทริกเกอร์ไฟล์ Manifest
ระบบจะกําหนดทริกเกอร์ไฟล์ Manifest ไว้ในไฟล์ Manifest ของส่วนเสริม Google Workspace โดยสมบูรณ์ ตัวอย่างทริกเกอร์ไฟล์ Manifest มีดังนี้
- ทริกเกอร์หน้าแรกที่สร้างและแสดงหน้าแรกของส่วนเสริม
- ทริกเกอร์ EventOpen ที่แสดงการ์ดใหม่หรือ ดําเนินการอื่นๆ เมื่อผู้ใช้เปิดกิจกรรมในปฏิทินไว้
- ทริกเกอร์ eventUpdate ของปฏิทินที่แสดงการ์ดใหม่หรือดําเนินการอื่นๆ เมื่อผู้ใช้แก้ไขและบันทึกกิจกรรมในปฏิทิน
- ทริกเกอร์ onItemsSelected ของไดรฟ์ที่แสดงการ์ดใหม่หรือดําเนินการอื่นๆ เมื่อผู้ใช้เลือกไฟล์หรือโฟลเดอร์อย่างน้อย 1 รายการในไดรฟ์
- ทริกเกอร์การเขียน Gmail ที่แสดงการ์ดส่วนเสริมเมื่อผู้ใช้เปิดส่วนเสริมในหน้าต่างเขียน Gmail
- ทริกเกอร์ตามบริบทของ Gmail ที่แสดงการ์ดใหม่หรือดําเนินการอื่นๆ เมื่อผู้ใช้เปิดข้อความ Gmail
- ทริกเกอร์ onFileScopeGranted ที่แสดงการ์ดใหม่เมื่อผู้ใช้ให้สิทธิ์สําหรับขอบเขต OAuth ของ
drive.file
ในเอกสาร Editor ปัจจุบัน
ในรายการด้านบน จะมีเฉพาะทริกเกอร์หน้าแรกที่ไม่ใช่บริบท ส่วนที่เหลือเป็นทริกเกอร์ตามบริบท ดูข้อมูลเพิ่มเติมเกี่ยวกับคําจํากัดความของทริกเกอร์ไฟล์ Manifest ที่ไฟล์ Manifest
นอกเหนือจากทริกเกอร์ไฟล์ Manifest ส่วนเสริมของ Google Workspace จะใช้ทริกเกอร์ที่ติดตั้งของ Apps Script ได้ด้วย
ข้อจำกัด
ทริกเกอร์ไฟล์ Manifest มีข้อจํากัดบางประการในการใช้งาน
- ทริกเกอร์เหล่านี้ใช้ในโปรเจ็กต์ส่วนเสริมของ Google Workspace เท่านั้น ไม่มีวัตถุประสงค์ในแอปพลิเคชันอื่น
- เนื่องจากเป็นตัวระบุในไฟล์ Manifest ของส่วนเสริม ไม่ใช่ในโค้ด คุณจึงใช้บริการ Apps Script
Script
เพื่อสร้างหรือแก้ไขทริกเกอร์เหล่านี้ไม่ได้ - ขณะนี้ทริกเกอร์ตามบริบทของ Gmail มีเกณฑ์ได้เพียง
unconditional
รายการเท่านั้น ซึ่งหมายความว่าทริกเกอร์ตามบริบทจะเริ่มทํางานสําหรับข้อความอีเมลทั้งหมด ไม่ว่าเนื้อหาจะเป็นอย่างไร