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

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

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

การกําหนดค่าไฟล์ 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 เอกสาร โปรดดูรายละเอียดที่หัวข้อแสดงตัวอย่างลิงก์ที่มีชิปอัจฉริยะ

ทริกเกอร์ที่ให้สิทธิ์ในขอบเขต

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

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

string

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

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

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

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

การแสดง 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 ให้ใช้ cases เพื่อจับคู่ URL สำหรับเคสที่โฮสต์ที่ support.example.com/cases/

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