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

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

جیمیل

پیکربندی مانیفست افزونه Google Workspace برای برنامه‌های افزودنی Gmail. برای اطلاعات بیشتر به گسترش Gmail با افزونه‌های 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 خاص را اجرا می کند، معمولاً برای ایجاد کارت های جدید و به روز رسانی UI.
homepageTrigger

object ( HomepageTrigger )

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

ComposeTrigger

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

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

string

سطح دسترسی به داده های موجود برای یک تابع آغازگر نوشتن را مشخص می کند. گزینه های معتبر به شرح زیر است:

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

object ( SelectAction )

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

ContextualTrigger

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

نمایندگی JSON
{
  "onTriggerFunction": string,
  "unconditional": {},
}
زمینه های
onTriggerFunction

string

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

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

unconditional

object

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

SelectAction

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

نمایندگی JSON
{
  "runFunction": string,
  "text": string
}
زمینه های
runFunction

string

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

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

text

string

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