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