ทรัพยากรไฟล์ Manifest ของ Gmail

การกําหนดค่าทรัพยากรที่ใช้เพื่อกําหนดเนื้อหาและลักษณะการทํางานของส่วนเสริม Google Workspace ใน Gmail ไฟล์ Manifest ของส่วนเสริม Google Workspace ต้องมีคอมโพเนนต์ทั้งหมดที่ทําเครื่องหมายเป็นต้องระบุหากขยายการให้บริการของ Gmail

Gmail

การกําหนดค่าไฟล์ Manifest ของส่วนเสริม Google Workspace สําหรับส่วนขยาย Gmail ดูข้อมูลเพิ่มเติมที่หัวข้อการเพิ่มประสิทธิภาพ Gmail ด้วยส่วนเสริมของ Google Workspace

การแสดง JSON 
{
  "authorizationCheckFunction": string,
  "composeTrigger": {
    object (ComposeTrigger)
  },
  "contextualTriggers": [
    {
      object (ContextualTrigger)
    }
  ],
  "homepageTrigger": {
    object (HomepageTrigger)
  }
}
ช่อง
authorizationCheckFunction

string

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

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

composeTrigger

object (ComposeTrigger)

ต้องระบุสำหรับการดำเนินการเขียน กําหนดชุด UI ที่พร้อมใช้งานสําหรับผู้ใช้ขณะเขียนอีเมล

ดูรายละเอียดได้ที่ การขยาย UI ของเครื่องมือเขียนด้วยการดำเนินการของเครื่องมือเขียน

contextualTriggers[]

object (ContextualTrigger)

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

object (HomepageTrigger)

ข้อกําหนดของฟังก์ชันทริกเกอร์สําหรับการสร้างหน้าแรกของส่วนเสริมในโฮสต์ Gmail ซึ่งจะลบล้าง addOns.common.homepageTrigger

ComposeTrigger

การกําหนดค่าสําหรับการดําเนินการเขียน ดูข้อมูลเพิ่มเติมได้ที่การขยาย UI ของเครื่องมือเขียนอีเมล

การแสดง JSON 
{
  "draftAccess": string,
  "selectActions": [
    {
      object (SelectAction)
    }
  ]
}
ช่อง
draftAccess

string

กําหนดระดับการเข้าถึงข้อมูลที่มีให้สําหรับฟังก์ชันทริกเกอร์การเขียน ตัวเลือกที่ใช้ได้มีดังนี้

  • NONE ซึ่งเป็นการตั้งค่าเริ่มต้น ซึ่งทําให้ออบเจ็กต์เหตุการณ์ที่ส่งไปยังฟังก์ชันทริกเกอร์การคอมไพล์ส่วนใหญ่ว่างเปล่า
  • METADATA ซึ่งจะป้อนข้อมูลออบเจ็กต์เหตุการณ์ที่ส่งไปยังฟังก์ชันทริกเกอร์การเขียนด้วยรายชื่อผู้รับข้อความ การตั้งค่านี้กำหนดให้ส่วนเสริมต้องมี gmail.addons.current.message.metadata scope
selectActions[]

object (SelectAction)

รายการการดำเนินการเขียนอีเมลที่สร้าง UI ของเครื่องมือเขียนอีเมล อย่างไรก็ตาม รายการนี้จำกัดไว้ที่การดำเนินการเดียวต่อส่วนเสริม การดำเนินการเขียนจะมีไอคอนที่เกี่ยวข้องแสดงในหน้าต่างเขียนของ Gmail gmail.logoUrl เป็นตัวกำหนดไอคอน

ContextualTrigger

การกําหนดค่าทริกเกอร์ที่จะทํางานเมื่อผู้ใช้เปิดข้อความ Gmail และข้อความนั้นตรงกับเกณฑ์บางอย่าง ดูข้อมูลเพิ่มเติมได้ที่การขยาย UI ข้อความ

การแสดง JSON 
{
  "onTriggerFunction": string,
  "unconditional": {},
}
ช่อง
onTriggerFunction

string

ต้องระบุสำหรับทริกเกอร์ตามบริบทแต่ละรายการ ชื่อของฟังก์ชัน Apps Script ที่ทำงานเมื่อทริกเกอร์เริ่มทำงาน

ดูรายละเอียดเกี่ยวกับวิธีกําหนดฟังก์ชันนี้ได้ที่ ฟังก์ชันทริกเกอร์ตามบริบท

unconditional

object

ต้องระบุสำหรับทริกเกอร์ตามบริบทแต่ละรายการ ใช้เพื่อระบุว่าทริกเกอร์ตามบริบทจะเปิดใช้งานสําหรับข้อความ Gmail ทั้งหมดเมื่อเปิด ปัจจุบันตัวเลือกนี้มีเพียงตัวเลือกเดียว ดังนั้นออบเจ็กต์นี้ควรเป็นออบเจ็กต์ว่างเสมอ

SelectAction

การกําหนดค่าการดําเนินการเขียนที่กำหนดฟังก์ชันที่จะเรียกใช้เมื่อผู้ใช้เลือกการดําเนินการเขียน

การแสดง JSON 
{
  "runFunction": string,
  "text": string
}
ช่อง
runFunction

string

ต้องระบุสำหรับการดำเนินการเขียน ชื่อฟังก์ชัน Apps Script ที่ทำงานเมื่อเลือกการดำเนินการเขียนนี้ ฟังก์ชันทริกเกอร์การคอมไพล์นี้จะสร้าง UI การคอมไพล์ของส่วนเสริม

ดูรายละเอียดได้ที่ เขียนฟังก์ชันทริกเกอร์

text

string

ต้องระบุสำหรับการดำเนินการเขียน คำอธิบายแบบข้อความสั้นๆ ของการดำเนินการเขียนนี้