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