غالبًا ما تتضمّن إضافات Google Workspace التي تضيف حلول مكالمات الفيديو تفاصيل يجب أن يتحكّم بها المستخدم من صفحة إعدادات الإضافات. على سبيل المثال، من الشائع أن يتوفّر زر أو عنصر تحكّم يتيح للمستخدم تسجيل الخروج من نظام المؤتمرات التابع لجهة خارجية.
إنّ صفحات إعدادات الإضافة اختيارية. توضّح الأقسام التالية كيفية فتح صفحة إعدادات إحدى الإضافات وكيفية إنشاء صفحة إعدادات.
فتح إعدادات الإضافة
يمكنك فتح صفحة الإعدادات لأي إضافة ثبّتها باتّباع الخطوات التالية:
- افتح تقويم Google.
- انقر على رمز واختَر الإعدادات.
- في لوحة التنقّل اليمنى، انقر على الإضافات للانتقال إلى قائمة الإضافات المثبَّتة.
- انقر على زر الإعدادات الذي يظهر على يسار اسم الإضافة لفتح صفحة الإعدادات لهذه الإضافة، ويؤدي إلى فتح "تقويم Google" لعنوان URL لصفحة الإعدادات.
إذا لم تحدِّد إحدى الإضافات صفحة إعدادات، لن يظهر الزر الإعدادات.
إنشاء صفحة إعدادات
يتم إنشاء صفحة الإعدادات بشكل عام باستخدام HTML وCSS العاديَين. عند تصميم صفحتك، اتّبِع إرشادات أسلوب الإضافة.
عندما يُجري المستخدم تعديلات على إعدادات الإضافة، يُفترض أن ترسل الصفحة طلبات إلى نظام مكالمات الفيديو التابع لجهة خارجية لتنفيذ هذه التغييرات على النحو المناسب. ويمكن للصفحة أيضًا تخزين المعلومات واستردادها من خصائص المستخدمين لمشروع الإضافة حسب الحاجة.
مستضافة على خادم ويب خارجي
يمكنك استضافة صفحة إعدادات الإضافة خارجيًا من مشروع نص الإضافة، ربما كجزء من الموقع الإلكتروني لخدمة مكالمات الفيديو التابعة لجهة خارجية.
لربط إضافة بصفحة إعدادات خارجية، عليك اتّباع الخطوات التالية:
- أنشئ الصفحة واستضِفها خارجيًا. عند إضافة عناصر إلى الصفحة، تأكّد من أنّها تتواصل بشكل صحيح مع نظام المراسلة التابعة لجهة خارجية وأنّك أجريت التغييرات المناسبة لهذا المستخدم.
- في مشروع النص البرمجي للإضافات، نفِّذ دالة تعرض عنوان URL للصفحة الخارجية.
- حدِّد اسم هذه الدالة على أنّه حقل
calendar.createSettingsFunctionفي manifest مشروع الإضافة.
مستضافة داخل "برمجة تطبيقات Google"
يمكنك توفير صفحة إعدادات للإضافات باستخدام تطبيق ويب في "برمجة التطبيقات". وبصفته تطبيق ويب، يمكن لمشروع البرنامج النصي للإضافات إنشاء الصفحة ونشرها، ويتم استضافتها بعد ذلك على خوادم "برمجة التطبيقات".
راجِع دليل خدمة HTML للحصول على تفاصيل حول كيفية إنشاء ترميز HTML لتطبيقات الويب. يمكن لصفحة الإعدادات التواصل مع خوادم Google حسب الحاجة. يمكنك أيضًا الاستفادة من النماذج في الصفحة لجعلها أكثر ديناميكية.
يعرض مثال إضافة اجتماعات "تقويم Google" كيفية إنشاء صفحة إعدادات لتطبيق ويب.