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