يجب أن تكون إضافات Google Workspace متوافقة مع نمط وتنسيق التطبيق المضيف الذي تضيف إليه ميزات. يجب أن توسّع هذه العناصر واجهة المستخدم بشكل طبيعي باستخدام عناصر التحكّم والسلوكيات المألوفة. توضّح الإرشادات الواردة هنا طرق التعامل مع النصوص والصور وعناصر التحكّم والعلامات التجارية التي تساهم في تحسين تجربة المستخدم العالية الجودة.
إذا كانت الإضافة تفتح صفحات ويب منفصلة تشكّل جزءًا لا يتجزأ من عمل الإضافة (مثل صفحة الإعدادات للإضافة)، تأكَّد من أنّ صفحات الويب هذه تلتزم أيضًا بإرشادات التصميم هذه.
النصوص والصور
يوضّح لك هذا القسم كيفية استخدام النصوص والصور بشكلٍ صحيح في الإضافة.
اسم الإضافة
يجب ضبط اسم الإضافة في ملف بيان المشروع وعند ضبط الإضافة للنشر. يظهر الاسم في العديد من الأماكن، مثل بطاقة بيانات Google Workspace Marketplace وداخل القوائم. عند اختيار اسم:
- استخدِم حالة أحرف العنوان.
- تجنَّب علامات الترقيم، خاصةً الأقواس، ما لم تكن جزءًا من علامتك التجارية.
- احرص على أن يكون العنوان قصيرًا، ويُفضّل أن يتألّف من 15 حرفًا أو أقل. قد يتم اقتطاع الأسماء الطويلة تلقائيًا في بطاقة بيانات Google Workspace Marketplace وفي أماكن أخرى.
- لا تُدرِج الكلمات "Google" أو "Gmail" أو أسماء منتجات Google الأخرى في اسم الإضافة.
- لا تُدرِج كلمة "إضافة" في اسم الإضافة.
- تجنَّب تضمين معلومات الإصدار.
أسلوب الكتابة
من المفترض ألا تحتاج إلى كتابة الكثير من المحتوى. يجب توضيح معظم الإجراءات من خلال الرموز والتصميم والعناوين القصيرة. إذا لاحظت أنّ جزءًا من الإضافة يحتاج إلى شرح أكثر تفصيلاً مما يمكن أن تقدّمه التصنيفات القصيرة، من أفضل الممارسات إنشاء صفحة ويب منفصلة تصف الإضافة وتضمّ رابطًا يؤدي إليها.
عند كتابة نص واجهة المستخدم:
- استخدِم أسلوب الجملة (خاصةً للأزرار والتصنيفات وإجراءات البطاقات).
- يُفضَّل استخدام نص قصير وبسيط بدون مصطلحات أو اختصارات.
الإجراءات العامة وإجراءات البطاقات
إذا كنت تستخدم الإجراءات الشاملة أو إجراءات البطاقات في إضافة، ستظهر كعناصر قائمة في البطاقات التي تحدّدها. يمكنك اختيار النص المستخدَم في هذه القوائم لهذه الإجراءات. عند اختيار النص الذي تريد استخدامه:
- تجنَّب استخدام نص في القائمة يكرر اسم الإضافة ببساطة.
- ابدأ كل عنصر من عناصر القائمة بكلمة إجراء، مثل "تشغيل" أو "ضبط" أو "إنشاء".
- يجب وصف المهمة، وليس عنصر واجهة المستخدم الذي يعرض الإجراء.
- إذا كان الإجراء يبدأ سير عمل ولا يتوفّر فعل واحد يصف ما يفعله، يمكنك تسميته "بدء".
- يجب إبقاء عدد عناصر القائمة صغيرًا لتجنُّب إجبار المستخدم على التمرير أعلى أو أسفل قائمة كبيرة. إذا كان لديك المزيد من الإجراءات لتنفيذها، ننصحك باستخدام بطاقات متعدّدة تتضمّن إجراءات مختلفة في كلّ منها.
رسائل الخطأ
عند حدوث مشكلة، من المهم استخدام لغة بسيطة. شرح المشكلة من وجهة نظر المستخدم، واقتراح كيفية حلّها
- لا تسمح للمستخدم برؤية أي استثناءات يُرسِلها الرمز البرمجي. بدلاً من ذلك،
استخدِم عبارات
try...catchلرصد الاستثناءات، ثم عرض رسالة خطأ سهلة الاستخدام. - قبل نشر الإضافة، تأكَّد من أنّها لا تعرض معلومات تصحيح الأخطاء في واجهة المستخدم.
محتوى المساعدة
يمكنك تصميم بطاقات تعرض معلومات مساعدة أو توضّح للمستخدم كيفية استخدام الإضافة. إذا أنشأت محتوى مساعدة لإضافة ، احرص على ما يلي:
- اعرض التعليمات في قائمة نقطية أو ذات تعداد رقمي كلما أمكن ذلك. وضِّح للمستخدمين الخطوات التي يجب اتّباعها للوصول إلى النتيجة النهائية، مع تضمين إشارات واضحة إلى عناصر واجهة المستخدم المُسمّاة.
- احرص على أن توضّح تعليماتك بوضوح أي متطلبات، مثل إعداد جدول بيانات بطريقة معيّنة.
- يمكنك إضافة روابط إلى محتوى مساعدة خارجي، مثل صفحات الويب الداعمة.
الصور
الصور المستخدَمة في الإضافة هي إما أحد أنواع الرموز المضمّنة أو صورة مستضافة بشكل علني يتم تحديدها من خلال عنوان URL. عند استخدام صور مستضافة، تأكّد من أنّها متاحة لجميع المستخدمين الذين قد يستخدمون الإضافة.
عناصر التحكّم
يوفّر هذا القسم إرشادات بشأن تجربة المستخدِم في استخدام تطبيقات المصغّرة التفاعلية.
الأزرار
استخدِم الأزرار للتحكّم في الإجراءات الرئيسية لواجهة المستخدم بدلاً من تطبيقات المصغّرة الأخرى.
- يجب أن تبدأ معظم تصنيفات الأزرار النصية بفعل.
- يجب أن تقتصر صفوف الأزرار على ثلاثة أزرار أو أقل في معظم الحالات.
DecoratedText
تتيح لك تطبيقات DecoratedText المصغّرة عرض محتوى نصي باستخدام رموز أو أزرار أو مفاتيح تبديل.
- استخدِم حالة أحرف الجملة لمحتوى النص.
- يتم اقتطاع نص أداة DecoratedText إذا تعذّر وضعه في المساحة المتوفّرة. لهذا السبب، ننصحك دائمًا بمحاولة إبقاء محتوى النص قصيرًا بقدر الإمكان.
مدخلات الاختيار
يمكنك استخدام مجموعة متنوعة من تطبيقات مصغّرة لإدخال خيارات في الإضافة: مربّعات اختيار منسدلة ومربّعات اختيار وأزرار اختيار.
- استخدِم مربّعات الاختيار عندما يمكن للمستخدمين اختيار خيارات متعددة أو عدم اختيار أي خيار على الإطلاق. استخدِم أزرار الاختيار (أو قائمة اختيار) عندما يكون عليك تحديد خيار واحد بالضبط. استخدِم القوائم المنسدلة عند تقديم قائمة قصيرة بالبدائل أثناء محاولة توفير مساحة في واجهة المستخدم.
- استخدِم حالة أحرف الجملة للنص الذي تمّ تعيينه لكل خيار.
- تجنَّب استخدام تغييرات الاختيار لبدء إجراءات كبيرة يصعب التراجع عنها، لأنّ المستخدمين غالبًا ما يرتكبون أخطاء عند إجراء الاختيارات. بدلاً من ذلك، ننصحك بإضافة زر يقرأ قيم الاختيار الحالية ثم يشغِّل الإجراء.
- بالنسبة إلى القوائم المنسدلة، يجب ترتيب الخيارات أبجديًا أو وفقًا لترتيب منطقي يمكن لجميع المستخدمين فهمه (مثل عرض أيام الأسبوع بالترتيب، بدءًا من الأحد أو الاثنين).
- حصر عدد الخيارات في مربّع اختيار معيّن بعدد معقول إذا كان هناك عدد كبير جدًا من الخيارات، قد يجد المستخدمون صعوبة في استخدام التطبيق المصغّر. في هذه الحالات، ننصحك بتقسيم الخيار إلى فئات مختلفة وتطبيقات مصغّرة متعددة.
إدخالات النصوص
توفّر مدخلات النصوص مكانًا للمستخدمين لإدخال بيانات السلاسل.
- لا تستخدِم حقل إدخال نصيًا لجعل المستخدم يكتب أحد مجموعة محدّدة من الإدخالات المحتملة. استخدِم قائمة منسدلة بدلاً من ذلك.
- استخدِم التلميحات والاقتراحات لمساعدة المستخدم في إدخال النص بالشكل والمحتوى الصحيحَين.
- استخدِم مدخلات النصوص المتعدّدة الأسطر إذا كان النص المطلوب إدخاله يتجاوز بضع كلمات.
العلامة التجارية
يوفّر هذا القسم إرشادات حول تجربة المستخدم لإضافة عناصر العلامة التجارية إلى واجهة الإضافة.
في الإضافة
إذا أردت تضمين العلامة التجارية في واجهة المستخدم للإضافة، احرص على أن تكون موجزة وخفيفة. يساعد ذلك المستخدمين في التركيز على وظائف الإضافة.
- يجب أن تتوافق جميع جوانب الإضافة مع إرشادات وضع العلامة التجارية.
- لا تُدرِج كلمة "Google" أو "Gmail" أو أسماء منتجات Google الأخرى.
- لا تُدرِج رموز منتجات Google، حتى إذا تم تغييرها.
- لا تُدرِج كلمة "إضافة" في نص علامتك التجارية.
- يجب ألا يتضمّن نص العلامة التجارية أكثر من بضع كلمات.
في Google Workspace Marketplace
عند ضبط الإضافة للنشر، قدِّم عددًا من مواد عرض الرسومات والنصوص لإنشاء بطاقة بيانات Google Workspace Marketplace.
يجب أن تتوافق جميع جوانب بطاقة بيانات المتجر ومواد العرض هذه مع إرشادات وضع العلامة التجارية.