يمكن أن توفّر إضافات Google Workspace خيارات مخصَّصة الواجهات أثناء عرض المستخدم للتقاويم وأحداث "تقويم Google" أو تعديلها. ويسمح لك هذا بتزويد المستخدم بمعلومات إضافية ذات صلة، وبرمجة المهام وربط أنظمة الجهات الخارجية بـ "تقويم Google".
عند إنشاء واجهة إضافية لـ "تقويم Google"، يمكنك توفير الصفحة الرئيسية. يمكنك استخدام نفس الرئيسية لمضيفات متعددة، أو تصميم مضيف محدد لتقويم Google.
يمكن للإضافتك أيضًا تحديد واجهة تظهر عندما يكون لدى المستخدم حدث في التقويم مفتوح.
الوصول إلى واجهة مستخدم الإضافة
استنادًا إلى طريقة فتحها، يمكن لإضافة Google Workspace تحديد واجهة صفحة رئيسية أو واجهة حدث في "تقويم Google" أو واجهة اختيار مرفق أو جميعها ثلاثة:
- إذا نقر مستخدم على رمز الإضافة أثناء عرض التقويم، فسيتم تنفيذ الإضافة.
calendar.homepageTrigger
المقابل (إذا كانت موجودة). تنشئ هذه الدالة بطاقة الصفحة الرئيسية وتعرضها إلى التقويم للعرض. إذا كانت الإجابة "لا"calendar.homepageTrigger
يتم عرض بطاقة صفحة رئيسية عامة بدلاً من ذلك. - إذا فتح المستخدم حدثًا في "تقويم Google" ثم نقر على رمز الإضافة، أو
عندما يفتح المستخدم حدثًا أو عندما يفتح
لتنفيذ عملية
eventOpenTrigger
(إذا كانت موجودة). تنشئ هذه الدالة حدث "تقويم Google" للإضافة. والعودة إلى تقويم Google للعرض. - إذا كانت الإضافة تحدّد دالة
eventAttachmentTrigger
، تظهر الإضافة كموفِّر للمرفقات عندما ينقر المستخدم على إضافة مرفق أثناء تعديل حدث في "تقويم Google". عند اختيار الإضافة، تنشئ الدالةeventAttachmentTrigger
مرفق الإضافة. وإعادةها إلى تقويم Google للعرض.
إنشاء واجهة "تقويم Google" الإضافية
يمكنك تمديد تقويم Google من خلال إضافة Google Workspace باتّباع الخطوات التالية:
- تحديد ما إذا كنت تريد أن يكون للإضافة ميزات خاصة بـ "تقويم Google" الصفحة الرئيسية. قرر أيضًا ما إذا كنت تريد توفير واجهة مخصصة عندما يكون المستخدم تعديل أحداث التقويم.
- أضف القيمة المناسبة
addOns.common
وaddOns.calendar
الحقول إلى بيان مشروع النص البرمجي للإضافة بما في ذلك أي نطاقات مطلوبة. - إذا كنت تقدم جدول بيانات خاصًا بالتقويم
الصفحة الرئيسية،
تنفيذ
calendar.homepageTrigger
لإنشاء هذه الواجهة. ويمكنك أيضًا اختيار استخدامcommon.homepageTrigger
لمضيفي Google Workspace متعددين. - إذا كنت تقدم واجهة حدث في "تقويم Google"، يجب تنفيذ
calendar.eventOpenTrigger
لإنشاء هذه الواجهة. عرض توسيع واجهة حدث "تقويم Google" لمزيد من التفاصيل. - تنفيذ وظائف معاودة الاتصال المرتبطة اللازمة للاستجابة لطلبات المستخدم تفاعلات واجهة المستخدم، مثل النقرات على الأزرار
الصفحات الرئيسية للتقويم
يتيح "تقويم Google" عرض الصفحات الرئيسية في "إضافات Google Workspace".
لإظهار الصفحة الرئيسية المشتركة للإضافات في "تقويم Google"، ما عليك سوى التأكد من
هو addOns.calendar
في بيان الإضافة.
وبدلاً من ذلك، يمكنك إضافة
calendar.homepageTrigger
إلى بيان الإضافة لتقديم صفحة رئيسية خاصة بالتقويم.
في كلتا الحالتين، يجب عليك تقديم اسم دالة مشغل الصفحة الرئيسية في
مشروع البرنامج النصي للإضافة. يتم استدعاء هذه الدالة تلقائيًا لإنشاء
الصفحة الرئيسية لتقويم Google عند الحاجة. يجب عليك تنفيذ هذه الدالة لإنشاء
وترجع نتيجة واحدة
Card
أو صفيف من
Card
والكائنات التي تشكل الصفحة الرئيسية. يتم تمرير دالة مشغل الصفحة الرئيسية
كائن الحدث
كمعلمة تحتوي على بعض المعلومات العامة مثل معلمة
بدون خادم. ويمكنك استخدام بيانات كائن الحدث لتخصيص إنشاء
الرئيسية.
توسيع واجهة حدث "تقويم Google"
يعتمد تقويم Google على مشغل سياقي لتحديد الواجهة
(إن وُجد) لعرض وقت تعديل المستخدم لحدث في "تقويم Google". عندما يبدأ المشغل
فإنها تنفذ دالة المشغل السياقية المحددة بواسطة
calendar.eventOpenTrigger
في بيان الإضافة.
يجب تنفيذ الدالة المذكورة في
calendar.eventOpenTrigger
. تقبل هذه الدالة كائن الحدث باعتباره
ويجب أن تعرض إما قيمة
كائن Card
أو مصفوفة من
Card
كائنات "تقويم Google" من أجل
عرض الحدث أثناء فتح المستخدم للحدث.
كائنات الأحداث
يتمّ إنشاء كائن حدث
تمريره إلى
calendar.eventOpenTrigger
وظيفة المشغل السياقي عندما يفتح المستخدم
حدث في التقويم. يمكن لدالة المشغّل استخدام المعلومات الواردة في هذا الحدث
لتحديد كيفية إنشاء بطاقات إضافية أو التحكّم في الإضافة
السلوك. يتم أيضًا إنشاء كائنات الأحداث وتمريرها إلى
homepageTrigger
عندما يتم فتح إضافة لأول مرة، وعندما ينقر المستخدم على إضافة أو يحددها
التطبيقات المصغّرة التفاعلية.
يتم وصف البنية الكاملة لكائنات الأحداث في كائنات الأحداث. عندما يكون "تقويم Google" هو تطبيق المضيف الحالي للإضافة، فإن المشغِّل السياقي كائنات حدث تفاعل الأداة كائن حدث "تقويم Google" الذي يتضمن معلومات العميل الخاصة بالتقويم.
تعديل أحداث "تقويم Google"
بالإضافة إلى السياق
calendar.eventOpenTrigger
يتم تنشيطها عندما يفتح المستخدِم
حدث في التقويم للتعديل، يمكنك أيضًا تحديد
calendar.eventUpdateTrigger
يتم تنشيطها عندما يعدِّل المستخدم حدث "تقويم Google" ويحفظه. هذا العامل المشغِّل فقط
يتم تنشيطها إذا أجرى المستخدم تعديلاً واحدًا أو أكثر من التعديلات التالية:
- إضافة ضيف واحد أو أكثر.
- إزالة ضيف واحد أو أكثر.
- لإضافة حل مختلف لمكالمات الفيديو أو التبديل إليه
وعندما يتم تنشيط هذا المشغِّل، فإنه ينفذ
دالة المشغل المحددة بواسطة
calendar.eventUpdateTrigger
حقل البيان. يتم تنفيذ الدالة قبل تنفيذ تعديل حدث "تقويم Google"
تم حفظه.
calendar.eventUpdateTrigger
عادة لإجراء واحد أو أكثر من الإجراءات التالية:
- تعديل واجهة حدث "تقويم Google" للإضافة استجابةً لتغييرات المستخدم إلى حدث التقويم.
- مزامنة بيانات الحدث في "تقويم Google" مع نظام تابع لجهة خارجية، مثل مكالمة فيديو المرتبط بتقويم Google.
إذا كنت بحاجة إلى الإضافة لإجراء تعديلات على بيانات حدث التقويم (مثل
كقائمة حضور لها)، فيجب ضبط الإضافة
calendar.currentEventAccess
إلى WRITE
أو READ_WRITE
. هذا أيضًا
تتطلب الإضافة وجود
https://www.googleapis.com/auth/calendar.addons.current.event.write
النطاق.
إضافة حلول مكالمات الفيديو
حلول مكالمات الفيديو تمثِّل خيارات مكالمات الفيديو التابعة لجهة خارجية والتي يمكن للمستخدمين إرفاقها بها الأحداث في "تقويم Google" تشير رسالة الأشكال البيانية نظرة عامة على مكالمات الفيديو التابعة لجهات خارجية مستندات توفر تفاصيل حول كيفية إنشاء إضافة تضيف لمؤتمرات الفيديو. ليس من الضروري إنشاء واجهة مستخدم لهذا النوع من extension; الحلول المضافة كخيارات في القائمة المنسدلة واجهة مستخدم حدث "تقويم Google".