إنشاء واجهات "تقويم Google"

يمكن أن توفر "إضافات 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 باتّباع الخطوات التالية:

1. حدِّد ما إذا كنت تريد أن يكون للإضافة صفحة رئيسية خاصة بـ "تقويم Google". حدِّد أيضًا ما إذا كنت تريد توفير واجهة مخصّصة أثناء تعديل المستخدم لأحداث "تقويم Google".
2. أضِف الحقلَين المناسبَين addOns.common وaddOns.calendar إلى بيان مشروع نص الإضافة، بما في ذلك أي نطاق مطلوب.
3. إذا كنت تقدّم صفحة رئيسية خاصة بخدمة "تقويم Google"، نفِّذ الدالة calendar.homepageTrigger لإنشاء هذه الواجهة. يمكنك أيضًا اختيار استخدام واجهة common.homepageTrigger لمضيفي Google Workspace المتعدّدين.
4. إذا كنت توفر واجهة حدث في "تقويم Google"، يجب تنفيذ وظيفة calendar.eventOpenTrigger لإنشاء هذه الواجهة. يُرجى الاطّلاع على توسيع واجهة حدث "تقويم Google" للحصول على التفاصيل.
5. تنفيذ وظائف معاودة الاتصال المرتبطة اللازمة للاستجابة لتفاعلات واجهة المستخدم، مثل النقرات على الأزرار.

الصفحات الرئيسية للتقويم

يتيح "تقويم Google" عرض الصفحات الرئيسية لإضافات Google Workspace. لعرض الصفحة الرئيسية الشائعة للإضافات في "تقويم Google"، ما عليك سوى التأكد من أنّ هناك حقل addOns.calendar في بيان الإضافة.

بدلاً من ذلك، يمكنك إضافة رمز calendar.homepageTrigger إلى بيان الإضافة لتوفير صفحة رئيسية خاصة بخدمة "تقويم Google".

في كلتا الحالتين، يجب عليك تقديم اسم دالة مشغل الصفحة الرئيسية في مشروع النص البرمجي للإضافة. يتمّ استدعاء هذه الدالة تلقائيًا لإنشاء صفحة "تقويم Google" الرئيسية عند الحاجة. يجب تنفيذ هذه الدالة لإنشاء وعرض عنصر Card واحد أو صفيف من عناصر Card التي تشكّل الصفحة الرئيسية. يتم تمرير دالة تشغيل الصفحة الرئيسية كائن حدث كمَعلمة تحتوي على بعض المعلومات العامة مثل النظام الأساسي للعميل. يمكنك استخدام بيانات عنصر الحدث لتخصيص بنية الصفحة الرئيسية.

توسيع واجهة حدث "تقويم Google"

يعتمد "تقويم Google" على عامل تشغيل سياقي لتحديد الواجهة (إن توفّرت) التي سيتم عرضها عندما يعدّل المستخدم حدثًا في "تقويم Google". عندما يتم تنشيط عامل التفعيل، يتم تنفيذ وظيفة المشغِّل السياقي المحدّدة في الحقل calendar.eventOpenTrigger في manifest الإضافة.

عليك تنفيذ الدالة المُسمّاة في الحقل 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".