ทรัพยากรของไฟล์ Manifest ในเครื่องมือแก้ไข

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

เครื่องมือแก้ไข

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

การแสดง JSON
  {
    "homepageTrigger": {
      object (HomepageTrigger)
    },
    "onFileScopeGrantedTrigger": {
      object (OnFileScopeGrantedTrigger)
    },
    "linkPreviewTriggers": [
      {
        object (LinkPreviewTriggers)
      }
    ],
    "createActionTriggers": [
      {
        object (CreateActionTriggers)
      }
  }
ช่อง
homepageTrigger

object (HomepageTrigger)

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

onFileScopeGrantedTrigger

object (OnFileScopeGrantedTrigger)

ต้องระบุหากส่วนเสริมมีลักษณะการทำงาน ที่เฉพาะเจาะจงกับเอกสารปัจจุบัน ซึ่งจะทริกเกอร์เมื่อผู้ใช้ ให้สิทธิ์ขอบเขต drive.file

linkPreviewTriggers[]

object (LinkPreviewTriggers)

ต้องระบุสำหรับตัวอย่างลิงก์ รายการทริกเกอร์สำหรับการแสดงตัวอย่าง ลิงก์ในไฟล์ Google เอกสาร ชีต หรือ สไลด์ ดูรายละเอียดได้ที่ แสดงตัวอย่างลิงก์ด้วยชิปอัจฉริยะ

createActionTriggers[]

object (createActionTriggers)

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

OnFileScopeGrantedTrigger

การกำหนดค่าสำหรับทริกเกอร์ตามบริบทซึ่งจะเริ่มทำงานเมื่อกล่องโต้ตอบขอบเขตไฟล์คำขอใช้ CardService.newEditorFileScopeActionResponseBuilder().requestFileScopeForActiveDocument().build(); และผู้ใช้ให้สิทธิ์การให้สิทธิ์ขอบเขต drive.file

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

string

ชื่อของฟังก์ชันที่จะเรียกใช้หากได้รับขอบเขต drive.file ฟังก์ชันต้องแสดงผลอาร์เรย์ของ Card ออบเจ็กต์สำหรับ UI

LinkPreviewTriggers

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

หากต้องการตั้งค่าทริกเกอร์นี้สำหรับส่วนเสริมของ Google Workspace โปรดดูดูตัวอย่างลิงก์ด้วยชิปอัจฉริยะ

การแสดง JSON
{
  "labelText": string,
  "localizedLabelText": {
    string: string,
    ...
  },
  "runFunction": string,
  "logoUrl": string,
  "patterns": [
    {
      object(patterns)
    }
  ]
}
ช่อง
labelText

string

ต้องระบุ ข้อความสำหรับชิปอัจฉริยะตัวอย่างที่แจ้งให้ผู้ใช้Example: Support caseดูตัวอย่างลิงก์ ข้อความนี้ เป็นข้อความแบบคงที่
localizedLabelText

map (key: string, value: string)

ไม่บังคับ แผนที่ของ labelText เพื่อแปลเป็นภาษาอื่นๆ จัดรูปแบบภาษาในISO 639 และประเทศ/ภูมิภาคใน ISO 3166 โดยคั่นด้วยขีดกลาง -
patterns[]

object (UriPattern)

ต้องระบุ อาร์เรย์ของรูปแบบ URL ที่ทริกเกอร์ ส่วนเสริมเพื่อแสดงตัวอย่างลิงก์
runFunction

string

ต้องระบุ ชื่อของฟังก์ชันที่จะเรียกใช้เมื่อผู้ใช้ให้สิทธิ์ขอบเขต https://www.googleapis.com/auth/workspace.linkpreview ฟังก์ชันต้องยอมรับออบเจ็กต์เหตุการณ์ ซึ่งมีพร็อพเพอร์ตี้ matchedUrl.url ที่มี URL ที่จะแสดงตัวอย่าง และต้องคืนค่าออบเจ็กต์ Card
logoUrl

string

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

UriPattern

การกำหนดค่าสำหรับรูปแบบ URL แต่ละรายการที่ทริกเกอร์ตัวอย่างลิงก์

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

string

ต้องระบุสำหรับรูปแบบ URL แต่ละรายการ โดเมนรูปแบบ URL ส่วนเสริมจะแสดงตัวอย่างลิงก์ที่มีโดเมนนี้ หากต้องการจับคู่โดเมนย่อยทั้งหมด ให้ใช้ไวลด์การ์ดเป็นเครื่องหมายดอกจัน (*)
pathPrefix

string

ไม่บังคับ เส้นทางที่ต่อท้ายโดเมน หากต้องการจับคู่ URL ทั้งหมดในโดเมน ให้เว้นpathPrefixว่างไว้

CreateActionTriggers

การกำหนดค่าสำหรับทริกเกอร์ที่ทำงานเมื่อผู้ใช้เลือกรายการเมนูการผสานรวมของบุคคลที่สามจากเมนู @ ใน Google เอกสาร

หากต้องการตั้งค่าทริกเกอร์นี้สำหรับส่วนเสริมของ Google Workspace โปรดดูหัวข้อสร้างทรัพยากรของบุคคลที่สามด้วยชิปอัจฉริยะ

การแสดง JSON
{
  "id": string,
  "labelText": string,
  "localizedLabelText": {
    string: string,
    ...
  },
  "runFunction": string,
  "logoUrl": string,
}
ช่อง
id

string

ต้องระบุ รหัสที่ไม่ซ้ำกันสำหรับจุดขยายนี้ ใช้อักขระได้สูงสุด 64 ตัวในรูปแบบ [a-zA-Z0-9-]+.
labelText

string

ต้องระบุ ข้อความที่ปรากฏในเมนู @ เช่น Create support case
localizedLabelText

map (key: string, value: string)

ไม่บังคับ แผนที่ของ labelText เพื่อแปล จัดรูปแบบ ภาษาใน ISO 639 และประเทศ/ภูมิภาคใน ISO 3166 โดยคั่นด้วยขีดกลาง -
runFunction

string

ต้องระบุ ชื่อของฟังก์ชันที่จะเรียกใช้เมื่อผู้ใช้เลือกจุดขยาย ฟังก์ชันต้องแสดงผลการ์ดแบบฟอร์ม
logoUrl

string

ไม่บังคับ ไอคอนที่แสดงในเมนู @ หากละไว้ ส่วนเสริม จะใช้ไอคอนแถบเครื่องมือ logoUrl