Package google.apps.script.type.gmail

ดัชนี

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

ComposeTrigger

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

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

DraftAccess

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

Enum
UNSPECIFIED	ค่าเริ่มต้นเมื่อไม่ได้ตั้งค่าสำหรับ draftAccess
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 ปลายทางที่เรียกใช้เมื่อผู้ใช้เรียกการดำเนินการ ดูรายละเอียดได้ในคำแนะนำการดําเนินการแบบรวม