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

ทริกเกอร์ Apps Script จะทำให้ฟังก์ชันสคริปต์ที่ระบุ ( _ฟังก์ชันทริกเกอร์) ทำงานเมื่อใดก็ตามที่เกิดเหตุการณ์ที่ระบุ มีเพียงบางเหตุการณ์เท่านั้นที่ทำให้ทริกเกอร์เริ่มทำงาน และแอปพลิเคชัน Google Workspace แต่ละรายการรองรับเหตุการณ์ที่แตกต่างกัน

เมื่อทริกเกอร์เริ่มทำงาน ระบบจะสร้าง ออบเจ็กต์เหตุการณ์ โครงสร้าง JSON นี้มีรายละเอียดเกี่ยวกับเหตุการณ์ที่เกิดขึ้น ข้อมูลในโครงสร้างออบเจ็กต์เหตุการณ์จะจัดระเบียบแตกต่างกันไปตามประเภททริกเกอร์

เมื่อสร้างออบเจ็กต์เหตุการณ์แล้ว Apps Script จะส่งออบเจ็กต์ดังกล่าวเป็นพารามิเตอร์ไปยังฟังก์ชันทริกเกอร์ ฟังก์ชันทริกเกอร์เป็นฟังก์ชันเรียกกลับที่คุณต้องใช้เองเพื่อดำเนินการที่เหมาะสมเพื่อตอบสนองต่อเหตุการณ์ ตัวอย่างเช่น ในส่วนเสริม Google Workspace ที่ขยายการทำงานของ Gmail คุณสามารถกำหนดทริกเกอร์ที่สร้างอินเทอร์เฟซการ์ดใหม่เมื่อผู้ใช้เปิดชุดข้อความ ในกรณีนี้ คุณจะใช้ฟังก์ชันเรียกกลับตามบริบทเพื่อสร้าง การ์ดที่ประกอบขึ้นเป็น UI ใหม่โดยใช้ข้อมูลที่ส่งใน ออบเจ็กต์เหตุการณ์

หน้านี้มีหลักเกณฑ์เกี่ยวกับการใช้ทริกเกอร์ในโปรเจ็กต์ส่วนเสริม Google Workspace

ทริกเกอร์ Manifest

ส่วนเสริม Google Workspace ไม่สามารถใช้ ทริกเกอร์อย่างง่ายของ Google Apps Script ได้ ซึ่งแตกต่างจากส่วนเสริม Editor แต่จะใช้ทริกเกอร์ที่ออกแบบมาสำหรับส่วนเสริม Google Workspace โดยเฉพาะ นั่นคือ ทริกเกอร์ Manifest

ทริกเกอร์ Manifest กำหนดไว้ใน Manifest ของส่วนเสริม Google Workspace ตัวอย่างเช่น

• ทริกเกอร์หน้าแรก ที่สร้างและแสดงหน้าแรกของส่วนเสริม
• ทริกเกอร์ eventOpen ของ Google ปฏิทิน ที่แสดงการ์ดใหม่หรือดำเนินการอื่นๆ เมื่อมีการเปิดกิจกรรม
• ทริกเกอร์ eventUpdate ของปฏิทิน ที่แสดงการ์ดใหม่หรือดำเนินการอื่นๆ เมื่อผู้ใช้แก้ไขและบันทึกกิจกรรม
• ทริกเกอร์ onItemsSelected ของ Google ไดรฟ์ ที่แสดงการ์ดใหม่หรือดำเนินการอื่นๆ เมื่อผู้ใช้เลือกไฟล์หรือโฟลเดอร์
• ทริกเกอร์การเขียนของ Gmail ที่แสดงการ์ดส่วนเสริมเมื่อผู้ใช้เปิดส่วนเสริมในหน้าต่างเขียน
• ทริกเกอร์ตามบริบทของ Gmail ที่แสดงการ์ดใหม่หรือดำเนินการอื่นๆ เมื่อผู้ใช้เปิดข้อความ
• ทริกเกอร์ onFileScopeGranted ของ Editor ที่แสดงการ์ดใหม่เมื่อผู้ใช้ให้สิทธิ์ขอบเขต OAuth drive.file ในเอกสาร

ในรายการนี้ มีเพียงทริกเกอร์หน้าแรกเท่านั้นที่ไม่ใช่ตามบริบท ส่วนทริกเกอร์อื่นๆ เป็นทริกเกอร์ตามบริบท ดูข้อมูลเพิ่มเติมเกี่ยวกับการกำหนดทริกเกอร์ Manifest ได้ที่ Manifest for

นอกจากทริกเกอร์ Manifest แล้ว ส่วนเสริม Google Workspace ยังใช้ทริกเกอร์ที่ติดตั้งได้ของ Apps Script ได้ด้วย

ข้อจำกัด

ทริกเกอร์ Manifest มีข้อจำกัดบางประการในการใช้งาน

• ทริกเกอร์เหล่านี้ใช้ในโปรเจ็กต์ส่วนเสริม Google Workspace เท่านั้น
• เนื่องจากกำหนดไว้ใน Manifest ของส่วนเสริมและ ไม่ใช่ในโค้ด คุณจึงใช้บริการ Script ของ Apps Script เพื่อสร้างหรือแก้ไขทริกเกอร์เหล่านี้ไม่ได้
• ทริกเกอร์ตามบริบทของ Gmail จะเริ่มทำงานสำหรับข้อความอีเมลทุกข้อความ ไม่ว่าเนื้อหาจะเป็นอย่างไร
• ส่วนเสริมแต่ละรายการจะมีทริกเกอร์แต่ละประเภทได้เพียง 1 รายการต่อผู้ใช้ 1 รายการต่อเอกสาร 1 รายการ