منبع مانیفست جیمیل

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

جیمیل

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

نمایش JSON 
{
  "authorizationCheckFunction": string,
  "composeTrigger": {
    object (ComposeTrigger)
  },
  "contextualTriggers": [
    {
      object (ContextualTrigger)
    }
  ],
  "homepageTrigger": {
    object (HomepageTrigger)
  }
}
فیلدها
authorizationCheckFunction

string

منسوخ شده. نام یک تابع Apps Script که بررسی‌های مربوط به الزامات مجوز شخص ثالث را انجام می‌دهد. این تابع قبل از هر بار فراخوانی افزونه‌ی Google Workspace فراخوانی می‌شود.

این تابع برای جلوگیری از تأخیر اجرای غیرضروری منسوخ شده است. در عوض، افزونه باید همانطور که در این مثال نشان داده شده است، از فراخوانی اصلی یک استثنا ایجاد کند.

composeTrigger

object ( ComposeTrigger )

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

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

contextualTriggers[]

object ( ContextualTrigger )

الزامی. فهرستی از محرک‌هایی که هنگام باز شدن یک پیام در Gmail فعال می‌شوند. وقتی محرک فعال می‌شود، یک تابع خاص Apps Script را اجرا می‌کند، معمولاً برای ایجاد کارت‌های جدید و به‌روزرسانی رابط کاربری.
homepageTrigger

object ( HomepageTrigger )

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

ComposeTrigger

پیکربندی برای یک عمل نوشتن. برای اطلاعات بیشتر به توسعه رابط کاربری نوشتن مراجعه کنید.

نمایش JSON 
{
  "draftAccess": string,
  "selectActions": [
    {
      object (SelectAction)
    }
  ]
}
فیلدها
draftAccess

string

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

  • NONE ، تنظیم پیش‌فرض. این باعث می‌شود شیء رویداد ارسالی به تابع تریگر compose تقریباً خالی باشد.
  • METADATA ، که شیء رویداد ارسال شده به تابع تریگر نوشتن را با فهرست گیرندگان پیام پر می‌کند. این تنظیم مستلزم آن است که افزونه شامل دامنه gmail.addons.current.message.metadata باشد.
selectActions[]

object ( SelectAction )

فهرستی از اقدامات نوشتن که رابط‌های کاربری نوشتن را ایجاد می‌کنند؛ با این حال، این فهرست به یک اقدام واحد برای هر افزونه محدود می‌شود. اقدام نوشتن دارای یک آیکون مربوطه است که در پنجره نوشتن Gmail نمایش داده می‌شود. این آیکون توسط gmail.logoUrl مشخص شده است.

محرک زمینه‌ای

پیکربندی مربوط به تریگری که وقتی کاربر یک پیام Gmail را باز می‌کند و آن پیام معیارهای خاصی را برآورده می‌کند، فعال می‌شود. برای اطلاعات بیشتر به بخش «توسعه رابط کاربری پیام» مراجعه کنید.

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

string

برای هر تریگر زمینه‌ای الزامی است. نام تابع Apps Script که هنگام فعال شدن تریگر اجرا می‌شود.

برای جزئیات بیشتر در مورد نحوه تعریف این تابع ، به تابع تریگر متنی مراجعه کنید.

unconditional

object

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

انتخاب اقدام

پیکربندی عمل نوشتن که تعریف می‌کند وقتی کاربر عمل نوشتن را انتخاب می‌کند، کدام تابع اجرا شود.

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

string

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

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

text

string

برای اقدامات نوشتن الزامی است. شرح متنی کوتاهی از این اقدام نوشتن.