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

ต้องระบุหากส่วนเสริมมีลักษณะการทำงานที่เจาะจงสำหรับเอกสาร Editor ปัจจุบัน ซึ่งจะทริกเกอร์เมื่อผู้ใช้ให้สิทธิ์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 ลงในไฟล์เอกสาร ชีต หรือสไลด์

หากต้องการตั้งค่าทริกเกอร์นี้สำหรับส่วนเสริมของ 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 โดยคั่นด้วยขีดกลาง - เช่น en-US

หากภาษาของผู้ใช้มีอยู่ในคีย์ของแผนที่ ผู้ใช้จะเห็นlabelTextเวอร์ชันที่แปลแล้ว

patterns[]

object (UriPattern)

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

string

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

string

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

UriPattern

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

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

string

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

เช่น *.example.com ตรงกับ subdomain.example.com และ another.subdomain.example.com
pathPrefix

string

ไม่บังคับ เส้นทางที่ต่อท้ายโดเมนของ hostPattern

ตัวอย่างเช่น หากรูปแบบโฮสต์ของ URL คือ support.example.com หากต้องการจับคู่ URL สำหรับเคสที่โฮสต์อยู่ที่ support.example.com/cases/ ให้ใช้ cases

หากต้องการจับคู่ 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 โดยคั่นด้วยขีดกลาง - เช่น en-US

หากภาษาของผู้ใช้มีอยู่ในคีย์ของแผนที่ ผู้ใช้จะเห็นlabelTextเวอร์ชันที่แปลแล้ว

runFunction

string

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

string

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