تستند إضافات Google Workspace إلى البطاقات. وتستند إضافات المحرّر إلى HTML.
تعرض الإضافات المعلومات وعناصر التحكّم الخاصة بالمستخدم في الشريط الجانبي لواجهة مستخدم التطبيق المضيف. تتألف إضافة Google Workspace من شريط أدوات رئيسي يحدّد الهوية بالإضافة إلى بطاقة واحدة أو أكثر.
تمثّل كل بطاقة "صفحة" معيّنة من واجهة مستخدم الإضافة. لا يتطلّب الانتقating to a new card الانتقال إلى بطاقة جديدة عادةً سوى إنشاء تلك البطاقة و وضعها في مجموعة بطاقات داخلية. يمكنك تحديد مسارات التنقّل بين البطاقات للحصول على تجربة تفاعلية غنية.
يمكن أن تكون البطاقات غير سياقية أو سياقية. تظهر البطاقات السياقية للمستخدم عندما يكون التطبيق المضيف في سياق معيّن، مثلاً عند فتح رسالة Gmail أو حدث في "تقويم Google". تظهر البطاقات غير السياقية (مثل الصفحات الرئيسية) للمستخدم خارج سياق معيّن للتطبيق المضيف، مثلاً عندما يعرض المستخدم بريده الوارد في Gmail أو مجلد Google Drive الرئيسي أو "تقويم Google".
تستخدم إضافات Google Workspace التي تم إنشاؤها في برمجة تطبيقات Google خدمة البطاقات لإنشاء واجهات مستخدم من البطاقات. يجب أن تعرض الإضافات التي تم إنشاؤها بلغات أخرى JSON منسّقًا بشكل صحيح لكي يتم عرض الواجهة كبطاقات.
تتألف كل بطاقة من رأس وقسم واحد أو أكثر. يتألف كل قسم من مجموعة من الأدوات. تعرض الأدوات المعلومات للمستخدم أو توفّر عناصر تحكّم تفاعلية، مثل الأزرار.
توفّر الواجهات المستندة إلى البطاقات المزايا التالية:
- لا تحتاج إلى معرفة HTML أو CSS لإنشاء واجهات مستندة إلى البطاقات.
- يتم تلقائيًا تنسيق البطاقات والأدوات لتعمل بشكل جيد مع تطبيقات Google Workspace التي توسّع نطاقها.
- تعمل الواجهات المستندة إلى البطاقات على كلٍّ من أجهزة الكمبيوتر والأجهزة الجوّالة، ولكن عليك تحديد الواجهة مرة واحدة فقط.
Gmail هو التطبيق المضيف الوحيد الذي يمكن توسيع نطاقه من خلال إضافات Google Workspace على الأجهزة الجوّالة.
إنشاء واجهات مستندة إلى البطاقات
عند إنشاء إضافات مستندة إلى البطاقات، من المهم فهم مفاهيم وأنماط تصميم معيّنة. تقدّم الأدلة التالية المعلومات التي تحتاج إليها لإنشاء إضافات فعّالة مستندة إلى البطاقات:
- البطاقات
- الصفحات الرئيسية
- الأدوات
- الإجراءات
- عناصر الحدث
- إنشاء البطاقات
- إنشاء بطاقات تفاعلية
- التنقّل بين البطاقات
- استخدام الإجراءات العامة
- إضافة ميزة الإكمال التلقائي إلى حقول إدخال النصوص
- الوصول إلى اللغات والمناطق الزمنية للمستخدمين
- الربط بالخدمات غير التابعة لشركة Google
- دليل الأنماط
- أفضل الممارسات
يمكنك الرجوع إلى هذه الصفحات عند إنشاء البطاقات وتنفيذ سلوك واجهة المستخدم. قد تكون النماذج الإضافية التالية مفيدة أيضًا للرجوع إليها عند تنفيذ الإضافة:
دليل البدء السريع لإضافة "القطط" في Google Workspace
يعرض نموذج الإضافة هذا واجهة مستخدم إضافة تحتوي على صفحات متعددة وصفحات رئيسية.
إضافة "الترجمة" في Google Workspace
يعرض نموذج الإضافة هذا إضافة تتيح للمستخدمين ترجمة النصوص من داخل "مستندات Google" و"جداول بيانات Google" و"العروض التقديمية من Google".
إضافة "قائمة الفِرق" في Google Workspace
يعرض نموذج الإضافة هذا نموذجًا أكثر تعقيدًا لإضافة Google Workspace يعرض معلومات المستخدم حول مستلِمي رسائل Gmail أو محرّري ملفات Drive أو الحاضرين في أحداث "تقويم Google". لا يمكنك استخدام هذه الإضافة إلا داخل نطاق، لأنّها تستخدم واجهة برمجة تطبيقات الدليل لاسترداد معلومات المستخدم.