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

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

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

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

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

ทริกเกอร์ไฟล์ Manifest

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

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

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

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

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

ข้อจำกัด

ทริกเกอร์ของไฟล์ Manifest มีข้อจำกัดบางอย่างในการใช้งาน

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