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