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

پیکربندی منبعی که برای تعریف محتوا و رفتار افزونه 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، تقویم را توسعه دهد، الزامی است . پیکربندی‌های ظاهری و رفتاری در برنامه‌ی میزبان تقویم گوگل. در صورت حذف، افزونه در تقویم گوگل غیرفعال می‌شود.

chat

object ()

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

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

drive

object ( Drive )

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

gmail

object ( Gmail )

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

docs

object ( Docs )

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

sheets

object ( Sheets )

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

slides

object ( Slides )

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

meet

object ( Meet )

در صورتی که افزونه‌ی Google Workspace، Meet را توسعه دهد، الزامی است . پیکربندی‌های ظاهر و رفتار در برنامه‌ی میزبان 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

الزامی. نشانی اینترنتی عمومی تصویر نوار ابزار.

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

نمایش 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 که هنگام انتخاب اجرا می‌شود.

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