Google Workspace ऐड-ऑन, उस होस्ट ऐप्लिकेशन की स्टाइल और लेआउट के मुताबिक होने चाहिए जिसके लिए उन्हें बनाया गया है. उन्हें जाने-पहचाने कंट्रोल और व्यवहारों का इस्तेमाल करके, यूज़र इंटरफ़ेस (यूआई) को स्वाभाविक तौर पर बढ़ाना चाहिए. यहां दिए गए दिशा-निर्देशों में, टेक्स्ट, इमेज, कंट्रोल, और ब्रैंडिंग को मैनेज करने के तरीकों के बारे में बताया गया है. इनसे लोगों को बेहतर अनुभव मिलता है.
अगर आपका ऐड-ऑन, अलग-अलग वेब पेज खोलता है और ये वेब पेज, ऐड-ऑन के ऑपरेशन का अहम हिस्सा हैं (जैसे, ऐड-ऑन के लिए सेटिंग पेज), तो पक्का करें कि ये वेब पेज भी स्टाइल से जुड़े इन दिशा-निर्देशों का पालन करें.
टेक्स्ट और इमेज
इस सेक्शन में, आपको अपने ऐड-ऑन में टेक्स्ट और इमेज का इस्तेमाल करने का तरीका बताया गया है.
ऐड-ऑन का नाम
आपको अपने ऐड-ऑन का नाम, उसके प्रोजेक्ट मैनिफ़ेस्ट में सेट करना होगा. साथ ही, पब्लिश करने के लिए ऐड-ऑन को कॉन्फ़िगर करते समय भी आपको यह नाम सेट करना होगा. यह नाम, Google Workspace Marketplace की लिस्टिंग और मेन्यू में कई जगहों पर दिखता है, जैसे कि Google Workspace Marketplace की लिस्टिंग और मेन्यू में. नाम चुनते समय इन बातों का ध्यान रखें:
- टाइटल केस का इस्तेमाल करें.
- विराम चिह्नों का इस्तेमाल करने से बचें. खास तौर पर, पैरंटheses का इस्तेमाल तब तक न करें, जब तक कि वे आपके ब्रैंड का हिस्सा न हों.
- नाम छोटा रखें. इसके लिए, 15 या उससे कम वर्णों का इस्तेमाल करना सबसे अच्छा है. Google Workspace Marketplace की लिस्टिंग और अन्य जगहों पर, लंबे नामों को अपने-आप छोटा किया जा सकता है.
- अपने ऐड-ऑन के नाम में "Google", "Gmail" या Google के अन्य प्रॉडक्ट के नाम शामिल न करें.
- अपने ऐड-ऑन के नाम में "ऐड-ऑन" शब्द शामिल न करें.
- वर्शन की जानकारी शामिल न करें.
लिखने की स्टाइल
आपको ज़्यादा लिखने की ज़रूरत नहीं होनी चाहिए. ज़्यादातर कार्रवाइयों को आइकॉनोग्राफ़ी, लेआउट, और छोटे लेबल की मदद से साफ़ तौर पर दिखाया जाना चाहिए. अगर आपको लगता है कि आपके ऐड-ऑन के किसी हिस्से के लिए, छोटे लेबल से ज़्यादा जानकारी देने की ज़रूरत है, तो हमारा सुझाव है कि आप अपने ऐड-ऑन के बारे में बताने वाला कोई अलग वेब पेज बनाएं और उसका लिंक जोड़ें.
यूज़र इंटरफ़ेस (यूआई) के लिए टेक्स्ट लिखते समय इन बातों का ध्यान रखें:
- अंग्रेज़ी के वाक्यों में, पहला वर्ण बड़ा (अपर केस में) रखें. खास तौर पर, बटन, लेबल, और कार्ड की कार्रवाइयों के लिए.
- ऐसे छोटे और साफ़ टेक्स्ट का इस्तेमाल करें जिनमें तकनीकी शब्दों या संक्षिप्त शब्दों का इस्तेमाल न किया गया हो.
यूनिवर्सल और कार्ड की कार्रवाइयां
अगर आपने अपने ऐड-ऑन में यूनिवर्सल कार्रवाइयों या कार्ड की कार्रवाइयों का इस्तेमाल किया है, तो ये कार्रवाइयां, आपके तय किए गए कार्ड में मेन्यू आइटम के तौर पर दिखती हैं. इन कार्रवाइयों के लिए, इन मेन्यू में इस्तेमाल किया जाने वाला टेक्स्ट चुना जा सकता है. इस्तेमाल करने के लिए टेक्स्ट चुनते समय इन बातों का ध्यान रखें:
- ऐसे मेन्यू टेक्स्ट का इस्तेमाल न करें जिसमें आपके ऐड-ऑन का नाम दोहराया गया हो.
- हर मेन्यू आइटम की शुरुआत, किसी ऐक्शन वाले शब्द से करें. जैसे, "चलाएं", "कॉन्फ़िगर करें" या "बनाएं".
- उस टास्क के बारे में बताएं जिसे कार्रवाई से दिखाया जाता है. उस यूज़र इंटरफ़ेस (यूआई) कॉम्पोनेंट के बारे में न बताएं जिसे कार्रवाई से दिखाया जाता है.
- अगर आपकी कार्रवाई से कोई वर्कफ़्लो शुरू होता है और उसे बताने के लिए कोई एक क्रिया नहीं है, तो उसे "शुरू करें" नाम दें.
- मेन्यू आइटम की संख्या कम रखें, ताकि लोगों को लंबी सूची में स्क्रोल न करना पड़े. अगर आपको ज़्यादा कार्रवाइयां लागू करनी हैं, तो अलग-अलग कार्रवाइयों वाले कई कार्ड इस्तेमाल करने पर विचार करें.
गड़बड़ी के मैसेज
जब कोई गड़बड़ी होती है, तो आसान भाषा का इस्तेमाल करना ज़रूरी है. लोगों के नज़रिए से समस्या के बारे में बताएं और उसे ठीक करने का तरीका सुझाएं.
- लोगों को अपने कोड से जुड़ी कोई भी गड़बड़ी न दिखाएं. इसके बजाय, गड़बड़ियों को रोकने के लिए
try...catchस्टेटमेंट का इस्तेमाल करें. इसके बाद, लोगों को गड़बड़ी का ऐसा मैसेज दिखाएं जिसे वे आसानी से समझ सकें. - पब्लिश करने से पहले, यह देखें कि आपका ऐड-ऑन, यूज़र इंटरफ़ेस (यूआई) में डीबग करने से जुड़ी जानकारी न दिखाए.
सहायता कॉन्टेंट
ऐसा हो सकता है कि आपको ऐसे कार्ड डिज़ाइन करने हों जिनमें सहायता से जुड़ी जानकारी दिखती हो या लोगों को ऐड-ऑन के ऑपरेशन के बारे में बताया जाता हो. अगर आपने अपने ऐड-ऑन के लिए सहायता कॉन्टेंट बनाया है, तो इन बातों का ध्यान रखें:
- जब मुमकिन हो, तो निर्देशों को बुलेट वाली या नंबर वाली सूची में दिखाएं. लोगों को आखिर तक ले जाएं. साथ ही, यूज़र इंटरफ़ेस (यूआई) के नाम वाले एलिमेंट के बारे में साफ़ तौर पर बताएं.
- पक्का करें कि आपके निर्देशों में, सभी ज़रूरी शर्तों के बारे में साफ़ तौर पर बताया गया हो. जैसे, किसी खास तरीके से स्प्रेडशीट सेट अप करना.
- बाहरी सहायता कॉन्टेंट से लिंक करने में कोई समस्या नहीं है. जैसे, सहायता वाले वेब पेज.
इमेज
आपके ऐड-ऑन में इस्तेमाल की गई इमेज, आइकॉन के पहले से मौजूद टाइप में से कोई एक होती है या सार्वजनिक तौर पर होस्ट की गई कोई इमेज होती है. इसे यूआरएल से तय किया जाता है. होस्ट की गई इमेज का इस्तेमाल करते समय, पक्का करें कि वे सभी लोग उन्हें ऐक्सेस कर सकें जो आपके ऐड-ऑन का इस्तेमाल कर सकते हैं.
कंट्रोल
इस सेक्शन में, इंटरैक्टिव विजेट के लिए उपयोगकर्ता अनुभव से जुड़े दिशा-निर्देश दिए गए हैं.
बटन
अपने यूज़र इंटरफ़ेस (यूआई) की मुख्य कार्रवाइयों को कंट्रोल करने के लिए, अन्य विजेट के बजाय बटन का इस्तेमाल करें.
- ज़्यादातर टेक्स्ट बटन के लेबल की शुरुआत किसी क्रिया से होनी चाहिए.
- ज़्यादातर मामलों में, बटन की लाइनों में तीन या उससे कम बटन होने चाहिए.
DecoratedText
DecoratedText विजेट की मदद से, आइकॉन, बटन या स्विच के साथ टेक्स्ट कॉन्टेंट दिखाया जा सकता है.
- टेक्स्ट कॉन्टेंट के लिए, अंग्रेज़ी के वाक्यों में, पहला वर्ण बड़ा (अपर केस में) रखें.
- अगर DecoratedText विजेट का टेक्स्ट, उपलब्ध जगह में फ़िट नहीं होता, तो उसे छोटा कर दिया जाता है. इसलिए, हमेशा टेक्स्ट कॉन्टेंट को जितना हो सके उतना छोटा रखने की कोशिश करें.
चुने जाने वाले इनपुट
अपने ऐड-ऑन में, चुने जाने वाले इनपुट के कई विजेट इस्तेमाल किए जा सकते हैं: ड्रॉप-डाउन चुनने के बॉक्स, चेकबॉक्स, और रेडियो बटन.
- चेकबॉक्स का इस्तेमाल तब करें, जब लोग एक से ज़्यादा विकल्प चुन सकते हों या कोई भी विकल्प न चुन सकें. रेडियो बटन (या चुनने के लिए मेन्यू) का इस्तेमाल तब करें, जब सिर्फ़ एक विकल्प चुना जाना ज़रूरी हो. ड्रॉपडाउन का इस्तेमाल तब करें, जब यूज़र इंटरफ़ेस (यूआई) में जगह बचाने के लिए, विकल्पों की छोटी सूची दिखानी हो.
- हर विकल्प के लिए तय किए गए टेक्स्ट के लिए, अंग्रेज़ी के वाक्यों में, पहला वर्ण बड़ा (अपर केस में) रखें.
- चुने जाने वाले विकल्पों में बदलाव करके, ऐसी अहम कार्रवाइयां ट्रिगर करने से बचें जिन्हें वापस नहीं किया जा सकता. ऐसा इसलिए, क्योंकि लोग अक्सर विकल्प चुनते समय गलतियां करते हैं. इसके बजाय, ऐसा बटन जोड़ने पर विचार करें जो चुने गए मौजूदा विकल्पों की वैल्यू को पढ़ता है और फिर कार्रवाई को ट्रिगर करता है.
- ड्रॉपडाउन के लिए, विकल्पों को वर्णमाला के क्रम में या किसी ऐसे लॉजिकल स्कीम के हिसाब से क्रम में लगाएं जिसे सभी लोग समझ सकें. जैसे, हफ़्ते के दिनों को क्रम से दिखाना. इसके लिए, रविवार या सोमवार से शुरुआत की जा सकती है.
- चुने जाने वाले किसी इनपुट विजेट में, विकल्पों की संख्या को सीमित रखें. अगर बहुत ज़्यादा विकल्प हैं, तो लोगों को विजेट का इस्तेमाल करने में परेशानी हो सकती है. ऐसे मामलों में, विकल्प को अलग-अलग कैटगरी और कई विजेट में बांटने पर विचार करें.
टेक्स्ट इनपुट
टेक्स्ट इनपुट, लोगों को स्ट्रिंग डेटा डालने की जगह देते हैं.
- टेक्स्ट इनपुट का इस्तेमाल करके, लोगों से संभावित एंट्री के किसी खास सेट में से कोई एक एंट्री टाइप न कराएं. इसके बजाय, ड्रॉप-डाउन मेन्यू का इस्तेमाल करें.
- लोगों को सही फ़ॉर्मैट और कॉन्टेंट में टेक्स्ट डालने में मदद करने के लिए, हिंट और सुझावों का इस्तेमाल करें.
- अगर डाला जाने वाला टेक्स्ट कुछ शब्दों से ज़्यादा है, तो मल्टीलाइन टेक्स्ट इनपुट का इस्तेमाल करें.
ब्रैंडिंग
इस सेक्शन में, अपने ऐड-ऑन इंटरफ़ेस में ब्रैंडिंग एलिमेंट जोड़ने के लिए, उपयोगकर्ता अनुभव से जुड़े दिशा-निर्देश दिए गए हैं.
अपने ऐड-ऑन में
अगर आपको अपने ऐड-ऑन के यूज़र इंटरफ़ेस (यूआई) में ब्रैंडिंग शामिल करनी है, तो इसे छोटा और आसान रखें. इससे लोगों को आपके ऐड-ऑन की सुविधाओं पर फ़ोकस करने में मदद मिलती है.
- आपके ऐड-ऑन के सभी पहलुओं को ब्रैंडिंग के दिशा-निर्देशों का पालन करना होगा.
- "Google", "Gmail" या Google के अन्य प्रॉडक्ट के नाम शामिल न करें.
- Google के प्रॉडक्ट के आइकॉन शामिल न करें. भले ही, उनमें बदलाव किया गया हो.
- ब्रैंडिंग टेक्स्ट में "ऐड-ऑन" शब्द शामिल न करें.
- ब्रैंडिंग टेक्स्ट कुछ शब्दों से ज़्यादा नहीं होना चाहिए.
Google Workspace Marketplace में
पब्लिश करने के लिए ऐड-ऑन को कॉन्फ़िगर करते समय, Google Workspace Marketplace की लिस्टिंग बनाने के लिए, ग्राफ़िक और टेक्स्ट ऐसेट की जानकारी दें.
स्टोर पेज के सभी पहलुओं और इन ऐसेट को ब्रैंडिंग के दिशा-निर्देशों का पालन करना होगा.