ee.data.authenticateViaOauth

JavaScript के लिए Google APIs क्लाइंट लाइब्रेरी की मदद से, EE API कॉल की क्लाइंट-साइड पुष्टि को कॉन्फ़िगर करता है. अगर लाइब्रेरी पहले से पेज पर लोड नहीं है, तो वह अपने-आप लोड हो जाएगी. अगर उपयोगकर्ता ने पहले कभी ऐसा नहीं किया है, तो उससे कहा जाएगा कि वह clientId से पहचाने गए ऐप्लिकेशन को अपने EE डेटा का ऐक्सेस दे.

पुष्टि करने के इस या किसी दूसरे तरीके को ee.initialize() से पहले कॉल किया जाना चाहिए.

ध्यान दें कि अगर उपयोगकर्ता ने पहले क्लाइंट आईडी से पहचाने गए ऐप्लिकेशन को ऐक्सेस करने की अनुमति नहीं दी है, तो डिफ़ॉल्ट रूप से एक डायलॉग विंडो पॉप-अप होगी. इसमें उपयोगकर्ता को ज़रूरी अनुमति देने के लिए कहा जाएगा. हालांकि, ब्राउज़र इस पॉप-अप को ब्लॉक कर सकता है. इससे बचने के लिए, opt_onImmediateFailed कॉलबैक तय करें और उसमें पेज पर लॉगिन बटन रेंडर करें. इसके बाद, इस बटन के क्लिक इवेंट हैंडलर से ee.data.authenticateViaPopup() को कॉल करें. इससे ब्राउज़र, पॉप-अप को ब्लॉक नहीं कर पाता, क्योंकि यह अब उपयोगकर्ता की कार्रवाई का सीधा नतीजा है.

जब भी मुमकिन होगा, पुष्टि करने वाला टोकन अपने-आप रीफ़्रेश हो जाएगा. यह माना जा सकता है कि सभी असाइनोक कॉल, सही क्रेडेंशियल के साथ भेजे जाएंगे. हालांकि, सिंक्रोनस कॉल के लिए, आपको ee.data.getAuthToken() की मदद से पुष्टि करने के लिए, ऑथेंटिकेशन टोकन देखना चाहिए. अगर कोई टोकन नहीं है, तो मैन्युअल तरीके से ee.data.refreshAuthToken() को कॉल करें. टोकन रीफ़्रेश करने की प्रोसेस एसिंक्रोनस होती है. इसे सिंक्रोनस कॉल से पहले, मांग पर पर्दे के पीछे नहीं किया जा सकता.

इस्तेमाल	रिटर्न
ee.data.authenticateViaOauth(clientId, success, error, extraScopes, onImmediateFailed, suppressDefaultScopes)

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