يمكن أن توفّر إضافات Google Workspace واجهات مخصّصة عندما يعرض المستخدم التقاويم وأحداث "تقويم Google" أو يعدّلها. يتيح لك ذلك تزويد المستخدم بمعلومات إضافية ذات صلة، وأتمتة المهام، وربط أنظمة تابعة لجهات خارجية بـ "تقويم Google".
عند إنشاء واجهة إضافة Google Workspace لـ "تقويم Google"، يمكنك توفير صفحة رئيسية. يمكنك استخدام الصفحة الرئيسية نفسها لعدة مضيفين، أو تصميم صفحة مخصّصة لـ "تقويم Google".
يمكن للإضافة أيضًا تحديد واجهة تظهر عندما يفتح المستخدم حدثًا في "تقويم Google".
الوصول إلى واجهة مستخدم الإضافة
يمكن أن تظهر واجهة المستخدم بعدة طرق حسب السياق. على سبيل المثال، يمكن أن تحدّد الإضافة واجهة صفحة رئيسية أو واجهة حدث في "تقويم 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"، عليك تنفيذ وظيفة
calendar.eventOpenTriggerلإنشاء هذه الواجهة. يمكنك الاطّلاع على توسيع واجهة أحداث التقويم للحصول على التفاصيل. - نفِّذ دوال رد الاتصال المرتبطة اللازمة للاستجابة لتفاعلات المستخدم مع واجهة المستخدم، مثل نقرات الأزرار.
الصفحات الرئيسية للتقويم
تتيح الإضافات عرض الصفحات الرئيسية لإضافات Google Workspace. لعرض الصفحة الرئيسية المشتركة للإضافة في "تقويم Google"، تأكَّد من توفّر الحقل addOns.calendar في ملف بيان الإضافة.
بدلاً من ذلك، يمكنك إضافة
calendar.homepageTrigger
إلى بيان الإضافة لتوفير صفحة رئيسية خاصة بـ "تقويم Google".
في كلتا الحالتين، يجب تقديم اسم دالة مشغّلة للصفحة الرئيسية في مشروع البرنامج النصي الخاص بالإضافة. يتم استدعاء هذه الدالة تلقائيًا لإنشاء الصفحة الرئيسية في "تقويم Google" عند الحاجة إليها. نفِّذ هذه الدالة لإنشاء وعرض Card واحد أو مصفوفة من عناصر Card التي تشكّل الصفحة الرئيسية. يتم تمرير عنصر حدث كمعلَمة إلى دالة مشغّل الصفحة الرئيسية، ويتضمّن هذا العنصر بعض المعلومات العامة، مثل نظام تشغيل العميل. استخدِم بيانات عنصر الحدث لتخصيص طريقة إنشاء الصفحة الرئيسية.
توسيع واجهة حدث "تقويم Google"
يعتمد "تقويم Google" على مشغّل سياقي لتحديد واجهة المستخدم (إن وُجدت) التي سيتم عرضها عندما يعدّل المستخدم حدثًا في "تقويم Google". عندما يتم تشغيل المشغّل، يتم تنفيذ وظيفة المشغّل السياقي المحدّدة في الحقل calendar.eventOpenTrigger في بيان الإضافة.
نفِّذ الدالة المحدّدة في الحقل
calendar.eventOpenTrigger. تقبل هذه الدالة عنصر حدث كمعلَمة ويجب أن تعرض إما عنصر Card واحدًا أو مصفوفة من عناصر Card ليعرضها "تقويم Google" عندما يكون الحدث مفتوحًا للمستخدم.
عناصر الحدث
يتم إنشاء عنصر حدث ونقله إلى دالة المشغّل السياقي calendar.eventOpenTrigger عندما يفتح المستخدم حدثًا في التقويم.
يمكن أن تستخدم دالة عامل التشغيل المعلومات الواردة في عنصر الحدث هذا لتحديد كيفية إنشاء بطاقات الإضافة أو التحكّم في سلوك الإضافة. يتم أيضًا إنشاء عناصر الأحداث وتمريرها إلى دوال homepageTrigger عند فتح إضافة لأول مرة، وعندما ينقر المستخدم على أدوات تفاعلية أو يختارها.
يمكن الاطّلاع على البنية الكاملة لعناصر الحدث في مقالة عناصر الحدث. عندما يكون "التقويم" هو التطبيق المضيف للإضافة، تتضمّن عناصر أحداث التفعيل السياقي وتفاعل الأدوات حقل عنصر حدث التقويم الذي يتضمّن معلومات العميل الخاصة بالتقويم.
تعديل أحداث التقويم
بالإضافة إلى
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". تقدّم مستندات نظرة عامة على مؤتمرات الفيديو التابعة لجهات خارجية تفاصيل حول كيفية إنشاء إضافة توفّر حلولاً جديدة لعقد المؤتمرات. ليس من الضروري إنشاء واجهة مستخدم لهذا النوع من الإضافات، بل تظهر الحلول المضافة كخيارات في القائمة المنسدلة لواجهة مستخدم حدث "تقويم Google".