Package google.apps.script.type.gmail

ดัชนี

• ComposeTrigger (ข้อความ)
• ComposeTrigger.DraftAccess (enum)
• ContextualTrigger (ข้อความ)
• GmailAddOnManifest (ข้อความ)
• UnconditionalTrigger (ข้อความ)
• UniversalAction (ข้อความ)

ComposeTrigger

ทริกเกอร์ที่เปิดใช้งานเมื่อผู้ใช้เขียนอีเมล

ช่อง
actions[]	MenuItemExtensionPoint กำหนดชุดการดำเนินการสำหรับส่วนเสริมเวลาในการเขียน ต่อไปนี้เป็นการดำเนินการที่ผู้ใช้ทริกเกอร์ในส่วนเสริมเวลาในการเขียนได้
draftAccess	DraftAccess กำหนดระดับการเข้าถึงข้อมูลเมื่อมีการทริกเกอร์ส่วนเสริมเวลาในการเขียน

DraftAccess

Enum ที่กำหนดระดับการเข้าถึงข้อมูลที่ทริกเกอร์การเขียนจำเป็นต้องใช้

Enum
UNSPECIFIED	ค่าเริ่มต้นเมื่อไม่ได้ตั้งค่าข้อความร่างการเข้าถึงไว้
NONE	ทริกเกอร์การเขียนไม่สามารถเข้าถึงข้อมูลของฉบับร่างได้เมื่อส่วนเสริมการเขียนถูกเรียกใช้
METADATA	ให้สิทธิ์ทริกเกอร์การเขียนในการเข้าถึงข้อมูลเมตาของฉบับร่าง เมื่อมีการทริกเกอร์ส่วนเสริมการเขียน ซึ่งรวมถึงรายการกลุ่มเป้าหมาย เช่น รายการ "ถึง" และ "สำเนา" ของข้อความร่าง

ContextualTrigger

กำหนดทริกเกอร์ที่จะเริ่มทำงานเมื่ออีเมลที่เปิดอยู่ตรงตามเกณฑ์ที่เจาะจง เมื่อทริกเกอร์เริ่มทำงาน ทริกเกอร์จะเรียกใช้ปลายทางที่เฉพาะเจาะจง โดยทั่วไปจะใช้เพื่อสร้างการ์ดใหม่และอัปเดต UI

ช่อง
onTriggerFunction	string ต้องระบุ ชื่อของปลายทางที่จะเรียกใช้เมื่อข้อความตรงกับทริกเกอร์
ฟิลด์การรวม trigger ประเภทของทริกเกอร์จะกำหนดเงื่อนไขที่ Gmail ใช้เพื่อแสดงส่วนเสริม trigger ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
unconditional	UnconditionalTrigger ทริกเกอร์ที่ไม่มีเงื่อนไขจะทำงานเมื่อมีการเปิดข้อความอีเมล

GmailAddOnManifest

พร็อพเพอร์ตี้ที่จะปรับแต่งรูปลักษณ์และการใช้งานส่วนเสริม Gmail

ช่อง
homepageTrigger	HomepageExtensionPoint กำหนดปลายทางที่จะดำเนินการในบริบทที่ไม่ตรงกับทริกเกอร์ตามบริบทที่ประกาศไว้ การ์ดใดก็ตามที่ฟังก์ชันนี้สร้างจะพร้อมใช้งานสำหรับผู้ใช้เสมอ แต่อาจถูกบดบังด้วยเนื้อหาตามบริบทเมื่อส่วนเสริมนี้ประกาศทริกเกอร์ที่ตรงเป้าหมายมากกว่า หากมี จะลบล้างการกำหนดค่าจาก addOns.common.homepageTrigger
contextualTriggers[]	ContextualTrigger กำหนดชุดเงื่อนไขที่ทริกเกอร์ส่วนเสริม
universalActions[]	UniversalAction กำหนดชุดการทำงานส่วนกลางสำหรับส่วนเสริม ผู้ใช้จะทริกเกอร์การดำเนินการทั่วไปจากเมนูแถบเครื่องมือของส่วนเสริม
composeTrigger	ComposeTrigger กำหนดทริกเกอร์เวลาเขียนสำหรับส่วนเสริมเวลาเขียน ซึ่งเป็นทริกเกอร์ที่ทำให้ส่วนเสริมดำเนินการเมื่อผู้ใช้เขียนอีเมล ส่วนเสริมเวลาในการเขียนทั้งหมดต้องมีขอบเขต gmail.addons.current.action.compose แม้ว่าอาจแก้ไขฉบับร่างไม่ได้ก็ตาม
authorizationCheckFunction	string ชื่อของปลายทางที่ยืนยันว่าส่วนเสริมมีสิทธิ์ของบุคคลที่สามที่จําเป็นทั้งหมด โดยการตรวจสอบ API ของบุคคลที่สาม หากการตรวจสอบล้มเหลว ฟังก์ชันควรมีข้อยกเว้นเพื่อเริ่มต้นกระบวนการให้สิทธิ์ ระบบจะเรียกใช้ฟังก์ชันนี้ก่อนการเรียกใช้ส่วนเสริมแต่ละครั้งเพื่อให้ผู้ใช้ได้รับประสบการณ์การใช้งานที่ราบรื่น

UnconditionalTrigger

ประเภทนี้ไม่มีช่อง

ทริกเกอร์ที่จะเริ่มทำงานเมื่อมีการเปิดข้อความอีเมล

UniversalAction

การดำเนินการที่ใช้ได้ในเมนูแถบเครื่องมือของส่วนเสริมเสมอ โดยไม่คำนึงถึงบริบทของข้อความ

ช่อง
text	string ต้องระบุ ข้อความที่ผู้ใช้มองเห็นได้ซึ่งอธิบายการดำเนินการ เช่น "เพิ่มรายชื่อติดต่อใหม่"
ฟิลด์การรวม action_type ประเภทของการดำเนินการจะเป็นตัวกำหนดลักษณะการทำงานของ Gmail เมื่อผู้ใช้เรียกใช้การทำงาน action_type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
openLink	string ลิงก์ที่ Gmail เปิดเมื่อผู้ใช้เรียกใช้การดำเนินการ
runFunction	string ปลายทางที่จะเรียกใช้เมื่อผู้ใช้ทริกเกอร์การดำเนินการ ดูรายละเอียดได้ที่คู่มือการดําเนินการสําหรับสากล