ทรัพยากรไฟล์ Manifest ของส่วนเสริม

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

AddOns

ระดับบนสุดของการกำหนดค่าไฟล์ Manifest ของส่วนเสริม Google Workspace

การแสดง JSON 
{
  "common": {
    object (Common)
  },
  "calendar": {
    object (Calendar)
  },
  "drive": {
    object (Drive)
  },
  "gmail": {
    object (Gmail)
  },
  "docs": {
    object (Docs)
  },
  "sheets": {
    object (Sheets)
  },
  "slides": {
    object (Slides)
  }
}
ช่อง
common

object (Common)

ต้องระบุ กำหนดค่าสำหรับ ส่วนเสริม Google Workspace ที่ใช้กันทั่วไป สำหรับแอปพลิเคชันของโฮสต์ทั้งหมด ค่าบางค่าที่กำหนดไว้ที่นี่ใช้เป็นค่าเริ่มต้นเมื่อมีการละเว้นค่าที่เจาะจงสำหรับโฮสต์หนึ่งๆ

calendar

object (Calendar)

ต้องระบุหากส่วนเสริมของ Google Workspace ขยายปฏิทินให้ การกำหนดค่าสำหรับลักษณะและการทำงานของส่วนเสริม Google Workspace ภายในแอปพลิเคชันโฮสต์ Google ปฏิทิน หากเว้นช่องนี้ไว้ ระบบจะปิดใช้ส่วนเสริมใน Google ปฏิทิน

drive

object (Drive)

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

gmail

object (Gmail)

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

docs

object (Docs)

ต้องระบุหากส่วนเสริมของ Google Workspace ใช้ได้กับเอกสาร การกำหนดค่าสำหรับลักษณะที่ปรากฏและการทำงานของส่วนเสริม Google Workspace ภายในแอปพลิเคชันโฮสต์เอกสาร หากเว้นช่องนี้ไว้ ระบบจะปิดใช้ส่วนเสริมในเอกสาร

sheets

object (Sheets)

ต้องระบุหากส่วนเสริมของ Google Workspace ขยายให้กับชีต การกำหนดค่าสำหรับลักษณะที่ปรากฏและการทำงานของส่วนเสริม Google Workspace ภายในแอปพลิเคชันโฮสต์ชีต หากเว้นช่องนี้ไว้ ระบบจะปิดใช้ส่วนเสริมในชีต

slides

object (Slides)

ต้องระบุหากส่วนเสริมของ Google Workspace ขยายสไลด์ การกำหนดค่าสำหรับลักษณะที่ปรากฏและการทำงานของส่วนเสริม Google Workspace ภายในแอปพลิเคชันโฮสต์สไลด์ หากเว้นช่องนี้ไว้ ระบบจะปิดใช้ส่วนเสริมในสไลด์

ทั่วไป

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

การแสดง JSON 
{
  "homepageTrigger": {
    object (HomepageTrigger)
  },
  "layoutProperties": {
    object (LayoutProperties)
  },
  "logoUrl": string,
  "name": string,
  "openLinkUrlPrefixes": [
    string
  ],
  "universalActions": [
    {
      object (UniversalAction)
    }
  ],
  "useLocaleFromApp": boolean
}
ช่อง
homepageTrigger

object (HomepageTrigger)

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

object (LayoutProperties)

การกำหนดค่าสำหรับสีที่ใช้ในแถบเครื่องมือและปุ่มของส่วนเสริม
logoUrl

string

ต้องระบุ URL ของรูปภาพที่แสดงในแถบเครื่องมือ URL ต้องเป็นแบบสาธารณะ
name

string

ต้องระบุ ชื่อของส่วนเสริมที่แสดงในแถบเครื่องมือ
openLinkUrlPrefixes[]

string

ต้องระบุหากส่วนเสริมแสดงลิงก์ขาออก ไม่ว่าจะภายในวิดเจ็ตที่ใช้ OpenLink หรือวิดเจ็ตข้อความที่ใช้แท็ก Anchor ของ HTML รายการคำนำหน้า HTTPS URL ลิงก์ใดก็ตามที่ส่วนเสริมแสดงผลต้องตรงกับคำนำหน้าในรายการนี้เพื่อปกป้องข้อมูลผู้ใช้

ดูรายละเอียดเพิ่มเติมได้ที่ URL ในรายการที่อนุญาต

universalActions[]

object (UniversalAction)

รายการการดำเนินการสากลที่พร้อมใช้งานเสมอใน UI ของส่วนเสริม
useLocaleFromApp

boolean

หากเป็น true ออบเจ็กต์เหตุการณ์ของส่วนเสริมที่ส่งไปยัง ฟังก์ชัน Callback การดำเนินการหรือฟังก์ชันทริกเกอร์จะรวมข้อมูลภาษาและเขตเวลาของผู้ใช้ ค่าเริ่มต้นคือ false

ดูรายละเอียดเพิ่มเติมได้ที่ การเข้าถึงภาษาและเขตเวลาของผู้ใช้

LayoutProperties

การกำหนดค่าที่ควบคุม Google Workspace สีและลักษณะของปุ่มแถบเครื่องมือของส่วนเสริม

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

string

สีของแถบเครื่องมือ ค่าเริ่มต้นคือสีเทา (#424242)
secondaryColor

string

สีเริ่มต้นของปุ่ม ค่าเริ่มต้นคือสีหลัก (หากตั้งค่าไว้) หรือมิฉะนั้น จะมีค่าเริ่มต้นเป็นสีน้ำเงิน (#2196F3)

UniversalAction

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

การแสดง JSON 
{
  "label": string,

  // Union field rule can be only one of the following:
  "openLink": string,
  "runFunction": string,
  // End of list of possible types for union field rule.

}
ช่อง
label

string

ต้องระบุสำหรับการดำเนินการสากลแต่ละรายการ ข้อความที่แสดงในเมนู UI สำหรับการดำเนินการนี้
runFunction

string

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

ดูรายละเอียดในคู่มือ การดำเนินการแบบสากล