منبع مانیفست تقویم

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

تقویم

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

نمایش JSON 
{
  "createSettingsUrlFunction": string,
  "conferenceSolution": [
    {
      object (ConferenceSolution)
    }
  ],
  "currentEventAccess": string,
  "eventOpenTrigger": {
    object (EventOpenTrigger)
  },
  "eventUpdateTrigger": {
    object (EventUpdateTrigger)
  },
  "eventAttachmentTrigger": {
    object (EventAttachmentTrigger)
  },
  "homepageTrigger": {
    object (HomepageTrigger)
  }
}
فیلدها
createSettingsUrlFunction

string

فقط در صورتی استفاده می‌شود که افزونه، راهکارهای کنفرانس ارائه دهد. اختیاری. نام تابع Apps Script که URL ای تولید می‌کند که به صفحه تنظیمات افزونه منتهی می‌شود.

برای جزئیات بیشتر ، به افزودن تنظیمات افزونه کنفرانس مراجعه کنید.
conferenceSolution[]

object ( ConferenceSolution )

فقط در صورتی استفاده می‌شود که افزونه، راهکارهای کنفرانس ارائه دهد؛ حداقل یک راهکار باید تعریف شود. راهکارهای کنفرانس ارائه شده توسط افزونه. هر راهکار به عنوان یک گزینه در رابط کاربری تقویم **ویرایش رویداد** ظاهر می‌شود.
currentEventAccess

string

سطح دسترسی افزونه به داده‌های رویداد را تعیین می‌کند. در صورت حذف، میزبان فراداده رویداد را ارسال نمی‌کند. تنظیمات معتبر عبارتند از:

  • METADATA : دسترسی به فراداده‌های اولیه رویدادها.
  • READ : دسترسی به خواندن داده‌های رویداد و فراداده‌ها.
  • WRITE : دسترسی به نوشتن داده‌های رویداد.
  • READ_WRITE : دسترسی به خواندن و نوشتن داده‌های رویداد و فراداده.

اگر روی READ یا READ_WRITE تنظیم شده باشد، افزونه باید شامل محدوده‌ی https://www.googleapis.com/auth/calendar.addons.current.event.read باشد.

اگر روی WRITE یا READ_WRITE تنظیم شده باشد، افزونه باید شامل محدوده‌ی https://www.googleapis.com/auth/calendar.addons.current.event.write باشد.

eventOpenTrigger

object ( EventOpenTrigger )

مشخصات تریگر برای تریگرهای باز شدن رویداد در تقویم.

eventUpdateTrigger

object ( EventUpdateTrigger )

برای ارائه رابط‌های به‌روزرسانی رویداد زمینه‌ای در تقویم الزامی است . مشخصات تریگر برای تریگرهای به‌روزرسانی رویداد.

eventAttachmentTrigger

object ( EventAttachmentTrigger )

مشخصات تریگر برای تریگرهای پیوست رویداد در تقویم.

homepageTrigger

object ( HomepageTrigger )

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

راهکار کنفرانس

این شیء مانیفست فقط برای افزونه‌هایی که تقویم را با راه‌حل‌های کنفرانس شخص ثالث گسترش می‌دهند، مورد نیاز است.

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

نمایش JSON 
{
  "id": string,
  "logoUrl": string,
  "name": string,
  "onCreateFunction": string
}
فیلدها
id

string

الزامی . یک شناسه برای راهکار کنفرانس. این شناسه باید در مجموعه راهکارهای کنفرانس منحصر به فرد باشد. پس از انتخاب، شناسه را تغییر ندهید.
logoUrl

string

پیوندی به آیکون راه‌حل. تصویر باید ۹۶ در ۹۶ نقطه در اینچ باشد.

تصویر باید در زیرساخت گوگل میزبانی شود. برای جزئیات بیشتر به بخش ارائه لوگوهای راهکار کنفرانس مراجعه کنید.

این تصویر می‌تواند با calendar.logoUrl افزونه متفاوت باشد. اگر برای یک راه‌حل خاص حذف شود، اسکریپت calendar.logoUrl استفاده می‌کند.
name

string

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

string

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

رویدادبازراه‌انداز

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

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

string

نام تابع Apps Script که هنگام باز شدن یک رویداد تقویم توسط کاربر اجرا می‌شود. این تابع باید آرایه‌ای از اشیاء Card را برای رابط کاربری برگرداند.

رویدادبه‌روزرسانی تریگر

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

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

string

نام تابع Apps Script که هنگام ذخیره یک رویداد ویرایش‌شده در تقویم توسط کاربر اجرا می‌شود. این تابع باید آرایه‌ای از اشیاء Card را برای رابط کاربری برگرداند.

رویداد پیوست تریگر

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

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

string

الزامی. نام تابع Apps Script که هنگام انتخاب ارائه‌دهنده توسط کاربر اجرا می‌شود. این تابع باید آرایه‌ای از اشیاء Card را برای رابط کاربری برگرداند.
label

string

الزامی. متن منو که ارائه‌دهنده‌ی پیوست را مشخص می‌کند.