ทริกเกอร์สําหรับส่วนเสริมของ Google Workspace

ทริกเกอร์ 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 รายการเท่านั้น ซึ่งหมายความว่าทริกเกอร์ตามบริบทจะเริ่มทํางานสําหรับข้อความอีเมลทั้งหมด ไม่ว่าเนื้อหาจะเป็นอย่างไร