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

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

  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 السياقي الذي يتم تنشيطه عندما يفتح المستخدِم حدثًا في "تقويم Google" لتعديله، يمكنك أيضًا تحديد calendar.eventUpdateTrigger الذي يتم تنشيطه عندما يعدّل المستخدم حدث "تقويم Google" ويحفظه. يتم تنشيط هذا المشغِّل فقط إذا أجرى المستخدم واحدًا أو أكثر من التعديلات التالية:

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

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

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

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

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

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

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