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