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

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

ویراستاران

پیکربندی مانیفست افزونه‌ی 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

پیکربندی برای یک تریگر زمینه‌ای که زمانی فعال می‌شود که کادر محاوره‌ای دامنه درخواست فایل از CardService.newEditorFileScopeActionResponseBuilder().requestFileScopeForActiveDocument().build(); و کاربر مجوز دامنه drive.file را اعطا کند.

نمایش 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

الزامی. نام تابعی که هنگام تأیید دامنه https://www.googleapis.com/auth/workspace.linkpreview توسط کاربر اجرا می‌شود. این تابع باید یک شیء رویداد را بپذیرد که شامل یک ویژگی matchedUrl.url است که حاوی URL مورد نظر برای پیش‌نمایش است و یک شیء Card را برمی‌گرداند.
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 ، استفاده می‌کند.