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

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

عند إنشاء واجهة إضافة لـ "تقويم Google"، يمكنك تقديم صفحة رئيسية. يمكنك استخدام الصفحة الرئيسية نفسها لمضيفين متعددين، أو تصميم صفحة رئيسية معينة لـ "تقويم Google".

يمكن أن تحدد الإضافة أيضًا واجهة تظهر عند فتح حدث "تقويم Google" للمستخدم.

الوصول إلى واجهة مستخدم الإضافات

استنادًا إلى كيفية فتحها، يمكن Google Workspace لإضافة الإضافة تحديد واجهة صفحة رئيسية أو واجهة حدث "تقويم Google" أو واجهة اختيار مرفق أو جميعها الثلاث:

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

إنشاء واجهة "تقويم Google" الإضافية

يمكنك توسيع "تقويم Google" باستخدام Google Workspace إضافة باتّباع الخطوات التالية:

  1. حدِّد ما إذا كنت تريد أن تحتوي إضافتك على صفحة رئيسية خاصة بالتقويم. حدِّد أيضًا ما إذا كنت تريد توفير واجهة مخصصة أثناء تعديل المستخدم لأحداث "تقويم 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 إلى بيان الإضافة لتقديم صفحة رئيسية خاصة بالتقويم.

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

تمديد واجهة حدث التقويم

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

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

كائنات الأحداث

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

يتم وصف البنية الكاملة لكائنات الأحداث في عناصر الحدث. عندما يكون "تقويم Google" هو التطبيق المضيف المستند إلى الإضافة، يتضمّن مشغِّل السياق وكائنات حدث الأدوات المصغّرة الحقل كائن حدث "تقويم 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".