با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
روال ساخت یک افزونه Google Workspace که راه حل های کنفرانس شخص ثالث Google Calendar را ارائه می دهد، اساساً با رویه ساخت افزونه های Google Workspace ، با چند مرحله اضافی (به صورت پررنگ در زیر نشان داده شده است) یکسان است:
سرویس پیشرفته Calendar به شما امکان می دهد مستقیماً از یک پروژه Apps Script با Calendar API تماس بگیرید. برخی از عملیات متداول مانند همگام‌سازی رویداد تقویم فقط با استفاده از سرویس پیشرفته قابل انجام است. قبل از اینکه بتوانید از سرویس پیشرفته استفاده کنید، باید آن را برای پروژه الحاقی خود فعال کنید.
مانیفست افزودنی اطلاعات اولیه ای را که Google Calendar برای نمایش و فعال کردن راه حل های کنفرانس افزودنی به درستی نیاز دارد، ارائه می دهد. مانیفست الحاقی شما باید (در بخش calendar خود) یک یا چند راه حل کنفرانس را تعریف کند که انواع کنفرانس های شخص ثالث را که رویدادهای تقویم Google می تواند استفاده کند، توصیف می کند.
برای جزئیات در مورد نحوه پیکربندی مانیفست افزونه خود به Manifests مراجعه کنید.
برای ایجاد و همگام سازی کنفرانس ها کد اضافه کنید
هنگامی که یک پروژه اسکریپت ایجاد کردید، می توانید اضافه کردن کد را برای تعریف رفتار مربوط به کنفرانس افزونه آغاز کنید. برای کنترل این رفتار می‌توانید از سرویس پیشرفته تقویم ، سرویس ConferenceData و سایر سرویس‌های Apps Script استفاده کنید.
هنگام کدنویسی برای دستورالعمل های نحوه طراحی تجربه کاربری افزونه خود، به راهنمای سبک افزودنی مراجعه کنید.
ایجاد کنفرانس
افزونه شما باید بتواند اطلاعات رویداد تقویم Google را دریافت کند و از آن برای ایجاد کنفرانس در سیستم کنفرانس شخص ثالث استفاده کند. شما باید یک یا چند روش onCreateFunction را که این فرآیند را اجرا می کنند، پیاده سازی کنید و این روش ها را در مانیفست افزودنی خود پیکربندی کنید.
پس از ایجاد یک کنفرانس و پیوند به یک رویداد تقویم Google، کنفرانس اغلب نیاز به به روز رسانی دارد تا تغییرات رویداد را منعکس کند. برای مثال، اگر کاربر زمان رویداد را تغییر دهد، داده‌های کنفرانس در سیستم کنفرانس شخص ثالث باید به‌روزرسانی شود تا این موضوع را منعکس کند. فرآیند به‌روزرسانی داده‌های کنفرانس در پاسخ به تغییرات رویداد، همگام‌سازی نامیده می‌شود.
ممکن است بخواهید تنظیمات اختیاری داشته باشید که به کاربران امکان می دهد افزونه شما را پیکربندی کنند. به عنوان مثال، ممکن است بخواهید به کاربران اجازه دهید پارامترهای کنفرانس یا یادداشت هایی را که به کنفرانس پیوست شده اند را تنظیم کنند.
هر زمان که بخواهید درجاتی از کنترل رفتار افزونه را در اختیار کاربران قرار دهید، می توانید آن گزینه ها را در صفحه تنظیمات افزونه ارائه دهید. این یک صفحه وب است (چه توسط اسکریپت افزونه میزبانی می شود یا به صورت خارجی میزبانی می شود) که زمانی باز می شود که کاربر به تنظیمات افزونه در رابط کاربری Google Calendar دسترسی پیدا کند.
ایجاد صفحه تنظیمات افزونه اختیاری است. برای جزئیات بیشتر، به افزودن تنظیمات مراجعه کنید.
تاریخ آخرین به‌روزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین به‌روزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThis guide outlines the process of building a Google Workspace add-on that integrates third-party conferencing solutions into Google Calendar, primarily for conference providers.\u003c/p\u003e\n"],["\u003cp\u003eThe development process involves enabling the Calendar advanced service, defining conference solutions within the add-on's manifest, and writing code to manage conference creation and synchronization with Google Calendar events.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers need to implement code to handle conference creation based on Google Calendar event details and ensure synchronization between the third-party system and Google Calendar to reflect event updates.\u003c/p\u003e\n"],["\u003cp\u003eAdd-ons can optionally include a settings page to allow users to customize conference parameters or add notes, enhancing user control and flexibility.\u003c/p\u003e\n"],["\u003cp\u003eThe guide builds upon the general Google Workspace add-on development process, focusing on the conferencing-specific steps and considerations.\u003c/p\u003e\n"]]],["To build a Google Workspace add-on for third-party conferencing in Google Calendar, you must first enable the Calendar advanced service. Then, define your conference solutions in the add-on manifest. Use Apps Script's Calendar and ConferenceData services to manage conferencing behavior. This includes implementing `onCreateFunction` methods to create conferences and code to synchronize calendar event changes with the third-party system. Optionally, add a settings page for user customization. Finally, test and publish the add-on.\n"],null,["# Building conferencing add-ons\n\n| **Note:** This functionality was built for conference providers specifically, and was originally available as *[Calendar conferencing add-ons](/workspace/add-ons/guides/glossary#calendar_conferencing_add-on)*.\n\nThe procedure to build a Google Workspace add-on that\nprovides Google Calendar third-party conferencing solutions is essentially the\nsame as the\n[procedure for building Google Workspace add-ons](/workspace/add-ons/how-tos/building-workspace-addons),\nwith a few additional steps (shown in bold below):\n\n1. Choose an add-on project owner and collaborators.\n2. Create an Apps Script project.\n3. Design your add-on appearance and behavior.\n4. **[Enable the Calendar advanced service](/apps-script/guides/services/advanced#enable_advanced_services)**.\n5. Configure the add-on project manifest.\n 1. **[Define conference solutions in the manifest](#define_conference_solutions_in_the_manifest).**\n6. Write code to define the add-on's appearance and behavior, using the built-in Apps Script [Card service](/apps-script/reference/card-service/card-service).\n 1. **[Write code to manage conference solutions](#add_code_to_create_and_sync_conferences),\n using Apps Script's built-in\n [`ConferenceData`](/apps-script/reference/conference-data)\n service**.\n 2. **(Optional) [Create and configure an add-on settings page](#add_settings).**\n7. Verify your add-on's OAuth scopes.\n8. Test the add-on within the [host applications](/workspace/add-ons/guides/glossary#host_or_host_application) it extends.\n9. Publish the add-on.\n\nThis page provides a general overview of each of the new steps (see\n[Building Google Workspace add-ons](/workspace/add-ons/how-tos/building-workspace-addons)\nfor an overview of the other steps).\n\nEnable the Calendar advanced service\n------------------------------------\n\nThe [Calendar advanced service](/apps-script/advanced/calendar)\nlets you call the [Calendar API](/workspace/calendar/overview)\ndirectly from an Apps Script project. Some common operations\nsuch as [Calendar event syncs](#sync_calendar_changes) can only\nbe performed using the advanced service. Before you can use the advanced\nservice, you must enable it for your add-on project.\n\nYou can\n[enable the Calendar advanced service](/apps-script/guides/services/advanced#enable_advanced_services)\nfrom the Apps Script editor. Be sure to enable the API in *both* the editor\n**Advanced Google Services** dialog and the Google API console.\n| **Note:** For consistency and accuracy, it's best to use either the Calendar advanced service or the [built-in Calendar service](/apps-script/reference/calendar), not both. If you enable the Calendar advanced service, use it exclusively throughout your code.\n\nDefine conference solutions in the manifest\n-------------------------------------------\n\nThe add-on manifest provides the basic information that Google Calendar needs\nto display and activate the add-on conference solutions correctly. Your add-on\nmanifest must define (in its\n[`calendar` section](/apps-script/manifest/calendar-addons))\none or more conference solutions that describe the types of third-party\nconferences Google Calendar events can use.\n\nSee [Manifests](/workspace/add-ons/concepts/workspace-manifests) for details\non how to configure your add-on's manifest.\n\nAdd code to create and sync conferences\n---------------------------------------\n\nOnce you have created a script project, you can begin adding\ncode to define the add-on's conferencing-related behavior. You can use the\n[Calendar advanced service](/apps-script/advanced/calendar),\nthe [ConferenceData service](/apps-script/reference/conference-data), and\nother Apps Script services to control this behavior.\n\nAs you add conference handling code to your add-on, you must add code to\n[create conferences](#creating_conferences),\n[sync calendar changes](#sync_calendar_changes), and optionally\n[add a settings page](#sync_calendar_changes).\n\nRefer to the\n[add-on style guide](/workspace/add-ons/guides/workspace-style) as you code\nfor guidelines on how to design your add-on user experience.\n\n### Creating conferences\n\nYour add-on must be able to take information about the Google Calendar event\nand use it to create a conference on the third-party conference system. You\nmust implement one or more `onCreateFunction` methods that execute this\nprocess, and configure these methods in your add-on manifest.\n\nFor more details, see\n[Create third-party conferences](/workspace/add-ons/calendar/conferencing/create-conference).\n\n### Sync calendar changes\n\nAfter a conference is created and linked to a Google Calendar event, the\nconference often needs to be updated to reflect changes in the event. For\nexample, if a user changes the time of the event, the conference data in\nthe third-party conferencing system needs to be updated to reflect this.\nThe process of updating the conference data in response to event changes\nis called *syncing*.\n\nFor more details, see\n[Sync calendar changes](/workspace/add-ons/calendar/conferencing/sync-calendar-changes).\n\nAdd settings\n------------\n\nYou may wish to have optional settings that let users configure your add-on.\nFor example, you may want to let users to set conference parameters or notes\nthat are attached to the conference.\n\nWhenever you want to provide users some degree of control over the add-on\nbehavior, you can provide those options in an add-on settings page. This is\na web page (either hosted by the add-on script or else hosted externally) that\nis opened when the user accesses the add-on settings within the Google Calendar\nUI.\n\nCreating an add-on settings page is optional. For more details, see\n[Add settings](/workspace/add-ons/calendar/conferencing/add-settings)."]]
