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

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

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

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

การแสดง 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 เอกสาร (หน้าตัวอย่างสําหรับนักพัฒนาซอฟต์แวร์)

OnFileScopeGrantedTrigger

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

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

string

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

ลิงก์ LinkPreview

การกําหนดค่าสําหรับทริกเกอร์ที่เริ่มทํางานเมื่อผู้ใช้พิมพ์หรือวางลิงก์จากบริการของบุคคลที่สามหรือบริการที่ไม่ใช่ของ 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/workspace.linkpreview หากระบุ คุณต้องใช้ฟังก์ชันนี้ในการยอมรับออบเจ็กต์เหตุการณ์ที่มี 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 ว่างไว้