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

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

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

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

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

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

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

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

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

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

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

ข้อจำกัด

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

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