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