साइन-इन करने का अनुभव, आपके ऐड-ऑन के साथ उपयोगकर्ता का पहला इंटरैक्शन होता है, इसलिए यह ज़रूरी है कि वे जितना हो सके उतना आसानी से फ़्लो पूरा कर सकें. नीचे दिए गए सेक्शन पढ़ें और कई साइन-इन एपीआई, साइन-इन से जुड़े क्वेरी पैरामीटर, पॉप-अप ब्लॉकर को मैनेज करने के तरीके, और टेस्ट प्लान की जानकारी पाएं. टेस्ट प्लान का इस्तेमाल, डेवलपमेंट के दौरान यह पक्का करने के लिए किया जा सकता है कि आपने सबसे सही तरीकों का पालन किया है.
एसएसओ (SSO) लागू करने की जानकारी
Google का OAuth 2.0, कई OAuth 2.0 स्टैक के साथ काम करता है. हम आपको सर्वर-साइड की अनुमति लागू करने का सुझाव देते हैं, क्योंकि यह सुरक्षा का सबसे ऊंचा विकल्प है. साथ ही, इसमें iframe क्वेरी पैरामीटर का इस्तेमाल किया जा सकता है.
Google साइन-इन लागू करते समय, Google Identity वेबसाइट पर दिए गए तकनीकी दिशा-निर्देश देखें. Google के साइन-इन ब्रैंडिंग दिशा-निर्देशों का पालन ज़रूर करें. स्केच, SVG, और EPS फ़ाइलें डाउनलोड की जा सकती हैं.
साइन-इन टेस्ट
ऐड-ऑन टेस्ट प्लान का इस्तेमाल करके यह पता करें कि आपका ऐड-ऑन ज़रूरी मानकों को पूरा करता है या नहीं. साथ ही, ऐड-ऑन को समीक्षा के लिए सबमिट करने से पहले, वह ऐसे मामलों को ठीक कर सकता है या नहीं. ये टेस्ट, Classroom ऐड-ऑन की ज़रूरी शर्तों की चेकलिस्ट की तरह ही होते हैं. इनमें आपको सिलसिलेवार निर्देश भी मिलते हैं, जैसे कि यह जांचने का तरीका कि आपका ऐड-ऑन उन ज़रूरी शर्तों को पूरा करता है या नहीं. ये वही टेस्ट हैं जिनके आधार पर पब्लिकेशन के दौरान आपके ऐप्लिकेशन की जांच की जाती है.
साइन-इन क्वेरी पैरामीटर
Google Classroom, login_hint क्वेरी पैरामीटर उपलब्ध कराता है. इससे बार-बार साइन इन करने में मदद मिलती है. ज़्यादा जानकारी के लिए, iframe क्वेरी पैरामीटर पेज पर साइन-इन करने से जुड़े पैरामीटर वाला सेक्शन देखें. सैंपल कोड देखने के लिए, डेवलपर के लिए दिए गए हमारे सिलसिलेवार निर्देशों में, बार-बार होने वाले विज़िट को मैनेज करने के बारे में दिए गए कदम-दर-कदम निर्देश देखें.
पॉप-अप ब्लॉकर को मैनेज करना
साइन-इन डायलॉग विंडो से, ऐड-ऑन में साइन इन करने की सुविधा मिलती है. यह विंडो, खाता चुनने वाले की स्क्रीन दिखाती है. साथ ही, उपयोगकर्ता को OAuth अनुमतियां देने की अनुमति देती है. असली उपयोगकर्ता का पॉप-अप ब्लॉकर, उन्हें साइन इन फ़्लो पूरा करने से रोक सकता है.
पहला डायग्राम. खाता चुनने वाली स्क्रीन का उदाहरण.
इस समस्या को हल करने के लिए, असली उपयोगकर्ता को पॉप-अप ब्लॉकर को बायपास करने का बटन दें. यह इंटरैक्शन साइन-इन डायलॉग दिखाने की अनुमति देता है, ताकि असली उपयोगकर्ता साइन-इन फ़्लो को जारी रख सके. पक्का करें कि आपका दिया गया बटन, साइन-इन करने से जुड़े ब्रैंडिंग के दिशा-निर्देशों का पालन करता हो.
Google के ब्रैंडेड साइन-इन बटन को लागू करने के लिए, डेवलपर के लिए दिए गए हमारे सिलसिलेवार निर्देशों में साइन इन करने के लिए दिए गए कदम-दर-कदम निर्देश का पालन करें. इस बटन पर क्लिक करके, साइन-इन डायलॉग बॉक्स ट्रिगर हो सकता है.
एक से ज़्यादा लॉगिन
अगर ब्राउज़र में एक साथ कई खातों में साइन इन किया गया है, तो ऐड-ऑन यूज़र फ़्लो में रुकावट आ सकती है. असली उपयोगकर्ता, सही खाते से साइन इन करने और फिर से कार्रवाई करने की कोशिश करने से पहले, अपने मौजूदा ब्राउज़र में सभी Google खातों से साइन आउट कर सकते हैं या Classroom को गुप्त विंडो में खोल सकते हैं.
एक से ज़्यादा बार लॉगिन करने की समस्या की वजह से, अगर किसी गलत उपयोगकर्ता ने ऐड-ऑन में साइन इन किया है, तो हो सकता है कि Classroom ऐड-ऑन एपीआई को कॉल न कर पाएं. इसके लिए, InvalidAddOnToken गड़बड़ी हो सकती है. अगर आपको ऐसी गड़बड़ी मिलती है, तो आपको उपयोगकर्ता को
ब्राउज़र में अन्य सभी खातों से साइन आउट करने या
Classroom को किसी गुप्त Chrome विंडो में खोलने का निर्देश देना चाहिए.