ساخت افزونه های کنفرانس

روال ساخت یک افزونه Google Workspace که راه حل های کنفرانس شخص ثالث Google Calendar را ارائه می دهد، اساساً مانند رویه ساخت افزونه های Google Workspace است، با چند مرحله اضافی (به صورت پررنگ در زیر نشان داده شده است):

  1. مالک و همکاران پروژه افزودنی را انتخاب کنید.
  2. یک پروژه Apps Script ایجاد کنید.
  3. ظاهر و رفتار افزودنی خود را طراحی کنید.
  4. سرویس پیشرفته تقویم را فعال کنید .
  5. مانیفست پروژه الحاقی را پیکربندی کنید.
    1. راه حل های کنفرانس را در مانیفست تعریف کنید .
  6. با استفاده از سرویس Apps Script Card داخلی، برای تعریف ظاهر و رفتار افزونه، کد بنویسید.
    1. برای مدیریت راه حل های کنفرانس، با استفاده از سرویس ConferenceData داخلی Apps Script ، کد بنویسید .
    2. (اختیاری) صفحه تنظیمات افزونه ایجاد و پیکربندی کنید .
  7. محدوده های OAuth افزونه خود را تأیید کنید.
  8. افزونه را در برنامه های میزبانی که گسترش می دهد آزمایش کنید.
  9. افزونه را منتشر کنید.

این صفحه یک نمای کلی از هر یک از مراحل جدید ارائه می دهد (برای مرور کلی مراحل دیگر به ساخت افزونه های Google Workspace مراجعه کنید).

سرویس پیشرفته تقویم را فعال کنید

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

می توانید سرویس پیشرفته Calendar را از ویرایشگر Apps Script فعال کنید . مطمئن شوید که API را هم در گفتگوی سرویس‌های پیشرفته ویرایشگر Google و هم در کنسول Google API فعال کنید.

راه حل های کنفرانس را در مانیفست تعریف کنید

مانیفست افزودنی اطلاعات اولیه ای را که Google Calendar برای نمایش و فعال کردن راه حل های کنفرانس افزودنی به درستی نیاز دارد، ارائه می دهد. مانیفست الحاقی شما باید (در بخش calendar خود) یک یا چند راه حل کنفرانس را تعریف کند که انواع کنفرانس های شخص ثالث را که رویدادهای تقویم Google می تواند استفاده کند، توصیف می کند.

برای جزئیات در مورد نحوه پیکربندی مانیفست افزونه خود به Manifests مراجعه کنید.

برای ایجاد و همگام سازی کنفرانس ها کد اضافه کنید

هنگامی که یک پروژه اسکریپت ایجاد کردید، می توانید اضافه کردن کد را برای تعریف رفتار مربوط به کنفرانس افزونه آغاز کنید. برای کنترل این رفتار می‌توانید از سرویس پیشرفته تقویم ، سرویس ConferenceData و سایر سرویس‌های Apps Script استفاده کنید.

همانطور که کد مدیریت کنفرانس را به افزونه خود اضافه می کنید، باید کدی را برای ایجاد کنفرانس ها ، همگام سازی تغییرات تقویم ، و به صورت اختیاری یک صفحه تنظیمات اضافه کنید .

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

ایجاد کنفرانس

افزونه شما باید بتواند اطلاعات رویداد تقویم Google را دریافت کند و از آن برای ایجاد کنفرانس در سیستم کنفرانس شخص ثالث استفاده کند. شما باید یک یا چند روش onCreateFunction را که این فرآیند را اجرا می کنند، پیاده سازی کنید و این روش ها را در مانیفست افزودنی خود پیکربندی کنید.

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

همگام سازی تغییرات تقویم

پس از ایجاد یک کنفرانس و پیوند به یک رویداد تقویم Google، کنفرانس اغلب نیاز به به روز رسانی دارد تا تغییرات رویداد را منعکس کند. برای مثال، اگر کاربر زمان رویداد را تغییر دهد، داده‌های کنفرانس در سیستم کنفرانس شخص ثالث باید به‌روزرسانی شود تا این موضوع را منعکس کند. فرآیند به‌روزرسانی داده‌های کنفرانس در پاسخ به تغییرات رویداد، همگام‌سازی نامیده می‌شود.

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

تنظیمات را اضافه کنید

ممکن است بخواهید تنظیمات اختیاری داشته باشید که به کاربران امکان می دهد افزونه شما را پیکربندی کنند. به عنوان مثال، ممکن است بخواهید به کاربران اجازه دهید پارامترهای کنفرانس یا یادداشت هایی را که به کنفرانس پیوست شده اند را تنظیم کنند.

هر زمان که بخواهید درجاتی از کنترل رفتار افزونه را در اختیار کاربران قرار دهید، می توانید آن گزینه ها را در صفحه تنظیمات افزونه ارائه دهید. این یک صفحه وب است (چه توسط اسکریپت افزونه میزبانی می شود یا به صورت خارجی میزبانی می شود) که زمانی باز می شود که کاربر به تنظیمات افزونه در رابط کاربری Google Calendar دسترسی پیدا کند.

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