ทรัพยากรไฟล์ 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 ขอบเขต
selectActions[]

object (SelectAction)

รายการการดำเนินการเขียนที่สร้าง UI ในการเขียน อย่างไรก็ตาม รายการนี้จำกัดไว้ที่การดำเนินการ 1 รายการต่อส่วนเสริม การดำเนินการเขียนจะมีไอคอนที่สอดคล้องกันแสดงอยู่ในหน้าต่างเขียนของ 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 การเขียนของส่วนเสริม

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

text

string

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