REST Resource: projects.deployments

แหล่งข้อมูล: การติดตั้งใช้งาน

การติดตั้งใช้งานส่วนเสริม Google Workspace

การแสดง JSON 
{
  "name": string,
  "oauthScopes": [
    string
  ],
  "addOns": {
    object (AddOns)
  },
  "etag": string
}
ช่อง
name

string

ชื่อทรัพยากรการทำให้ใช้งานได้ ตัวอย่าง: projects/123/deployments/my_deployment
oauthScopes[]

string

รายการขอบเขต OAuth ของ Google ที่จะขอความยินยอมจากผู้ใช้ปลายทางก่อนเรียกใช้ปลายทางส่วนเสริม
addOns

object (AddOns)

การกำหนดค่าส่วนเสริมของ Google Workspace
etag

string

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

AddOns

การกําหนดค่าส่วนเสริม Google Workspace

การแสดง JSON 
{
  "common": {
    object (CommonAddOnManifest)
  },
  "gmail": {
    object (GmailAddOnManifest)
  },
  "drive": {
    object (DriveAddOnManifest)
  },
  "calendar": {
    object (CalendarAddOnManifest)
  },
  "docs": {
    object (DocsAddOnManifest)
  },
  "sheets": {
    object (SheetsAddOnManifest)
  },
  "slides": {
    object (SlidesAddOnManifest)
  },
  "httpOptions": {
    object (HttpOptions)
  }
}
ช่อง
common

object (CommonAddOnManifest)

การกําหนดค่าที่ใช้ร่วมกันในส่วนเสริม Google Workspace ทั้งหมด
gmail

object (GmailAddOnManifest)

การกำหนดค่าส่วนเสริม Gmail
drive

object (DriveAddOnManifest)

การกำหนดค่าส่วนเสริมของไดรฟ์
calendar

object (CalendarAddOnManifest)

การกําหนดค่าส่วนเสริมปฏิทิน
docs

object (DocsAddOnManifest)

การกำหนดค่าส่วนเสริมเอกสาร
sheets

object (SheetsAddOnManifest)

การกําหนดค่าส่วนเสริมชีต
slides

object (SlidesAddOnManifest)

การกำหนดค่าส่วนเสริมของสไลด์
httpOptions

object (HttpOptions)

ตัวเลือกในการส่งคําขอไปยังปลายทาง HTTP ของส่วนเสริม

CommonAddOnManifest

การกําหนดค่าส่วนเสริมที่แชร์ในแอปพลิเคชันโฮสต์ส่วนเสริมทั้งหมด

การแสดง JSON 
{
  "name": string,
  "logoUrl": string,
  "layoutProperties": {
    object (LayoutProperties)
  },
  "addOnWidgetSet": {
    object (AddOnWidgetSet)
  },
  "useLocaleFromApp": boolean,
  "homepageTrigger": {
    object (HomepageExtensionPoint)
  },
  "universalActions": [
    {
      object (UniversalActionExtensionPoint)
    }
  ],
  "openLinkUrlPrefixes": array
}
ช่อง
name

string

ต้องระบุ ชื่อที่แสดงของส่วนเสริม
logoUrl

string

ต้องระบุ URL ของรูปภาพโลโก้ที่แสดงในแถบเครื่องมือของส่วนเสริม
layoutProperties

object (LayoutProperties)

คุณสมบัติเลย์เอาต์ทั่วไปสำหรับการ์ดส่วนเสริม
addOnWidgetSet

object (AddOnWidgetSet)

วิดเจ็ตที่ใช้ในส่วนเสริม หากไม่ได้ระบุช่องนี้ ระบบจะใช้ชุดเริ่มต้น
useLocaleFromApp

boolean

เลือกว่าจะส่งผ่านข้อมูลภาษาจากแอปโฮสต์หรือไม่
homepageTrigger

object (HomepageExtensionPoint)

กำหนดปลายทางที่จะดำเนินการในบริบทใดก็ได้ในโฮสต์ใดก็ได้ การ์ดที่สร้างขึ้นโดยฟังก์ชันนี้จะพร้อมใช้งานสำหรับผู้ใช้เสมอ แต่อาจถูกบดบังโดยเนื้อหาตามบริบทเมื่อส่วนเสริมนี้ประกาศทริกเกอร์ที่กําหนดเป้าหมายมากขึ้น
universalActions[]

object (UniversalActionExtensionPoint)

กําหนดรายการจุดขยายในเมนูการดําเนินการแบบยูนิเวอร์แซลซึ่งทําหน้าที่เป็นเมนูการตั้งค่าสําหรับส่วนเสริม จุดขยายอาจเป็น URL ของลิงก์ที่จะเปิดหรือปลายทางที่จะดำเนินการเป็นการส่งแบบฟอร์ม
openLinkUrlPrefixes

array (ListValue format)

การดำเนินการ OpenLink ใช้ได้เฉพาะกับ URL ที่มีสคีมา HTTPS, MAILTO หรือ TEL สำหรับลิงก์ HTTPS URL ต้องตรงกับคำนำหน้าใดคำนำหน้าหนึ่งที่ระบุไว้ในรายการที่อนุญาตด้วย หากคำนำหน้าไม่แสดงสคีม ระบบจะถือว่าเป็น HTTPS ระบบจะเขียนลิงก์ HTTP ลิงก์ใหม่เป็น HTTPS ลิงก์โดยอัตโนมัติ

LayoutProperties

พร็อพเพอร์ตี้เลย์เอาต์การ์ดที่แชร์ในแอปพลิเคชันโฮสต์ของส่วนเสริมทั้งหมด

การแสดง JSON 
{
  "primaryColor": string,
  "secondaryColor": string,
  "useNewMaterialDesign": boolean
}
ช่อง
primaryColor

string

สีหลักของส่วนเสริม กำหนดสีของแถบเครื่องมือ หากไม่ได้ตั้งค่าสีหลัก ระบบจะใช้ค่าเริ่มต้นที่เฟรมเวิร์กระบุ
secondaryColor

string

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

boolean

เปิดใช้การออกแบบเชิงวัสดุสำหรับการ์ด

AddOnWidgetSet

ชุดย่อยวิดเจ็ตที่ส่วนเสริมใช้

การแสดง JSON 
{
  "usedWidgets": [
    enum (WidgetType)
  ]
}
ช่อง
usedWidgets[]

enum (WidgetType)

รายการวิดเจ็ตที่ใช้ในส่วนเสริม

WidgetType

ประเภทวิดเจ็ต WIDGET_TYPE_UNSPECIFIED คือชุดวิดเจ็ตพื้นฐาน

Enum
WIDGET_TYPE_UNSPECIFIED ชุดวิดเจ็ตเริ่มต้น
DATE_PICKER เครื่องมือเลือกวันที่
STYLED_BUTTONS ปุ่มที่มีการจัดรูปแบบประกอบด้วยปุ่มแบบเติมสีและปุ่มที่ปิดใช้งาน
PERSISTENT_FORMS แบบฟอร์มถาวรช่วยให้ค่าแบบฟอร์มคงอยู่ในระหว่างการดำเนินการ
UPDATE_SUBJECT_AND_RECIPIENTS อัปเดตเรื่องและผู้รับฉบับร่าง
GRID_WIDGET วิดเจ็ตตารางกริด
ADDON_COMPOSE_UI_ACTION การดำเนินการของส่วนเสริม Gmail ที่ใช้กับ UI การเขียนของส่วนเสริม

HomepageExtensionPoint

รูปแบบทั่วไปสำหรับการประกาศมุมมองหน้าแรกของส่วนเสริม

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

string

ต้องระบุ ปลายทางที่จะดำเนินการเมื่อเปิดใช้งานจุดส่วนขยายนี้
enabled

boolean

ไม่บังคับ หากตั้งค่าเป็น false จะเป็นการปิดใช้งานมุมมองหน้าแรกในบริบทนี้

ค่าเริ่มต้นคือ true หากไม่ได้ตั้งค่า

หากปิดใช้มุมมองหน้าแรกที่กำหนดเองของส่วนเสริม ระบบจะแสดงการ์ดภาพรวมทั่วไปแก่ผู้ใช้แทน

UniversalActionExtensionPoint

รูปแบบสำหรับการประกาศจุดขยายรายการเมนูการทำงานสากล

การแสดง JSON 
{
  "label": string,

  // Union field action_type can be only one of the following:
  "openLink": string,
  "runFunction": string
  // End of list of possible types for union field action_type.
}
ช่อง
label

string

ต้องระบุ ข้อความที่ผู้ใช้มองเห็นได้ซึ่งอธิบายการดำเนินการที่เกิดจากการเปิดใช้งานจุดส่วนขยายนี้ เช่น "เพิ่มรายชื่อติดต่อใหม่"
ฟิลด์สหภาพ action_type ต้องระบุ ประเภทการดำเนินการที่รองรับในรายการเมนูการทำงานสากล ซึ่งอาจเป็นลิงก์สำหรับเปิดหรือเป็นปลายทางสำหรับการดำเนินการก็ได้ action_type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
runFunction

string

ปลายทางที่ UniversalAction จะเรียกใช้

GmailAddOnManifest

พร็อพเพอร์ตี้ที่ปรับแต่งลักษณะที่ปรากฏและการดำเนินการของส่วนเสริม Gmail

การแสดง JSON 
{
  "homepageTrigger": {
    object (HomepageExtensionPoint)
  },
  "contextualTriggers": [
    {
      object (ContextualTrigger)
    }
  ],
  "universalActions": [
    {
      object (UniversalAction)
    }
  ],
  "composeTrigger": {
    object (ComposeTrigger)
  },
  "authorizationCheckFunction": string
}
ช่อง
homepageTrigger

object (HomepageExtensionPoint)

กำหนดปลายทางที่จะดำเนินการในบริบทที่ไม่ตรงกับทริกเกอร์ตามบริบทที่ประกาศไว้ การ์ดที่สร้างโดยฟังก์ชันนี้จะพร้อมใช้งานสำหรับผู้ใช้เสมอ แต่อาจถูกบดบังด้วยเนื้อหาตามบริบทเมื่อส่วนเสริมนี้ประกาศทริกเกอร์ที่ตรงเป้าหมายมากกว่า

หากมี ค่านี้จะลบล้างการกําหนดค่าจาก addons.common.homepageTrigger
contextualTriggers[]

object (ContextualTrigger)

กำหนดชุดเงื่อนไขที่ทริกเกอร์ส่วนเสริม
universalActions[]

object (UniversalAction)

กำหนดชุดการดำเนินการแบบสากลสำหรับส่วนเสริม ผู้ใช้จะทริกเกอร์การทำงานส่วนกลางจากเมนูแถบเครื่องมือของส่วนเสริม
composeTrigger

object (ComposeTrigger)

กำหนดทริกเกอร์เวลาเขียนสำหรับส่วนเสริมเวลาเขียน เงื่อนไขนี้เป็นทริกเกอร์ที่ทำให้ส่วนเสริมดำเนินการเมื่อผู้ใช้กำลังเขียนอีเมล ส่วนเสริมเวลาเขียนทั้งหมดต้องมีขอบเขต gmail.addons.current.action.compose แต่อาจไม่สามารถแก้ไขฉบับร่างได้
authorizationCheckFunction

string

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

ContextualTrigger

กําหนดทริกเกอร์ที่จะทํางานเมื่ออีเมลที่เปิดอยู่ตรงกับเกณฑ์ที่เฉพาะเจาะจง เมื่อทริกเกอร์เริ่มทํางาน ก็จะเรียกใช้ปลายทางที่เฉพาะเจาะจง ซึ่งมักจะสร้างการ์ดใหม่และอัปเดต UI

การแสดง JSON 
{
  "onTriggerFunction": string,

  // Union field trigger can be only one of the following:
  "unconditional": {
    object (UnconditionalTrigger)
  }
  // End of list of possible types for union field trigger.
}
ช่อง
onTriggerFunction

string

ต้องระบุ ชื่อของปลายทางที่จะเรียกใช้เมื่อข้อความตรงกับทริกเกอร์
ช่องการรวม trigger ประเภทของทริกเกอร์จะเป็นตัวกำหนดเงื่อนไขที่ Gmail ใช้เพื่อแสดงส่วนเสริม trigger ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
unconditional

object (UnconditionalTrigger)

ทริกเกอร์แบบไม่มีเงื่อนไขจะทำงานเมื่อเปิดข้อความอีเมล

UnconditionalTrigger

ประเภทนี้ไม่มีช่อง

ทริกเกอร์ที่ทำงานเมื่อมีการเปิดข้อความอีเมล

UniversalAction

การดำเนินการที่ใช้ได้เสมอในเมนูแถบเครื่องมือของส่วนเสริม ไม่ว่าบริบทของข้อความจะเป็นอย่างไรก็ตาม

การแสดง JSON 
{
  "text": string,

  // Union field action_type can be only one of the following:
  "openLink": string,
  "runFunction": string
  // End of list of possible types for union field action_type.
}
ช่อง
text

string

ต้องระบุ ข้อความที่ผู้ใช้มองเห็นซึ่งอธิบายการดําเนินการ เช่น "เพิ่มรายชื่อติดต่อใหม่"
ช่องการรวม action_type ประเภทการดําเนินการจะกําหนดลักษณะการทํางานของ Gmail เมื่อผู้ใช้เรียกใช้การดําเนินการ action_type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
runFunction

string

ปลายทางที่ระบบจะเรียกใช้เมื่อผู้ใช้ทริกเกอร์การดำเนินการ ดูรายละเอียดได้ในคำแนะนำการดําเนินการแบบรวม

ComposeTrigger

ทริกเกอร์ที่เปิดใช้งานเมื่อผู้ใช้กำลังเขียนอีเมล

การแสดง JSON 
{
  "actions": [
    {
      object (MenuItemExtensionPoint)
    }
  ],
  "draftAccess": enum (DraftAccess)
}
ช่อง
actions[]

object (MenuItemExtensionPoint)

กำหนดชุดการดำเนินการสำหรับส่วนเสริมเวลาเขียน การดำเนินการเหล่านี้คือการดำเนินการที่ผู้ใช้สามารถเรียกให้แสดงได้ในส่วนเสริมเวลาเขียน
draftAccess

enum (DraftAccess)

กําหนดระดับการเข้าถึงข้อมูลเมื่อมีการเรียกให้ส่วนเสริมเวลาเขียน

DraftAccess

Enum ที่กําหนดระดับการเข้าถึงข้อมูลที่ทริกเกอร์การเขียนต้องการ

Enum
UNSPECIFIED ค่าเริ่มต้นเมื่อไม่มีการตั้งค่าการเข้าถึงฉบับร่างไว้
NONE ทริกเกอร์การเขียนเข้าถึงข้อมูลใดๆ ของฉบับร่างไม่ได้เมื่อมีการทริกเกอร์ส่วนเสริมการเขียน
METADATA ให้สิทธิ์ทริกเกอร์การเขียนในการเข้าถึงข้อมูลเมตาของฉบับร่างเมื่อมีการทริกเกอร์ส่วนเสริมการเขียน ซึ่งรวมถึงรายการผู้ชม เช่น รายชื่อ "ถึง" และ "สำเนา" ของข้อความฉบับร่าง

DriveAddOnManifest

คุณสมบัติที่กำหนดค่าลักษณะที่ปรากฏและการดำเนินการของส่วนเสริมของไดรฟ์

การแสดง JSON 
{
  "homepageTrigger": {
    object (HomepageExtensionPoint)
  },
  "onItemsSelectedTrigger": {
    object (DriveExtensionPoint)
  }
}
ช่อง
homepageTrigger

object (HomepageExtensionPoint)

หากมี ค่านี้จะลบล้างการกําหนดค่าจาก addons.common.homepageTrigger
onItemsSelectedTrigger

object (DriveExtensionPoint)

สอดคล้องกับลักษณะการทำงานที่ดำเนินการเมื่อเลือกรายการในมุมมองไดรฟ์ที่เกี่ยวข้อง เช่น รายการเอกสารในไดรฟ์ของฉัน

DriveExtensionPoint

รูปแบบทั่วไปสำหรับการประกาศทริกเกอร์ของส่วนเสริมไดรฟ์

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

string

ต้องระบุ ปลายทางที่จะดำเนินการเมื่อเปิดใช้งานจุดขยาย

CalendarAddOnManifest

พร็อพเพอร์ตี้ที่ปรับแต่งรูปลักษณ์และการใช้งานส่วนเสริมของปฏิทิน

การแสดง JSON 
{
  "homepageTrigger": {
    object (HomepageExtensionPoint)
  },
  "conferenceSolution": [
    {
      object (ConferenceSolution)
    }
  ],
  "createSettingsUrlFunction": string,
  "eventOpenTrigger": {
    object (CalendarExtensionPoint)
  },
  "eventUpdateTrigger": {
    object (CalendarExtensionPoint)
  },
  "eventAttachmentTrigger": {
    object (MenuItemExtensionPoint)
  },
  "currentEventAccess": enum (EventAccess)
}
ช่อง
homepageTrigger

object (HomepageExtensionPoint)

กำหนดปลายทางที่จะดำเนินการในบริบทที่ไม่ตรงกับทริกเกอร์ตามบริบทที่ประกาศไว้ การ์ดที่สร้างโดยฟังก์ชันนี้จะพร้อมใช้งานสำหรับผู้ใช้เสมอ แต่อาจถูกจำกัดโดยเนื้อหาตามบริบทเมื่อส่วนเสริมนี้ประกาศทริกเกอร์ที่กำหนดเป้าหมายเพิ่มเติม

หากมี ค่านี้จะลบล้างการกําหนดค่าจาก addons.common.homepageTrigger
conferenceSolution[]

object (ConferenceSolution)

กำหนดโซลูชันการประชุมที่ส่วนเสริมนี้มีให้ ส่วนเสริมสำหรับการประชุมของบุคคลที่สามจะสร้างได้ใน Apps Script เท่านั้น
createSettingsUrlFunction

string

ปลายทางที่จะดำเนินการซึ่งสร้าง URL ไปยังหน้าการตั้งค่าของส่วนเสริม
eventOpenTrigger

object (CalendarExtensionPoint)

ปลายทางที่ทริกเกอร์เมื่อเปิดเหตุการณ์เพื่อดูหรือแก้ไข
eventUpdateTrigger

object (CalendarExtensionPoint)

ปลายทางที่ทริกเกอร์เมื่อมีการอัปเดตเหตุการณ์ที่เปิดอยู่
eventAttachmentTrigger

object (MenuItemExtensionPoint)

การกำหนดค่าสำหรับทริกเกอร์ตามบริบทที่เริ่มทำงานเมื่อผู้ใช้คลิกผู้ให้บริการไฟล์แนบของส่วนเสริมในเมนูแบบเลื่อนลงของปฏิทิน
currentEventAccess

enum (EventAccess)

กำหนดระดับการเข้าถึงข้อมูลเมื่อมีการทริกเกอร์ส่วนเสริมเหตุการณ์

ConferenceSolution

กำหนดค่าที่เกี่ยวข้องกับการประชุม ส่วนเสริมสำหรับการประชุมของบุคคลที่สามจะสร้างได้ใน Apps Script เท่านั้น

การแสดง JSON 
{
  "onCreateFunction": string,
  "id": string,
  "name": string,
  "logoUrl": string
}
ช่อง
onCreateFunction

string

ต้องระบุ ปลายทางที่จะเรียกใช้เมื่อควรสร้างข้อมูลการประชุม
id

string

ต้องระบุ ควรกำหนดรหัสที่ไม่ซ้ำกันให้กับโซลูชันการประชุมภายในส่วนเสริมเดียว มิเช่นนั้นระบบอาจใช้โซลูชันการประชุมที่ไม่ถูกต้องเมื่อมีการทริกเกอร์ส่วนเสริม แม้ว่าคุณจะเปลี่ยนชื่อที่แสดงของส่วนเสริมได้ แต่ไม่ควรเปลี่ยนรหัส
name

string

ต้องระบุ ชื่อที่แสดงของโซลูชันการประชุม
logoUrl

string

ต้องระบุ URL ของรูปภาพโลโก้ของโซลูชันการประชุม

CalendarExtensionPoint

รูปแบบทั่วไปสำหรับการประกาศทริกเกอร์ของส่วนเสริมปฏิทิน

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

string

ต้องระบุ ปลายทางที่จะดำเนินการเมื่อเปิดใช้งานจุดส่วนขยายนี้

EventAccess

Enum ที่กำหนดระดับการเข้าถึงที่ทริกเกอร์เหตุการณ์การเข้าถึงข้อมูลต้องการ

Enum
UNSPECIFIED ค่าเริ่มต้นเมื่อไม่มีการตั้งค่า eventAccess
METADATA ให้สิทธิ์ทริกเกอร์กิจกรรมในการเข้าถึงข้อมูลเมตาของกิจกรรม เช่น รหัสกิจกรรมและรหัสปฏิทิน
READ ให้สิทธิ์ทริกเกอร์กิจกรรมเข้าถึงช่องกิจกรรมที่ระบุไว้ทั้งหมด รวมถึงข้อมูลเมตา ผู้เข้าร่วม และข้อมูลการประชุม
WRITE ให้ทริกเกอร์เหตุการณ์เข้าถึงข้อมูลเมตาของเหตุการณ์และสามารถดําเนินการทั้งหมดได้ รวมถึงการเพิ่มผู้เข้าร่วมและการตั้งค่าข้อมูลการประชุม
READ_WRITE ให้สิทธิ์ทริกเกอร์เหตุการณ์เข้าถึงช่องเหตุการณ์ที่ระบุทั้งหมด รวมถึงข้อมูลเมตา ผู้เข้าร่วม และข้อมูลการประชุม รวมถึงสามารถดําเนินการทั้งหมด

DocsAddOnManifest

พร็อพเพอร์ตี้ที่ปรับแต่งรูปลักษณ์และการทำงานของส่วนเสริม Google เอกสาร

การแสดง JSON 
{
  "homepageTrigger": {
    object (HomepageExtensionPoint)
  },
  "onFileScopeGrantedTrigger": {
    object (DocsExtensionPoint)
  },
  "linkPreviewTriggers": [
    {
      object (LinkPreviewExtensionPoint)
    }
  ],
  "createActionTriggers": [
    {
      object (CreateActionExtensionPoint)
    }
  ]
}
ช่อง
homepageTrigger

object (HomepageExtensionPoint)

หากมี ค่านี้จะลบล้างการกําหนดค่าจาก addons.common.homepageTrigger
onFileScopeGrantedTrigger

object (DocsExtensionPoint)

ปลายทางที่จะดำเนินการเมื่อมีการอนุญาตให้ใช้สิทธิ์ระดับไฟล์สำหรับคู่เอกสาร/ผู้ใช้นี้
linkPreviewTriggers[]

object (LinkPreviewExtensionPoint)

รายการจุดขยายสำหรับการแสดงตัวอย่างลิงก์ในเอกสาร Google เอกสาร โปรดดูรายละเอียดที่หัวข้อแสดงตัวอย่างลิงก์ด้วยชิปอัจฉริยะ
createActionTriggers[]

object (CreateActionExtensionPoint)

รายการจุดขยายสำหรับการสร้างทรัพยากรของบุคคลที่สามจากภายในแอปพลิเคชัน Google Workspace ดูข้อมูลเพิ่มเติมได้ที่สร้างแหล่งข้อมูลของบุคคลที่สามจากเมนู @

DocsExtensionPoint

รูปแบบทั่วไปสำหรับการประกาศทริกเกอร์ของส่วนเสริมในเอกสาร

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

string

ต้องระบุ ปลายทางที่จะดำเนินการเมื่อเปิดใช้งานจุดส่วนขยายนี้

LinkPreviewExtensionPoint

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

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

string

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

map (key: string, value: string)

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

หากภาษาของผู้ใช้แสดงอยู่ในคีย์ของแผนที่ ผู้ใช้จะเห็น labeltext เวอร์ชันที่แปลแล้ว

ออบเจ็กต์ที่มีรายการคู่ "key": value ตัวอย่างเช่น { "name": "wrench", "mass": "1.3kg", "count": "3" }
patterns[]

object (UriPattern)

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

string

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

CreateActionExtensionPoint

การกําหนดค่าสําหรับทริกเกอร์ที่เริ่มทำงานเมื่อผู้ใช้เรียกใช้เวิร์กโฟลว์การสร้างทรัพยากรในแอปพลิเคชัน 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 เวอร์ชันที่แปลแล้ว

ออบเจ็กต์ที่มีรายการคู่ "key": value ตัวอย่างเช่น { "name": "wrench", "mass": "1.3kg", "count": "3" }
runFunction

string

ต้องระบุ ปลายทางที่จะดำเนินการเมื่อมีการทริกเกอร์เวิร์กโฟลว์การสร้างทรัพยากรเพื่อสร้างลิงก์
logoUrl

string

ไม่บังคับ ไอคอนที่แสดงสำหรับจุดแรกเข้าของการสร้างทรัพยากร หากละไว้ เมนูจะใช้ไอคอนแถบเครื่องมือของส่วนเสริม logourl

SheetsAddOnManifest

พร็อพเพอร์ตี้ที่ปรับแต่งลักษณะที่ปรากฏและการดำเนินการของส่วนเสริม Google ชีต

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

object (HomepageExtensionPoint)

หากมี ค่านี้จะลบล้างการกําหนดค่าจาก addons.common.homepageTrigger
onFileScopeGrantedTrigger

object (SheetsExtensionPoint)

ปลายทางที่จะทำงานเมื่อมีการให้สิทธิ์ขอบเขตไฟล์สำหรับคู่เอกสาร/ผู้ใช้นี้
linkPreviewTriggers[]

object (LinkPreviewExtensionPoint)

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

SheetsExtensionPoint

รูปแบบทั่วไปสำหรับการประกาศทริกเกอร์ของส่วนเสริมชีต

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

string

ต้องระบุ ปลายทางที่จะดำเนินการเมื่อเปิดใช้งานจุดส่วนขยายนี้

SlidesAddOnManifest

พร็อพเพอร์ตี้ที่ปรับแต่งรูปลักษณ์และการทำงานของส่วนเสริมใน Google สไลด์

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

object (HomepageExtensionPoint)

หากมี ค่านี้จะลบล้างการกําหนดค่าจาก addons.common.homepageTrigger
onFileScopeGrantedTrigger

object (SlidesExtensionPoint)

ปลายทางที่จะทำงานเมื่อมีการให้สิทธิ์ขอบเขตไฟล์สำหรับคู่เอกสาร/ผู้ใช้นี้
linkPreviewTriggers[]

object (LinkPreviewExtensionPoint)

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

SlidesExtensionPoint

รูปแบบทั่วไปสำหรับการประกาศทริกเกอร์ของส่วนเสริมสไลด์

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

string

ต้องระบุ ปลายทางที่จะดำเนินการเมื่อเปิดใช้งานจุดส่วนขยายนี้

HttpOptions

ตัวเลือกสำหรับการส่งคำขอไปยังปลายทางส่วนเสริม HTTP

การแสดง JSON 
{
  "authorizationHeader": enum (HttpAuthorizationHeader)
}
ช่อง
authorizationHeader

enum (HttpAuthorizationHeader)

การกำหนดค่าสำหรับโทเค็นที่ส่งในส่วนหัวการให้สิทธิ์ HTTP

HttpAuthorizationHeader

ส่วนหัวการให้สิทธิ์ที่ส่งในคำขอ HTTP ของส่วนเสริม

Enum
HTTP_AUTHORIZATION_HEADER_UNSPECIFIED ค่าเริ่มต้น จะเท่ากับ SYSTEM_ID_TOKEN
SYSTEM_ID_TOKEN ส่งโทเค็นระบุตัวตนสำหรับบัญชีบริการระบบของส่วนเสริม Google Workspace สำหรับโปรเจ็กต์ที่เฉพาะเจาะจง (ค่าเริ่มต้น)
USER_ID_TOKEN ส่งโทเค็นระบุตัวตนสำหรับผู้ใช้ปลายทาง
NONE อย่าส่งส่วนหัวการตรวจสอบสิทธิ์

เมธอด

create

 สร้างการติดตั้งใช้งานที่มีชื่อและการกำหนดค่าที่ระบุ

delete

 ลบการทำให้ใช้งานได้ที่มีชื่อที่ระบุ

get

 รับข้อมูลการทำให้ใช้งานได้ด้วยชื่อที่ระบุ

getInstallStatus

 รับสถานะการติดตั้งของการติดตั้งใช้งานทดสอบ

install

 ติดตั้งการติดตั้งใช้งานในบัญชีเพื่อทดสอบ

list

 แสดงรายการการทำให้ใช้งานได้ทั้งหมดในโปรเจ็กต์หนึ่งๆ

replaceDeployment

 สร้างหรือแทนที่การทำให้ใช้งานได้ด้วยชื่อที่ระบุ

uninstall

 ถอนการติดตั้งการติดตั้งใช้งานทดสอบออกจากบัญชีของผู้ใช้