ทรัพยากรไฟล์ 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 ที่เฉพาะเจาะจง ซึ่งโดยปกติจะเป็นการสร้างการ์ดใหม่และอัปเดต 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
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

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