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

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

تقویم

پیکربندی مانیفست افزونه Google Workspace برای برنامه‌های افزودنی Google Calendar. برای اطلاعات بیشتر به «توسعه تقویم با افزونه‌های 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 )

فقط در صورتی استفاده می شود که افزونه راه حل های کنفرانس ارائه دهد. اگر چنین است، حداقل یک راه حل باید تعریف شود. لیستی از راه حل های کنفرانس ارائه شده توسط افزونه. هر راه حل دارای یک گزینه کنفرانس مربوطه است که در رابط کاربری ویرایش رویداد تقویم Google ارائه شده است.
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 scope داشته باشد.

eventOpenTrigger

object ( EventOpenTrigger )

مشخصات ماشه برای محرک‌های باز رویداد در تقویم.

eventUpdateTrigger

object ( EventUpdateTrigger )

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

eventAttachmentTrigger

object ( EventAttachmentTrigger )

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

homepageTrigger

object ( HomepageTrigger )

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

راه حل کنفرانس

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

نمایندگی JSON
{
  "id": string,
  "logoUrl": string,
  "name": string,
  "onCreateFunction": string
}
زمینه های
id

string

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

string

پیوندی به نمادی که راه حل را نشان می دهد. اندازه تصویر باید 96*96 dp باشد.

این نمی تواند یک URL دلخواه باشد — تصویر باید در زیرساخت Google میزبانی شود. برای جزئیات بیشتر به ارائه آرم راه حل کنفرانس مراجعه کنید.

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

string

ضروری . نام راه حل کنفرانس که در رابط کاربری Google Calendar هنگام ایجاد یا ویرایش یک رویداد توسط کاربر نشان داده می شود.
onCreateFunction

string

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

EventOpenTrigger

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

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

string

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

EventUpdateTrigger

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

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

string

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

EventAttachmentTrigger

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

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

string

ضروری. نام تابع Apps Script که وقتی کاربر ارائه دهنده پیوست افزونه را در منوی کشویی Calendar انتخاب می کند اجرا می شود. شما باید این تابع را برای ایجاد و بازگرداندن آرایه ای از اشیاء Card برای نمایش در رابط کاربری افزونه پیاده سازی کنید.
label

string

ضروری. متنی که در منوی کشویی Calendar ظاهر می‌شود و این ارائه‌دهنده پیوست را مشخص می‌کند.