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

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

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

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

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

object (HomepageTrigger)

ฟังก์ชันทริกเกอร์นี้จะสร้างส่วนเสริม homepage ใน แอปโฮสต์ การลบล้างนี้ 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 ลงในเอกสาร ไฟล์ชีต หรือสไลด์

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