يجب أن تتوافق إضافات 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.
يجب أن تتوافق جميع جوانب بطاقة بيانات المتجر ومواد العرض هذه مع إرشادات بناء هوية العلامة التجارية.