جارٍ إضافة إعدادات الإضافات الخاصة بمكالمات الفيديو
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تحتوي إضافات Google Workspace التي توفّر حلولاً للاجتماعات غالبًا على تفاصيل يجب أن يتحكّم فيها المستخدم من صفحة إعدادات الإضافة. على سبيل المثال، من الشائع أن يتضمّن النظام زرًا أو عنصر تحكّم
يسمح للمستخدم بتسجيل الخروج من نظام المؤتمرات التابع لجهة خارجية.
صفحات إعدادات الإضافات اختيارية. توضّح الأقسام التالية كيفية فتح صفحة إعدادات إضافة وكيفية إنشاء صفحة إعدادات.
فتح إعدادات الإضافة
يمكنك فتح صفحة إعدادات إضافة مثبَّتة باتّباع الخطوات التالية:
في لوحة التنقّل اليمنى، انقر على الإضافات للانتقال إلى قائمة الإضافات المثبَّتة.
انقر على زر الإعدادات الذي يظهر على يسار اسم الإضافة
لفتح صفحة الإعدادات الخاصة بهذه الإضافة، ما يؤدي إلى أن يفتح "تقويم Google"
عنوان URL لصفحة الإعدادات.
إذا لم تحدّد الإضافة صفحة إعدادات، لن يظهر زر الإعدادات.
إنشاء صفحة إعدادات
يتم إنشاء صفحة الإعدادات بشكل عام باستخدام HTML وCSS العاديين. عند تصميم صفحتك، اتّبِع إرشادات أسلوب الإضافات.
عندما يجري المستخدم تعديلات على إعدادات الإضافة، يجب أن ترسل الصفحة طلبات إلى نظام المؤتمرات التابع لجهة خارجية لتنفيذ هذه التغييرات حسب الاقتضاء. يمكن للصفحة أيضًا تخزين المعلومات واسترجاعها من خصائص المستخدم لمشروع الإضافة حسب الحاجة.
مستضافة على خادم ويب خارجي
يمكنك استضافة صفحة إعدادات الإضافة خارجيًا من مشروع نص برمجي للإضافة، ربما كجزء من موقع إلكتروني تابع لجهة خارجية خاص بمكالمات الفيديو.
لربط إضافة بصفحة إعدادات خارجية، عليك اتّباع الخطوات التالية:
إنشاء الصفحة واستضافتها خارجيًا عند إضافة عناصر إلى الصفحة،
احرص على أن تتواصل بشكل صحيح مع نظام المؤتمرات
التابع لجهة خارجية وأن تجري التغييرات المناسبة للمستخدم.
في مشروع نص برمجي للإضافة، نفِّذ دالة تعرض عنوان URL
للصفحة الخارجية.
حدِّد اسم هذه الدالة كحقل calendar.createSettingsFunction في بيان مشروع الإضافة.
مستضافة ضمن "برمجة تطبيقات Google"
يمكنك توفير صفحة إعدادات للإضافة باستخدام تطبيق ويب في "برمجة التطبيقات". وباعتبارها تطبيق ويب، يمكن لمشروع البرنامج النصي للإضافة إنشاء الصفحة ونشرها، ثم تتم استضافتها على خوادم "برمجة التطبيقات".
راجِع دليل خدمة HTML
للحصول على تفاصيل حول كيفية إنشاء رمز HTML لتطبيقات الويب. يمكن لصفحة الإعدادات التواصل مع خوادم Google حسب الحاجة. يمكنك أيضًا الاستفادة من
النماذج في الصفحة لجعلها أكثر
ديناميكية.
تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eGoogle Workspace add-ons for conferencing can include optional settings pages built with standard HTML and CSS, hosted externally or within Apps Script.\u003c/p\u003e\n"],["\u003cp\u003eAdd-on settings allow users to control details like logging out of the third-party system and are accessed via Google Calendar's settings.\u003c/p\u003e\n"],["\u003cp\u003eWhen building an external settings page, ensure elements interact correctly with the conferencing system and the add-on manifest links to its URL.\u003c/p\u003e\n"],["\u003cp\u003eApps Script web apps offer an alternative hosting option, enabling communication with Google servers and dynamic content through templates.\u003c/p\u003e\n"],["\u003cp\u003eWhen using Apps Script for settings pages, maintain consistent project version numbers across deployments to ensure proper functionality.\u003c/p\u003e\n"]]],["Google Workspace add-ons with conferencing features can have optional settings pages. Users access these pages through Google Calendar's add-on settings. Developers build settings pages using HTML and CSS, hosted either externally or within Apps Script. The settings page should allow users to adjust add-on behaviors, communicating with the third-party system to enact changes, storing data in user properties. To link externally, developers specify the URL in the add-on's manifest file. For Apps Script, they use web apps and must maintain consistent project versions between the add-on and settings page.\n"],null,["# Adding conferencing add-on settings\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\nGoogle Workspace add-ons that add conferencing\nsolutions often have details that should be controlled by the user from an\nadd-on *settings page*. For example, it is common to have a button or control\nthat lets a user log out of the third-party conference system.\n\nAdd-on setting pages are optional. The following sections describe how to open\nan add-on's setting page and how to build a setting page.\n\nOpen add-on settings\n--------------------\n\nYou can open the settings page of an add-on you have installed by doing the\nfollowing:\n\n1. Open [Google Calendar](https://calendar.google.com/).\n2. Click the settings icon and select **Settings**.\n3. In the left navigation panel, select **add-ons** to jump to the installed add-on list.\n4. Click the **Settings** button that appears to the right of the add-on name to open the settings page for that add-on; this causes Google Calendar to open the settings page URL.\n\nIf an add-on does not define a settings page, the **Settings** button does not\nappear.\n\nBuild a settings page\n---------------------\n\nA settings page is generally built using standard HTML and CSS. When designing\nyour page, follow the\n[add-on style guidelines](/workspace/add-ons/guides/workspace-style).\n\nWhen a user makes adjustments to the add-on settings, the page should send\nrequests to the third-party conferencing system to enact those changes as\nappropriate. The page can also store and retrieve information from the add-on\nproject [user properties](/apps-script/reference/properties) as needed.\n\n### Hosted on an external web server\n\nYou can host your add-on setting page externally from the add-on script project,\nperhaps as part of the third-party conferencing website.\n\nTo link an add-on to an external setting page, you must do the following:\n\n1. Build the page and host it externally. When adding elements to the page, be sure that they communicate correctly with the third-party conferencing system and make the appropriate changes for that user.\n2. In the add-on script project, implement a function that returns the URL for the external page.\n3. Specify the name of this function as the `calendar.createSettingsFunction` field in the add-on project [manifest](/workspace/add-ons/concepts/workspace-manifests#manifest_structure_for_g_suite_add-ons).\n\n### Hosted within Apps Script\n\nYou can provide a settings page for your add-on by using an Apps Script\n[web app](/apps-script/guides/web). As a web app, your add-on script project\ncan build and deploy the page, which is then hosted on the Apps Script servers.\n\nSee the [HTML Service guide](/apps-script/guides/html#serve_html_as_a_web_app)\nfor details on how to build HTML for web apps. Your settings page can\n[communicate with the Google servers](/apps-script/guides/html/communication)\nas needed. You can also make use of\n[templates](/apps-script/guides/html/templates) in the page to make it more\ndynamic.\n\nThe\n[Calendar conferencing add-on example](/workspace/add-ons/samples/conferencing-sample)\nshows how to construct a web app settings page.\n| **Caution:** When deploying a web app page for use, you must provide a script project [version](/apps-script/guides/versions). You also provide a project version when deploying the add-on. As you update your script project to new versions, always be sure that the version number for the deployments matches. Otherwise your add-on may exhibit unexpected behavior."]]
