ทรัพยากรไฟล์ Manifest ของตัวแก้ไข

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

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

การกําหนดค่าไฟล์ Manifest ของส่วนเสริมส่วนขยาย ดูข้อมูลเพิ่มเติมได้ที่การขยายเครื่องมือแก้ไขด้วย ส่วนเสริม

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

object (HomepageTrigger)

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

onFileScopeGrantedTrigger

object (OnFileScopeGrantedTrigger)

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

linkPreviewTriggers[]

object (LinkPreviewTriggers)

ต้องระบุสําหรับตัวอย่างลิงก์ รายการทริกเกอร์สําหรับดูตัวอย่างลิงก์ในเอกสาร Google เอกสาร โปรดดูรายละเอียดที่หัวข้อแสดงตัวอย่างลิงก์ใน Google เอกสาร (เวอร์ชันตัวอย่างสําหรับนักพัฒนาซอฟต์แวร์)

OnTriggerScopeGrantedTrigger

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

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

string

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

ทริกเกอร์ลิงก์ตัวอย่าง

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

หากต้องการตั้งค่าทริกเกอร์นี้สําหรับส่วนเสริม Google Workspace โปรดดูหัวข้อแสดงตัวอย่างลิงก์ใน Google เอกสาร (ตัวอย่างสําหรับนักพัฒนาซอฟต์แวร์)

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

string

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

map

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

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

object (UriPattern)

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

string

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

string

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

รูปแบบ Uri

การกําหนดค่าสําหรับ 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 ว่างไว้