منبع مانیفست AddOns

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

افزونه‌ها

بالاترین سطح پیکربندی مانیفست افزونه‌ی Google Workspace.

نمایش JSON 
{
  "common": {
    object (Common)
  },
  "calendar": {
    object (Calendar)
  },
  "chat": {
    object (Chat)
  },
  "drive": {
    object (Drive)
  },
  "gmail": {
    object (Gmail)
  },
  "docs": {
    object (Docs)
  },
  "sheets": {
    object (Sheets)
  },
  "slides": {
    object (Slides)
  },
  "meet": {
    object (Meet)
  }
}
فیلدها
common

object ( Common )

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

calendar

object ( Calendar )

در صورتی که افزونه‌ی Google Workspace، تقویم را توسعه دهد، الزامی است . پیکربندی‌های ظاهر و رفتار افزونه‌ی Google Workspace در برنامه‌ی میزبان تقویم گوگل. اگر این فیلد حذف شود، افزونه در تقویم گوگل غیرفعال می‌شود.

chat

object ()

اگر افزونه‌ی Google Workspace، Chat را توسعه دهد، الزامی است . پیکربندی برنامه‌ی Google Chat. اگر این فیلد حذف شود، افزونه در Google Chat غیرفعال می‌شود.

شیء addOns.chat باید خالی باشد. برای پیکربندی رفتار و ظاهر افزونه در Chat، به پیکربندی برنامه Google Chat مراجعه کنید.

drive

object ( Drive )

در صورتی که افزونه‌ی Google Workspace، درایو را توسعه دهد، الزامی است . پیکربندی‌هایی برای ظاهر و رفتار افزونه‌ی Google Workspace در برنامه‌ی میزبان درایو. اگر این فیلد حذف شود، افزونه در درایو غیرفعال می‌شود.

gmail

object ( Gmail )

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

docs

object ( Docs )

در صورتی که افزونه‌ی Google Workspace، Docs را توسعه دهد، الزامی است . پیکربندی‌هایی برای ظاهر و رفتار افزونه‌ی Google Workspace در برنامه‌ی میزبان Docs. اگر این فیلد حذف شود، افزونه در Docs غیرفعال می‌شود.

sheets

object ( Sheets )

در صورتی که افزونه‌ی Google Workspace، Sheets را توسعه دهد، الزامی است . پیکربندی‌های مربوط به ظاهر و رفتار افزونه‌ی Google Workspace در برنامه‌ی میزبان Sheets. اگر این فیلد حذف شود، افزونه در Sheets غیرفعال می‌شود.

slides

object ( Slides )

در صورتی که افزونه‌ی Google Workspace، اسلایدها را توسعه دهد، الزامی است . پیکربندی‌های مربوط به ظاهر و رفتار افزونه‌ی Google Workspace در برنامه‌ی میزبان اسلایدها. اگر این فیلد حذف شود، افزونه در اسلایدها غیرفعال می‌شود.

meet

object object ( Meet )

در صورتی که افزونه‌ی Google Workspace، Meet را توسعه دهد، الزامی است . پیکربندی‌های ظاهر و رفتار افزونه‌ی Google Workspace در برنامه‌ی میزبان Meet. اگر این فیلد حذف شود، افزونه در Meet غیرفعال می‌شود.

رایج

پیکربندی مانیفست برای پارامترهایی که برای هر برنامه میزبان مشترک هستند. برخی از مقادیر تعریف شده در اینجا به عنوان پیش‌فرض استفاده می‌شوند، زمانی که مقادیر خاص برای یک میزبان خاص حذف می‌شوند.

نمایش JSON 
{
  "homepageTrigger": {
    object (HomepageTrigger)
  },
  "layoutProperties": {
    object (LayoutProperties)
  },
  "logoUrl": string,
  "name": string,
  "openLinkUrlPrefixes": [
    string
  ],
  "universalActions": [
    {
      object (UniversalAction)
    }
  ],
  "useLocaleFromApp": boolean
}
فیلدها
homepageTrigger

object ( HomepageTrigger )

مشخصات تابع تریگر پیش‌فرض برای ایجاد صفحه اصلی افزونه. این مشخصات در صورتی استفاده می‌شود که تریگر صفحه اصلی مختص میزبان تعریف نشده باشد. اگر این مورد نیز حذف شود، یک کارت صفحه اصلی عمومی ساخته شده و در صورت نیاز استفاده می‌شود.
layoutProperties

object ( LayoutProperties )

پیکربندی برای رنگ‌های استفاده شده در نوار ابزار و دکمه‌های افزونه.
logoUrl

string

الزامی. آدرس اینترنتی (URL) تصویر نمایش داده شده در نوار ابزار. این آدرس اینترنتی باید عمومی (public) باشد.

name

string

الزامی. نام افزونه‌ای که در نوار ابزار نمایش داده می‌شود.

openLinkUrlPrefixes[]

string

در صورتی که افزونه هرگونه لینک خروجی را نمایش دهد، چه در ویجت‌هایی که از OpenLink استفاده می‌کنند و چه در ویجت متنی که از تگ‌های لنگر HTML استفاده می‌کند، الزامی است. فهرستی از پیشوندهای URL HTTPS. برای محافظت از داده‌های کاربر، هر لینکی که توسط افزونه ارائه می‌شود باید با یکی از پیشوندهای موجود در این فهرست مطابقت داشته باشد.

برای جزئیات بیشتر به آدرس‌های مجاز فهرست آدرس‌ها مراجعه کنید.

universalActions[]

object ( UniversalAction )

فهرست اقدامات عمومی که همیشه در رابط کاربری افزونه در دسترس هستند.
useLocaleFromApp

boolean

اگر مقدار true ، اشیاء رویداد افزونه که به توابع فراخوانی اکشن یا توابع تریگر ارسال می‌شوند، شامل اطلاعات محلی و منطقه زمانی کاربر می‌شوند. مقدار پیش‌فرض آن false است.

برای جزئیات بیشتر به دسترسی به زبان و منطقه زمانی کاربر مراجعه کنید.

ویژگی‌های طرح‌بندی

پیکربندی‌ای که نوار ابزار افزونه‌ی Google Workspace و رنگ‌ها و ظاهر دکمه‌ها را کنترل می‌کند.

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

string

رنگ نوار ابزار. پیش‌فرض خاکستری (#۴۲۴۲۴۲).
secondaryColor

string

رنگ پیش‌فرض دکمه‌ها. در صورت تنظیم، رنگ اصلی پیش‌فرض است؛ در غیر این صورت، رنگ آبی پیش‌فرض است (#۲۱۹۶F۳).

یونیورسال اکشن

پیکربندی برای یک اقدام جهانی . وقتی انتخاب شود، یک اقدام جهانی یا لینک URL مشخص شده را باز می‌کند، یا تابع Apps Script مشخص شده را اجرا می‌کند.

نمایش JSON 
{
  "label": string,

  // Union field rule can be only one of the following:
  "openLink": string,
  "runFunction": string,
  // End of list of possible types for union field rule.

}
فیلدها
label

string

برای هر اقدام عمومی الزامی است. متنی که در منوی رابط کاربری برای این اقدام نمایش داده می‌شود.
runFunction

string

در صورت عدم وجود openLink برای هر اقدام عمومی الزامی است. در صورت وجود، نام تابع Apps Script که هنگام انتخاب این اقدام توسط کاربر اجرا می‌شود.

برای جزئیات بیشتر به راهنمای اقدامات جهانی مراجعه کنید.