หน้านี้ได้รับการแปลโดย Cloud Translation API

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

การแสดง 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 ของส่วนเสริม

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` ว่างไว้

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`