يمكن أن توفر "إضافات Google Workspace" واجهات مخصصة أثناء عرض المستخدم للتقاويم وأحداث "تقويم Google" أو تعديلها. يتيح لك ذلك تزويد المستخدم بمعلومات إضافية ذات صلة، وتنفيذ المهام تلقائيًا، وربط أنظمة الجهات الخارجية بـ "تقويم Google".
عند إنشاء واجهة إضافية لـ "تقويم Google"، يمكنك توفير صفحة رئيسية. يمكنك استخدام نفس الصفحة الرئيسية لمضيفين متعددين، أو تصميم مضيف محدد لتقويم Google.
ويمكن للإضافة أيضًا تحديد واجهة تظهر عندما يفتح المستخدم حدثًا في "تقويم Google".
الوصول إلى واجهة مستخدم الإضافة
استنادًا إلى طريقة فتحها، يمكن لإضافة Google Workspace تحديد واجهة صفحة رئيسية أو واجهة حدث في "تقويم Google" أو واجهة اختيار مرفق أو جميعها ثلاثة:
- إذا نقر أحد المستخدمين على رمز الإضافة أثناء عرض التقويم، ستنفذ الإضافة
دالة
calendar.homepageTriggerالمناظرة (إذا كانت متوفّرة). تنشئ هذه الدالة بطاقة صفحة رئيسية وترجعها إلى التقويم للعرض. إذا لم يتم تحديد دالةcalendar.homepageTrigger، سيتم عرض بطاقة صفحة رئيسية عامة بدلاً منها. - إذا فتح المستخدم حدثًا في "تقويم Google" ثم نقر على رمز الإضافة، أو
كانت الإضافة مفتوحة عندما يفتح المستخدم حدثًا، تنفِّذ الإضافة
دالة
eventOpenTriggerالمقابلة (إذا كانت متوفّرة). تنشئ هذه الدالة واجهة حدث التقويم للإضافة وتعود إلى تقويم Google للعرض. - إذا كانت الإضافة تحدّد وظيفة
eventAttachmentTrigger، ستظهر الإضافة كموفّر مرفقات عندما ينقر المستخدم على إضافة مرفق أثناء تعديل حدث في "تقويم Google". عند اختيار الإضافة، تنشئ الدالةeventAttachmentTriggerواجهة اختيار مرفق الإضافة وتعيدها إلى "تقويم Google" لعرضها.
إنشاء واجهة "تقويم Google" الإضافية
يمكنك توسيع نطاق "تقويم Google" باستخدام "إضافة Google Workspace" باتّباع الخطوات التالية:
- حدِّد ما إذا كنت تريد أن يكون للإضافة صفحة رئيسية خاصة بـ "تقويم Google". ويمكنك أيضًا تحديد ما إذا كنت تريد توفير واجهة مخصّصة أثناء تعديل المستخدم لأحداث "تقويم Google".
- أضِف حقلَي
addOns.commonوaddOns.calendarالمناسبين إلى بيان مشروع النص البرمجي للإضافة، بما في ذلك أي نطاقات مطلوبة. - إذا كنت توفّر صفحة رئيسية خاصة بـ "تقويم Google"،
يمكنك تنفيذ وظيفة
calendar.homepageTriggerلإنشاء هذه الواجهة. يمكنك أيضًا اختيار استخدام واجهةcommon.homepageTriggerلمضيفي Google Workspace متعددين. - إذا كنت توفر واجهة حدث في "تقويم Google"، يجب تنفيذ وظيفة
calendar.eventOpenTriggerلإنشاء هذه الواجهة. يُرجى الاطّلاع على توسيع واجهة حدث "تقويم Google" للحصول على التفاصيل. - تنفيذ وظائف معاودة الاتصال المرتبطة اللازمة للاستجابة لتفاعلات واجهة المستخدم، مثل النقرات على الأزرار.
الصفحات الرئيسية للتقويم
يتيح "تقويم Google" عرض الصفحات الرئيسية في "إضافات Google Workspace".
لعرض الصفحة الرئيسية الشائعة للإضافات في "تقويم Google"، ما عليك سوى التأكد من أنّ هناك
حقل addOns.calendar
في بيان الإضافة.
يمكنك بدلاً من ذلك إضافة calendar.homepageTrigger إلى بيان الإضافة لتوفير صفحة رئيسية خاصة بـ "تقويم Google".
في كلتا الحالتين، يجب عليك تقديم اسم دالة مشغل الصفحة الرئيسية في
مشروع النص البرمجي للإضافة. يتم استدعاء هذه الدالة تلقائيًا لإنشاء
الصفحة الرئيسية لتقويم Google عند الحاجة. عليك تنفيذ هذه الدالة لإنشاء وعرض عنصر Card واحد أو مصفوفة من كائنات Card التي تشكِّل الصفحة الرئيسية. يتم تمرير دالة تشغيل الصفحة الرئيسية كائن حدث كمَعلمة تحتوي على بعض المعلومات العامة مثل النظام الأساسي للعميل. ويمكنك استخدام بيانات كائن الحدث لتخصيص إنشاء الصفحة الرئيسية.
توسيع واجهة حدث "تقويم Google"
يعتمد "تقويم Google" على مشغِّل سياقي لتحديد الواجهة (إن وجدت) التي سيتم عرضها عندما يعدّل المستخدم حدث في "تقويم Google". عندما يتم تنشيط
عامل التفعيل، يتم تنفيذ دالة المشغِّل السياقي المحدّدة في الحقل
calendar.eventOpenTrigger
في بيان الإضافة.
عليك تنفيذ الدالة المُسمّاة في الحقل
calendar.eventOpenTrigger. تقبل هذه الدالة كائن حدث كوسيطة، ويجب أن تعرض كائن Card واحدًا أو مصفوفة من عناصر Card لكي يعرضها "تقويم Google" أثناء فتح الحدث للمستخدم.
كائنات الأحداث
يتم إنشاء كائن حدث وتمريره إلى
دالة المشغِّل السياقي calendar.eventOpenTrigger
عندما يفتح المستخدم حدث في "تقويم Google". يمكن لدالة المشغّل استخدام المعلومات الواردة في كائن الحدث هذا لتحديد كيفية إنشاء بطاقات إضافية أو التحكّم في سلوك الإضافة. يتم أيضًا إنشاء كائنات الأحداث وتمريرها إلى
وظائف homepageTrigger
عند فتح إضافة لأول مرة، وعندما ينقر المستخدم على الأدوات التفاعلية أو يختارها.
يتم وصف البنية الكاملة لكائنات الأحداث في كائنات الأحداث. إذا كان "تقويم Google" هو تطبيق المضيف الحالي للإضافة، يشتمل المُشغِّل السياقي وكائنات حدث التفاعل مع التطبيقات المصغّرة على حقل كائن حدث "تقويم Google" الذي يحمل معلومات العميل الخاصة بـ "تقويم Google".
تعديل أحداث "تقويم Google"
بالإضافة إلى calendar.eventOpenTrigger السياقي الذي يتم تنشيطه عندما يفتح المستخدم
حدث في "تقويم Google" للتعديل، يمكنك أيضًا تحديد
calendar.eventUpdateTrigger
يتم تنشيطه عندما يعدّل المستخدم ويحفظ حدث "تقويم Google". لا يتم تنشيط هذا المشغِّل إلا إذا أجرى المستخدم تعديلاً واحدًا أو أكثر من التعديلات التالية:
- إضافة ضيف واحد أو أكثر.
- إزالة ضيف واحد أو أكثر.
- لإضافة حل مختلف لمكالمات الفيديو أو التبديل إليه
عند تنشيط هذا المشغِّل، يتم تنفيذ
دالة المشغل المحددة في حقل بيان
calendar.eventUpdateTrigger. يتم تنفيذ الدالة قبل حفظ
تعديل حدث "تقويم Google".
تُستخدَم calendar.eventUpdateTrigger عادةً لتنفيذ إجراء واحد أو أكثر من الإجراءات التالية:
- يمكنك تعديل واجهة حدث الإضافة في "تقويم Google" استجابةً لتغييرات المستخدم في حدث "تقويم Google".
- مزامنة بيانات الأحداث في "تقويم Google" مع نظام تابع لجهة خارجية، مثل نظام مكالمات فيديو متصل بـ "تقويم Google"
إذا كنت بحاجة إلى الإضافة لإجراء تعديلات على بيانات حدث في "تقويم Google" (مثل
قائمة الضيوف)، عليك ضبط حقل بيان
calendar.currentEventAccess للإضافة على WRITE أو READ_WRITE. يتطلب هذا أيضًا أن تحتوي الإضافة على
https://www.googleapis.com/auth/calendar.addons.current.event.write
النطاق.
إضافة حلول مكالمات الفيديو
تمثل حلول المؤتمرات خيارات مكالمات الفيديو التابعة لجهة خارجية والتي يمكن للمستخدمين إرفاقها بأحداث "تقويم Google". توفّر مستندات نظرة عامة على مكالمات الفيديو التابعة لجهات خارجية تفاصيل حول كيفية إنشاء إضافة تضيف حلولاً جديدة لمكالمات الفيديو. ليس من الضروري إنشاء واجهة مستخدم لهذا النوع من الإضافات، لأنّ الحلول المضافة تظهر ببساطة كخيارات في القائمة المنسدلة في واجهة مستخدم حدث "تقويم Google".