إنشاء واجهات "تقويم 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 بيان الإضافة.

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

عناصر الحدث

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

يتم وصف البنية الكاملة لكائنات الأحداث في كائنات الأحداث. عندما يكون "تقويم Google" هو التطبيق المضيف الفعلي للإضافات، تتضمّن عناصر الحدث الناتجة عن التفاعل مع التطبيق المصغّر وعناصر العنصر المشغِّل السياقي الحقل عنصر حدث التقويم الذي يحمل معلومات العميل الخاصة بـ "تقويم Google".

تعديل أحداث "تقويم Google"

بالإضافة إلى الإجراء السياقي calendar.eventOpenTrigger الذي يتم تشغيله عندما يفتح مستخدم حدث تقويم لتعديله، يمكنك أيضًا تحديد calendar.eventUpdateTrigger يتم تشغيله عندما يعدّل المستخدم حدث تقويم ويحفظه. لا يتم بدء هذا العامل المشغِّل إلا إذا أجرى المستخدم إجراءً واحدًا أو أكثر من التعديلات التالية:

• تُضيف ضيفًا واحدًا أو أكثر.
• تزيل ضيفًا واحدًا أو أكثر.
• إضافة حلّ مختلف لمكالمات الفيديو أو التبديل إليه

عند تنشيط عامل التشغيل هذا، يتم تنفيذ دالة عامل التشغيل التي يحدّدها حقل البيان calendar.eventUpdateTrigger. يتم تنفيذ الدالة قبل حفظ تعديل حدث "تقويم Google".

يتم استخدام الرمز calendar.eventUpdateTrigger عادةً لإجراء واحد أو أكثر مما يلي:

• عدِّل واجهة حدث التقويم في الإضافة استجابةً لتغييرات المستخدمين في حدث التقويم.
• مزامنة بيانات أحداث "تقويم Google" مع نظام تابع لجهة خارجية، مثل نظام مكالمات فيديو مرتبط بخدمة "تقويم Google"

إذا كنت بحاجة إلى إضافة تعديلات على بيانات حدث في "تقويم Google" (مثل قائمة الضيوف)، عليك ضبط الحقل calendar.currentEventAccess في البيان على WRITE أو READ_WRITE. يتطلّب ذلك أيضًا أن يكون لدى الإضافة https://www.googleapis.com/auth/calendar.addons.current.event.write نطاق.

إضافة حلول مكالمات الفيديو

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