पुष्टि करने के इस तरीके या किसी दूसरे तरीके को ee.initialize() से पहले कॉल किया जाना चाहिए.
ध्यान दें कि अगर उपयोगकर्ता ने क्लाइंट आईडी से पहचाने गए ऐप्लिकेशन को पहले से ऐक्सेस करने की अनुमति नहीं दी है, तो डिफ़ॉल्ट रूप से एक डायलॉग विंडो पॉप-अप होगी. इसमें उपयोगकर्ता से ज़रूरी अनुमति देने के लिए कहा जाएगा. हालांकि, ब्राउज़र इस पॉप-अप को ब्लॉक कर सकता है. इससे बचने के लिए, opt_onImmediateFailed कॉलबैक तय करें. इसके बाद, इसमें पेज पर मौजूद लॉगिन बटन रेंडर करें. फिर, इस बटन के क्लिक इवेंट हैंडलर से ee.data.authenticateViaPopup() को कॉल करें. इससे ब्राउज़र, पॉप-अप को ब्लॉक नहीं करता है. ऐसा इसलिए, क्योंकि अब यह सीधे तौर पर उपयोगकर्ता की कार्रवाई का नतीजा है.
जब भी मुमकिन होगा, तब पुष्टि करने वाले टोकन को अपने-आप रीफ़्रेश कर दिया जाएगा. यह माना जा सकता है कि सभी एसिंक कॉल, सही क्रेडेंशियल के साथ भेजे जाएंगे. हालांकि, सिंक्रोनस कॉल के लिए, आपको ee.data.getAuthToken() की मदद से, पुष्टि करने वाले टोकन की जांच करनी चाहिए. अगर कोई टोकन नहीं है, तो ee.data.refreshAuthToken() को मैन्युअल तरीके से कॉल करें. टोकन रीफ़्रेश करने की प्रोसेस एसिंक्रोनस होती है. इसे सिंक्रोनस कॉल से पहले, ज़रूरत के हिसाब से बैकग्राउंड में नहीं किया जा सकता.
| इस्तेमाल | रिटर्न |
|---|---|
ee.data.authenticateViaOauth(clientId, success, error, extraScopes, onImmediateFailed, suppressDefaultScopes) |
| आर्ग्यूमेंट | टाइप | विवरण |
|---|---|---|
clientId | स्ट्रिंग | ऐप्लिकेशन का OAuth क्लाइंट आईडी या पुष्टि किए गए कॉल को बंद करने के लिए शून्य. इसे Google Developers Console से हासिल किया जा सकता है. प्रोजेक्ट में ऐसा JavaScript ऑरिजिन होना चाहिए जो उस डोमेन से मेल खाता हो जहां स्क्रिप्ट चल रही है. |
success | फ़ंक्शन | पुष्टि हो जाने पर कॉल करने के लिए फ़ंक्शन. |
error | फ़ंक्शन, ज़रूरी नहीं है | पुष्टि न होने पर कॉल किया जाने वाला फ़ंक्शन, जिसमें गड़बड़ी का मैसेज पास किया गया है. अगर तुरंत (बिहाइंड-द-सीन) मोड में पुष्टि नहीं हो पाती है और opt_onImmediateFailed तय किया गया है, तो opt_error के बजाय उस फ़ंक्शन को कॉल किया जाता है. |
extraScopes | List[String], optional | अनुरोध करने के लिए, OAuth के अतिरिक्त स्कोप. |
onImmediateFailed | फ़ंक्शन, ज़रूरी नहीं है | अगर पर्दे के पीछे अपने-आप होने वाला पुष्टि करने का प्रोसेस पूरा नहीं होता है, तो कॉल करने के लिए फ़ंक्शन. डिफ़ॉल्ट रूप से ee.data.authenticateViaPopup() पर सेट होता है. यह पास किए गए कॉलबैक से जुड़ा होता है. |
suppressDefaultScopes | बूलियन, ज़रूरी नहीं | जब यह वैल्यू सही होती है, तब सिर्फ़ opt_extraScopes में बताए गए स्कोप का अनुरोध किया जाता है. डिफ़ॉल्ट स्कोप का अनुरोध तब तक नहीं किया जाता, जब तक कि उन्हें opt_extraScopes में साफ़ तौर पर न बताया गया हो. |