ทรัพยากรไฟล์ 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 ของ Compose

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

string

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

  • NONE ซึ่งเป็นการตั้งค่าเริ่มต้น ซึ่งจะทำให้ออบเจ็กต์เหตุการณ์ ที่ส่งไปยังฟังก์ชันทริกเกอร์การเขียนส่วนใหญ่ ว่างเปล่า
  • METADATA ซึ่งจะสร้างออบเจ็กต์เหตุการณ์ที่ส่งไปยังฟังก์ชันทริกเกอร์การเขียนด้วยรายการผู้รับ ข้อความ การตั้งค่านี้กำหนดให้ส่วนเสริมต้องมี gmail.addons.current.message.metadata ขอบเขต
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 ที่จะเรียกใช้เมื่อเลือกการดำเนินการเขียนนี้ ฟังก์ชันทริกเกอร์ compose นี้จะสร้าง UI ของส่วนเสริม

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

text

string

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