منبع مانیفست ویرایشگر

The resource configuration used to define Google Workspace add-on content and behavior within the editors. Google Workspace add-on manifests must include all components marked as Required if they extend the Editor.

ویراستاران

پیکربندی مانیفست افزونه‌ی Google Workspace برای افزونه‌های ویرایشگر. برای جزئیات بیشتر به بخش «توسعه‌ی ویرایشگرها با افزونه‌های Google Workspace» مراجعه کنید.

نمایش JSON
  {
    "homepageTrigger": {
      object (HomepageTrigger)
    },
    "onFileScopeGrantedTrigger": {
      object (OnFileScopeGrantedTrigger)
    },
    "linkPreviewTriggers": [
      {
        object (LinkPreviewTriggers)
      }
    ],
    "createActionTriggers": [
      {
        object (CreateActionTriggers)
      }
  }
فیلدها
homepageTrigger

object ( HomepageTrigger )

این تابع تریگر، صفحه اصلی افزونه را در برنامه میزبان ایجاد می‌کند. این addOns.common.homepageTrigger را لغو می‌کند.

onFileScopeGrantedTrigger

object ( OnFileScopeGrantedTrigger )

اگر افزونه شامل رفتاری مختص به سند فعلی باشد، الزامی است و زمانی فعال می‌شود که کاربر دامنه‌ی drive.file را مجاز کند.

linkPreviewTriggers[]

object ( LinkPreviewTriggers )

برای پیش‌نمایش لینک‌ها مورد نیاز است. فهرستی از محرک‌ها برای پیش‌نمایش لینک‌ها در یک فایل Google Docs، Sheets یا Slides. برای جزئیات بیشتر، به پیش‌نمایش لینک‌ها با تراشه‌های هوشمند مراجعه کنید.

createActionTriggers[]

object ( createActionTriggers )

مورد نیاز برای ایجاد منابع شخص ثالث. فهرستی از محرک‌ها برای ایجاد منابع در یک سرویس شخص ثالث از منوی @. برای جزئیات بیشتر، به ایجاد منابع شخص ثالث با تراشه‌های هوشمند مراجعه کنید.

OnFileScopeGrantedTrigger

A configuration for a contextual trigger that fires when the request file scope dialog uses CardService.newEditorFileScopeActionResponseBuilder().requestFileScopeForActiveDocument().build(); and the user grants drive.file scope authorization.

نمایش JSON
{
  "runFunction": string
}
فیلدها
runFunction

string

نام تابعی که در صورت اعطای دامنه‌ی drive.file اجرا می‌شود. این تابع باید آرایه‌ای از اشیاء Card را برای رابط کاربری برگرداند.

پیش‌نمایش لینک‌ها

پیکربندی مربوط به تریگری که وقتی کاربر پیوندی را از یک سرویس شخص ثالث در یک فایل Docs، Sheets یا Slides تایپ یا پیست می‌کند، فعال می‌شود.

برای تنظیم این ماشه برای افزونه‌ی 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 قالب‌بندی کنید، که با یک خط تیره - از هم جدا شده‌اند.
patterns[]

object ( UriPattern )

الزامی. آرایه‌ای از الگوهای URL که افزونه را برای پیش‌نمایش لینک‌ها فعال می‌کنند.
runFunction

string

Required. The name of the function to run when the user authorizes the https://www.googleapis.com/auth/workspace.linkpreview scope. The function must accept an event object, which includes a matchedUrl.url property containing the URL to preview, and return a Card object.
logoUrl

string

اختیاری. آیکونی که در تراشه هوشمند و کارت پیش‌نمایش نمایش داده می‌شود. در صورت حذف، افزونه از آیکون نوار ابزار خود، logoUrl ، استفاده می‌کند.

UriPattern

پیکربندی هر الگوی URL که پیش‌نمایش لینک را فعال می‌کند.

نمایش JSON
{
  "hostPattern": string,
  "pathPrefix" : string
}
فیلدها
hostPattern

string

برای هر الگوی URL الزامی است . دامنه الگوی URL. افزونه، لینک‌های حاوی این دامنه را پیش‌نمایش می‌دهد. برای تطبیق همه زیردامنه‌ها، از علامت ستاره ( * ) استفاده کنید.
pathPrefix

string

اختیاری. مسیری که به دامنه اضافه می‌شود. برای تطبیق با تمام URLهای موجود در دامنه، pathPrefix خالی بگذارید.

ایجاد محرک‌های اکشن

پیکربندی مربوط به تریگری که هنگام انتخاب یک آیتم منوی ادغام شخص ثالث از منوی Google Docs@ توسط کاربر، فعال می‌شود.

برای تنظیم این ماشه برای افزونه‌ی Google Workspace، به ایجاد منابع شخص ثالث با تراشه‌های هوشمند مراجعه کنید.

نمایش JSON
{
  "id": string,
  "labelText": string,
  "localizedLabelText": {
    string: string,
    ...
  },
  "runFunction": string,
  "logoUrl": string,
}
فیلدها
id

string

الزامی. شناسه منحصر به فرد برای این نقطه الحاقی. حداکثر ۶۴ کاراکتر با فرمت [a-zA-Z0-9-]+. استفاده شود.
labelText

string

الزامی. متنی که در منوی @ نمایش داده می‌شود، مانند Create support case .
localizedLabelText

map (key: string, value: string)

اختیاری. نقشه‌ای از labelText برای بومی‌سازی. قالب‌بندی زبان در ISO 639 و کشور/منطقه در ISO 3166 ، که با خط تیره - از هم جدا شده‌اند.
runFunction

string

الزامی. نام تابعی که هنگام انتخاب نقطه‌ی الحاق توسط کاربر اجرا می‌شود. این تابع باید یک کارت فرم را برگرداند.
logoUrl

string

اختیاری. آیکونی که در منوی @ نمایش داده می‌شود. در صورت حذف، افزونه از آیکون نوار ابزار خود، logoUrl ، استفاده می‌کند.