'Google साइन इन' से माइग्रेट करना

इस गाइड से आपको ज़रूरी बदलावों को समझने और बेहतर तरीके से काम करने में पहले वाले 'Google साइन इन' से JavaScript लाइब्रेरी को माइग्रेट करें प्लैटफ़ॉर्म लाइब्रेरी को नई Google Identity Services लाइब्रेरी में पुष्टि करना.

यदि आपका क्लाइंट Google API क्लाइंट लाइब्रेरी का उपयोग JavaScript या किसी अन्य अनुमति के लिए के लिए पहले की लाइब्रेरी, देखें Google Identity पर माइग्रेट करें सेवाएं देखें.

पुष्टि करना और अनुमति देना

पुष्टि से पता चलता है कि कोई व्यक्ति कौन है और उसे आम तौर पर उपयोगकर्ता के साइन-अप या साइन-इन. अनुमति देना, एक प्रक्रिया के तौर पर डेटा या संसाधनों का ऐक्सेस अस्वीकार करना. उदाहरण के लिए, आपका ऐप्लिकेशन आपके उपयोगकर्ता की Google Drive को ऐक्सेस करने के लिए उपयोगकर्ता की सहमति.

'Google साइन-इन' प्लैटफ़ॉर्म की पिछली लाइब्रेरी की तरह, नई Google Identity सर्विस लाइब्रेरी को पुष्टि करने और अनुमति देने, दोनों का इस्तेमाल करने के लिए बनाया गया है प्रोसेस.

हालांकि, नई लाइब्रेरी में मुश्किलें कम करने के लिए, दोनों प्रोसेस को अलग किया जाता है ताकि डेवलपर आपके ऐप्लिकेशन के साथ Google खाते इंटिग्रेट कर सकें.

अगर आपके इस्तेमाल के उदाहरण में सिर्फ़ पुष्टि करने की सुविधा है, तो इस पेज को पढ़ना जारी रखें.

अगर आपके इस्तेमाल के उदाहरण में अनुमति शामिल है, तो उपयोगकर्ता की अनुमति के काम करने का तरीका लेख पढ़ें और यह पक्का करने के लिए कि आपका ऐप्लिकेशन अपडेट करने में मदद मिलेगी.

कौनसे बदलाव हुए हैं

नई Google Identity Services लाइब्रेरी से उपयोगकर्ताओं को कई तरह की सुविधाएं मिलती हैं उपयोगिता में सुधार किए गए हैं. हाइलाइट में ये शामिल हैं:

  • कम समस्याओं के साथ, One Tap और अपने-आप साइन-इन होने की नई प्रोसेस, कम लोगों के साथ कदम,
  • उपयोगकर्ताओं को उनकी पसंद के हिसाब से बनाने के साथ-साथ, 'साइन-इन करें' बटन रीफ़्रेश किया गया हो.
  • पूरे वेब पर, एक जैसी ब्रैंडिंग और साइन-इन करने के व्यवहार में सुधार होता है और भरोसा,
  • तेज़ी से कॉन्टेंट पर पहुंचने में मदद मिलती है; उपयोगकर्ता कहीं से भी सीधे साइन-अप और साइन-इन कर सकते हैं और लॉगिन या खाता पेज पर जाने की ज़रूरत नहीं.

डेवलपर के लिए, हमारा फ़ोकस जटिलता को कम करना, सुरक्षा को बेहतर बनाना, और इंटिग्रेशन को जल्द से जल्द करें. इनमें से कुछ सुधारों में शामिल हैं:

  • सिर्फ़ इसका इस्तेमाल करके उपयोगकर्ता साइन-इन को स्टैटिक कॉन्टेंट में जोड़ने का विकल्प एचटीएमएल,
  • साइन-इन की पुष्टि करने की प्रक्रिया को अनुमति देने और शेयर करने के अलग-अलग तरीके उपयोगकर्ता डेटा के लिए, OAuth 2.0 इंटिग्रेशन की जटिलता की अब ज़रूरत नहीं है उपयोगकर्ताओं को आपकी साइट पर साइन इन करने के लिए,
  • पॉप-अप और रीडायरेक्ट, दोनों मोड पहले की तरह काम करते रहेंगे, लेकिन Google का OAuth 2.0 इंफ़्रास्ट्रक्चर अब आपके बैकएंड सर्वर के लॉगिन एंडपॉइंट पर रीडायरेक्ट करता है,
  • Google Identity के पुराने और पुराने, दोनों वर्शन में मौजूद सुविधाओं को एक ही जगह पर इस्तेमाल किया जा सकता है और Google API JavaScript लाइब्रेरी को एक नई लाइब्रेरी में बदल देंगे,
  • देखने के लिए, अब आपके पास यह तय करने का विकल्प है कि गेटर स्टाइल फ़ंक्शन के ज़रिए Promise और इनडायरेक्ट होने पर, सादगी के लिए हटा दिया गया है.

साइन इन करने के तरीके को माइग्रेट करने का उदाहरण

अगर आपको मौजूदा 'Google साइन इन' बटन से माइग्रेट करना है और सिर्फ़ तो सबसे आसान बदलाव है आपके हिसाब से बनाए गए नए बटन पर अपडेट करने के लिए. इसके लिए, सभी बटन पर स्विच करने से JavaScript लाइब्रेरी और नए साइन-इन ऑब्जेक्ट का इस्तेमाल करने के लिए, अपने कोड बेस को अपडेट करना.

लाइब्रेरी और कॉन्फ़िगरेशन

'Google साइन-इन' प्लैटफ़ॉर्म की पुरानी लाइब्रेरी: apis.google.com/js/platform.js, और JavaScript के लिए Google API क्लाइंट लाइब्रेरी: gapi.client, कोई नहीं अब उपयोगकर्ता की पुष्टि करने और अनुमति देने के लिए ज़रूरी है. वे इसे Google Identity Services की नई JavaScript लाइब्रेरी से बदला गया है: accounts.google.com/gsi/client.

पहले के तीन JavaScript मॉड्यूल: api, client, और platform का इस्तेमाल इनके लिए किया जाता था साइन-इन की सभी सुविधाएं apis.google.com से लोड होती हैं. जगहों को पहचानने में आपकी मदद करने के लिए जहां पुरानी लाइब्रेरी को आपकी साइट में शामिल किया जा सकता है, आम तौर पर:

  • डिफ़ॉल्ट साइन-इन बटन, apis.google.com/js/platform.js को लोड करता है,
  • कस्टम बटन का ग्राफ़िक, apis.google.com/js/api:client.js को लोड करता है, और
  • gapi.client का डायरेक्ट इस्तेमाल से apis.google.com/js/api.js लोड होता है.

ज़्यादातर मामलों में आप अपने मौजूदा वेब ऐप्लिकेशन के क्लाइंट आईडी का इस्तेमाल करना जारी रख सकते हैं क्रेडेंशियल डालें. माइग्रेट करने की प्रोसेस के दौरान, हमारा सुझाव है कि आप OAuth 2.0 की नीतियां और Google API कंसोल का इस्तेमाल करें पुष्टि करने के लिए और अगर ज़रूरी हो, तो इन क्लाइंट सेटिंग को अपडेट करें:

  • आपके टेस्ट और प्रोडक्शन ऐप्लिकेशन, अलग-अलग प्रोजेक्ट का इस्तेमाल करते हैं और उनके अपने प्रोजेक्ट होते हैं क्लाइंट आईडी,
  • OAuth 2.0 क्लाइंट आईडी का टाइप "वेब ऐप्लिकेशन" है और
  • एचटीटीपीएस का इस्तेमाल, अनुमति वाले JavaScript ऑरिजिन और रीडायरेक्ट यूआरआई के लिए किया जाता है.

जिस कोड पर असर पड़ा है उसकी पहचान करना और जांच करना

डीबग कुकी से, उस कोड का पता लगाने और बंद होने के बाद की जांच करने में मदद मिल सकती है जिस पर असर हुआ है व्यवहार.

बड़े या जटिल ऐप्लिकेशन में, ऐसे सभी कोड को ढूंढना मुश्किल हो सकता है जिन पर gapi.auth2 मॉड्यूल का इस्तेमाल बंद कर दिया गया है. जल्द ही के मौजूदा इस्तेमाल को लॉग करने के लिए कंसोल में काम न करने वाली सुविधाओं के लिए, G_AUTH2_MIGRATION की वैल्यू सेट करें informational के लिए कुकी. वैकल्पिक रूप से, एक कोलन और उसके बाद एक कुंजी मान जोड़ें साथ ही, सेशन स्टोरेज में लॉग इन करें. साइन-इन करने और क्रेडेंशियल की समीक्षा करता है या बाद में विश्लेषण के लिए इकट्ठा किए गए लॉग को बैकएंड पर भेजता है. इसके लिए उदाहरण के लिए, informational:showauth2use ऑरिजिन और यूआरएल को सेशन के स्टोरेज में सेव करता है showauth2use नाम वाली कुंजी.

gapi.auth2 मॉड्यूल के लोड न होने पर ऐप्लिकेशन के काम करने के तरीके की पुष्टि करने के लिए, enforced के लिए G_AUTH2_MIGRATION कुकी की वैल्यू. इससे इनकी जांच की जा सकती है: बंद किए जाने के बाद की कार्रवाई.

G_AUTH2_MIGRATION कुकी की संभावित वैल्यू:

  • enforced gapi.auth2 मॉड्यूल लोड न करें.
  • informational JS कंसोल में, काम न करने वाली सुविधाओं के इस्तेमाल का लॉग बनाएं. लॉग भी करें कुंजी का वैकल्पिक नाम सेट होने पर, सेशन स्टोरेज में सेव करें: informational:key-name.

हमारा सुझाव है कि आप पहले इस कुकी को स्थानीय तौर पर सेट करें, ताकि उपयोगकर्ताओं पर इसका असर कम से कम हो को डेवलप करने और उसकी जांच करने के दौरान, उसे प्रोडक्शन एनवायरमेंट में इस्तेमाल करने से पहले.

एचटीएमएल और JavaScript

इस सिर्फ़ पुष्टि करने वाले साइन-इन के उदाहरण में, कोड और रेंडरिंग मौजूदा 'Google साइन इन' बटन दिख रहा है. पॉप-अप या रीडायरेक्ट में से कोई एक चुनें मोड का इस्तेमाल करके, यह देखा जा सकता है कि पुष्टि करने की प्रक्रिया JavaScript कॉलबैक या सुरक्षित रीडायरेक्ट के ज़रिए अपने बैकएंड सर्वर लॉगिन पर एंडपॉइंट का इस्तेमाल करें.

पहला तरीका

'Google साइन इन' बटन रेंडर करें और साइन इन को मैनेज करने के लिए कॉलबैक का इस्तेमाल करें उपयोगकर्ता के ब्राउज़र से साइन इन करें.

<html>
  <body>
    <script src="https://apis.google.com/js/platform.js" async defer></script>
    <meta name="google-signin-client_id" content="YOUR_CLIENT_ID">
    <div class="g-signin2" data-onsuccess="handleCredentialResponse"></div>
  </body>
</html>

रीडायरेक्ट मोड

'Google साइन-इन' बटन रेंडर करें. इस बटन के आखिर में उपयोगकर्ता का AJAX कॉल शुरू होगा ब्राउज़र को आपके बैकएंड सर्वर लॉगिन एंडपॉइंट पर ले जा सकते है.

<html>
  <body>
    <script src="https://apis.google.com/js/platform.js" async defer></script>
    <meta name="google-signin-client_id" content="YOUR_CLIENT_ID">
    <div class="g-signin2" data-onsuccess="handleCredentialResponse"></div>
    <script>
      function handleCredentialResponse(googleUser) {
        ...
        var xhr = new XMLHttpRequest();
        xhr.open('POST', 'https://yourbackend.example.com/tokensignin');
        xhr.setRequestHeader('Content-Type', 'application/x-www-form-urlencoded');
        xhr.onload = function() {
          console.log('Signed in as: ' + xhr.responseText);
        };
        xhr.send('idtoken=' + id_token);
      }
    </script>
  </body>
</html>

रेंडर किया गया

नए विज़ुअल-एट्रिब्यूट, कस्टमाइज़ किया गया बटन का इस्तेमाल करके, gapi.signin2.render() पर कॉल नहीं किए जा सकते. इसके अलावा, जिनका इस्तेमाल करके, अपनी साइट पर इमेज और विज़ुअल ऐसेट होस्ट की जा सकती हैं और उनका रखरखाव किया जा सकता है.

Google साइन-इन

Google साइन-इन

उपयोगकर्ता के साइन इन की स्थिति के अपडेट होने वाले बटन का टेक्स्ट.

नया तरीका

'सिर्फ़ पुष्टि करने के लिए साइन-इन करें' स्थिति में नई लाइब्रेरी इस्तेमाल करने के लिए, इसे चुनें पॉप-अप या रीडायरेक्ट मोड से बाहर निकाला जा सकता है और अपने लागू करें.

उपयोगकर्ता के ब्राउज़र से सीधे साइन इन को मैनेज करने के लिए, कॉलबैक का इस्तेमाल करें.

<html>
  <body>
    <script src="https://accounts.google.com/gsi/client" async defer></script>
    <div id="g_id_onload"
         data-client_id="YOUR_CLIENT_ID"
         data-callback="handleCredentialResponse">
    </div>
    <div class="g_id_signin" data-type="standard"></div>
  </body>
</html>

रीडायरेक्ट मोड

data-login_url में बताए गए तरीके से, Google आपके लॉगिन एंडपॉइंट को शुरू करता है एट्रिब्यूट की वैल्यू सबमिट करें. पहले, आप पीओएसटी कार्रवाई के लिए और पैरामीटर का नाम. नई लाइब्रेरी, आईडी टोकन को credential पैरामीटर. आखिर में, अपने बैकएंड पर आईडी टोकन की पुष्टि करें सर्वर.

<html>
  <body>
    <script src="https://accounts.google.com/gsi/client" async defer></script>
    <div id="g_id_onload"
         data-client_id="YOUR_CLIENT_ID"
         data-ux_mode="redirect"
         data-login_uri="https://www.example.com/your_login_endpoint">
    </div>
    <div class="g_id_signin" data-type="standard"></div>
  </body>
</html>

रेंडर किया गया

'Google से साइन इन करें' बटन को पसंद के मुताबिक बनाने के लिए, विज़ुअल एट्रिब्यूट इस्तेमाल करना साइज़, आकार, रंग. One Tap की पॉप-अप विंडो को अपने हिसाब से दिखाएं बटन का इस्तेमाल करें.

Google से साइन इन करें
बटन One Tap की सुविधा की मदद से
पॉप-अप

उपयोगकर्ता की साइन इन स्थिति, "साइन इन करें" वाले बटन के टेक्स्ट को अपडेट नहीं करती से "साइन इन किया हुआ है". सहमति देने या वापस आने के बाद, आपकी पसंद के हिसाब से बटन में उपयोगकर्ता का नाम, ईमेल, और प्रोफ़ाइल फ़ोटो शामिल होती है.

सिर्फ़ पुष्टि करने के इस उदाहरण में, नया accounts.google.com/gsi/client लाइब्रेरी, g_id_signin क्लास, और g_id_onload ऑब्जेक्ट पहले की जगह लेंगे apis.google.com/js/platform.js लाइब्रेरी और g-signin2 ऑब्जेक्ट.

आपके हिसाब से बनाए गए नए बटन को रेंडर करने के साथ ही, उदाहरण के लिए कोड भी One Tap का नया पॉप-अप दिखाता है. आपके हिसाब से बनाए गए बटन को दिखाने पर, हमारा सुझाव है कि उपयोगकर्ता को छोटा करने के लिए, One Tap का पॉप-अप भी दिखाएं साइन-अप और साइन-इन करने के दौरान आने वाली दिक्कतें.

हालांकि, साइन-इन करने के दौरान ज़्यादा परेशानी की वजह से, इसका सुझाव नहीं दिया जाता है, लेकिन नई आपके हिसाब से बनाए गए बटन को सिर्फ़ व्यक्ति के हिसाब से दिखाया जा सकता है. इसके लिए, उसे One Tap का डायलॉग. ऐसा करने के लिए, data-auto_prompt एट्रिब्यूट को false पर सेट करें.

एचटीएमएल और JavaScript एपीआई

पिछले उदाहरण में, साइन इन जोड़ने के लिए नए HTML API का इस्तेमाल करने का तरीका बताया गया है आपकी वेबसाइट पर आते हैं. इसके अलावा, एक ही तरह का दूसरा फ़ंक्शन इस्तेमाल किया जा सकता है. JavaScript API या अपने अलग-अलग प्लैटफ़ॉर्म पर, एचटीएमएल और JavaScript API के मिले-जुले रूप का इस्तेमाल करें की वेबसाइट पर जाएं.

बटन को अपनी पसंद के मुताबिक बनाने के विकल्पों को इंटरैक्टिव तौर पर देखने के लिए, जैसे कि कॉलबैक टाइप और विशेषताएं जैसे: रंग, आकार, आकार, टेक्स्ट और थीम, हमारा कोड जनरेटर. इसका इस्तेमाल अलग-अलग विकल्पों की तुलना तेज़ी से करने और आपकी साइट पर इस्तेमाल करने के लिए एचटीएमएल स्निपेट.

One Tap की मदद से, किसी भी पेज से साइन-इन करें

One Tap की सुविधा की मदद से, लोग आपकी साइट पर आसानी से साइन-अप या साइन इन कर सकते हैं. इसकी मदद से, उपयोगकर्ता सीधे आपकी साइट के किसी भी पेज से साइन इन कर सकते हैं और अब उपयोगकर्ताओं को अलग से लॉगिन पेज पर जाने की ज़रूरत नहीं पड़ती. दूसरे तरीके से, इससे साइन-अप और साइन-इन करने में आने वाली दिक्कतें कम हो जाती हैं. इससे लोगों को ये काम करने के विकल्प मिलते हैं आपके प्रवेश पेज के अलावा अन्य पेजों से साइन-अप और साइन-इन.

हमारा सुझाव है कि किसी भी पेज से साइन-इन करने की सुविधा चालू करने के लिए, आप g_id_onload को इसमें शामिल करें आपकी पूरी साइट में शेयर किया गया कोई हेडर, फ़ुटर या अन्य ऑब्जेक्ट.

हमारा सुझाव है कि आप g_id_signin को जोड़ें. इससे आपको अपने हिसाब से साइन-इन करने की सुविधा मिलती है बटन, सिर्फ़ आपके लॉगिन या उपयोगकर्ता खाता मैनेजमेंट पेजों पर. उपयोगकर्ताओं को विकल्प दें अन्य फ़ेडरेटेड कॉन्टेंट के साथ बटन दिखाकर साइन-अप या साइन-इन करने के लिए आइडेंटिटी प्रोवाइडर बटन और उपयोगकर्ता नाम और पासवर्ड डालने के फ़ील्ड.

टोकन रिस्पॉन्स

उपयोगकर्ता साइन-इन के लिए, अब आपको OAuth 2.0 को समझने या उसके साथ काम करने की ज़रूरत नहीं है ऑथराइज़ेशन कोड, ऐक्सेस टोकन या रीफ़्रेश टोकन. इसके बजाय, JSON वेब टोकन इस्तेमाल करें (JWT) आईडी टोकन का इस्तेमाल, साइन-इन की स्थिति और उपयोगकर्ता की प्रोफ़ाइल शेयर करने के लिए किया जाता है. बतौर उसे और आसान बना दिया है, अब आपको "गेटर" का इस्तेमाल करने की ज़रूरत नहीं है स्टाइल ऐक्सेसर के तरीके बताए गए हैं, ताकि उपयोगकर्ता की प्रोफ़ाइल के डेटा के साथ काम किया जा सके.

इनमें से किसी एक में, Google का हस्ताक्षर किया गया JWT आईडी टोकन क्रेडेंशियल भी दिया जाता है:

  • उपयोगकर्ता के ब्राउज़र पर आधारित JavaScript कॉलबैक हैंडलर के लिए, या
  • जब Google आपके लॉगिन एंडपॉइंट पर रीडायरेक्ट करता है, तब 'Google से साइन इन करें' बटन ux_mode को redirect पर सेट किया गया है.

दोनों ही मामलों में, इन्हें हटाकर अपने मौजूदा कॉलबैक हैंडलर को अपडेट करें:

  • googleUser.getBasicProfile() पर किए गए कॉल,
  • BasicProfile के रेफ़रंस और getId() को किए गए संबंधित कॉल, getName(), getGivenName(), getFamilyName(), getImageUrl(), getEmail() तरीके और
  • AuthResponse ऑब्जेक्ट का इस्तेमाल.

इसके बजाय, नए JWT में credential सब-फ़ील्ड के डायरेक्ट रेफ़रंस का इस्तेमाल करें CredentialResponse ऑब्जेक्ट, उपयोगकर्ता की प्रोफ़ाइल के डेटा के साथ काम करेगा.

इसके अलावा, सिर्फ़ रीडायरेक्ट मोड के लिए, क्रॉस-साइट अनुरोध रोकने का ध्यान रखें जालसाज़ी (सीएसआरएफ) करें और अपने बैकएंड सर्वर पर Google आईडी टोकन की पुष्टि करें.

यह समझने के लिए कि उपयोगकर्ता आपकी साइट से कैसे इंटरैक्ट कर रहे हैं CredentialResponse में मौजूद select_by फ़ील्ड का इस्तेमाल करके, उपयोगकर्ता का पता लगाया जा सकता है सहमति के नतीजे और साइन-इन के खास फ़्लो का इस्तेमाल किया जाता है.

जब कोई उपयोगकर्ता पहली बार आपकी वेबसाइट में साइन इन करता है, तो Google, उपयोगकर्ता से सहमति लेने के लिए कहता है आपके ऐप्लिकेशन के साथ अपने खाते की प्रोफ़ाइल शेयर कर सकते हैं. सहमति देने के बाद ही उपयोगकर्ता की प्रोफ़ाइल को, आईडी टोकन क्रेडेंशियल पेलोड में आपके ऐप्लिकेशन के साथ शेयर किया गया हो. इस प्रोफ़ाइल का ऐक्सेस वापस लेना, पिछली साइन इन लाइब्रेरी.

उपयोगकर्ता, अनुमतियां रद्द कर सकते हैं और आपके ऐप्लिकेशन को अपने Google खाते से डिसकनेक्ट कर सकते हैं इसके लिए, https://myaccount.google.com/permissions पर जाएं. इसके अलावा, वे एपीआई को ट्रिगर करके, सीधे आपके ऐप्लिकेशन से डिसकनेक्ट हो सकते हैं लागू करने के लिए कहा जाता है; disconnect वाला पुराना तरीका इसे revoke वाले नए तरीके से बदला गया.

जब कोई उपयोगकर्ता आपके प्लैटफ़ॉर्म से अपना खाता मिटाता है, तब इसका इस्तेमाल करना सबसे सही तरीका है आपके ऐप्लिकेशन को उनके Google खाते से डिसकनेक्ट करने के लिए revoke.

पहले, auth2.signOut() का इस्तेमाल उपयोगकर्ता के साइन-आउट को मैनेज करने के लिए किया जा सकता था आपके ऐप्लिकेशन से. auth2.signOut() के इस्तेमाल को अब हटा दिया जाना चाहिए और आपके ऐप्लिकेशन को भी हर उपयोगकर्ता के सेशन की स्थिति और साइन-इन स्थिति को सीधे तौर पर मैनेज किया जाना चाहिए.

सेशन की स्थिति और लिसनर

नई लाइब्रेरी में, आपके वेब वर्शन पर साइन इन किए जाने की स्थिति या सेशन की स्थिति नहीं सेव की जाती है.

Google खाते में साइन इन किए जाने की स्थिति, आपके ऐप्लिकेशन के सेशन की स्थिति, और साइन-इन स्टेटस, अलग-अलग कॉन्सेप्ट हैं.

उपयोगकर्ता के Google खाते और आपके ऐप्लिकेशन में साइन इन की स्थिति, दोनों पर निर्भर नहीं करती है इसके अलावा, साइन-इन करने के दौरान वह समय न दिखे, जब आपको यह पता हो कि उपयोगकर्ता के पास की पुष्टि हो गई है और उसे अपने Google खाते में साइन इन कर दिया गया है.

जब Google से साइन इन करें, One Tap या अपने-आप साइन-इन होने की सुविधा को आपकी साइट के उपयोगकर्ताओं को पहले अपने Google खाते में साइन-इन करना होगा, ताकि:

  • पहली बार साइन-अप करते समय, अपनी उपयोगकर्ता की प्रोफ़ाइल शेयर करने की सहमति देनी होगी या साइट में साइन इन करके,
  • पर साइन-इन करने और बाद में अपनी साइट पर वापस आने के लिए किया जा सकता है.

उपयोगकर्ता साइन-इन या साइन-आउट कर सकते हैं या किसी दूसरे Google खाते पर स्विच कर सकते हैं साथ ही, वह आपकी वेबसाइट पर ऐक्टिव और साइन-इन किए हुए सेशन को बनाए रख सके.

अब आप के उपयोगकर्ताओं के लिए साइन-इन स्थिति को सीधे प्रबंधित करने के लिए ज़िम्मेदार हैं आपका वेब ऐप्लिकेशन. इससे पहले, 'Google साइन-इन' की मदद से उपयोगकर्ता सेशन की स्थिति.

auth2.attachClickHandler() और इसके रजिस्टर किए गए सभी रेफ़रंस हटाएं कॉलबैक हैंडलर.

पहले, लिसनर का इस्तेमाल उपयोगकर्ता खाता होना चाहिए. लिसनर अब काम नहीं करते.

listen(), auth2.currentUser, और से जुड़ी सभी रेफ़रंस हटाएं auth2.isSignedIn.

कुकी

'Google से साइन इन करें' सुविधा, कुकी का सीमित इस्तेमाल करती है. यह इन कुकी के बारे में जानकारी देती है अनुसरण करता है. Google, कुकी का इस्तेमाल कैसे करता है लेख पढ़ें को देखें.

G_ENABLED_IDPS कुकी, जिसे 'Google साइन-इन प्लैटफ़ॉर्म' की पिछली लाइब्रेरी से सेट किया गया है का इस्तेमाल नहीं किया जाता.

Google Identity Services की नई लाइब्रेरी, विकल्प के तौर पर इन क्रॉस-डोमेन को सेट कर सकती है कुकी आपके कॉन्फ़िगरेशन विकल्पों पर आधारित होती हैं:

  • g_state, उपयोगकर्ता के साइन आउट होने की स्थिति सेव करता है. साथ ही, One Tap की सुविधा का इस्तेमाल करते समय इसे सेट किया जाता है या अपने-आप साइन-इन होने की सुविधा मिलती है,
  • g_csrf_token, दो बार सबमिट की जाने वाली कुकी है. इसका इस्तेमाल, CSRF हमलों को रोकने के लिए किया जाता है और यह तब सेट होता है, जब आपके लॉगिन एंडपॉइंट पर कॉल किया जाता है. आपके लॉगिन यूआरआई का मान को स्पष्ट रूप से सेट किया जा सकता है या वह वर्तमान पेज के यूआरआई के साथ डिफ़ॉल्ट रूप से सेट हो सकता है. आपका लॉगिन एंडपॉइंट को इन शर्तों के तहत कॉल किया जा सकता है. ऐसा तब किया जाता है, जब इनका इस्तेमाल किया जा रहा हो:

    • data-ux_mode=redirect वाला HTML API या जब data-login_uri होता है सेट या

    • JavaScript API के साथ ux_mode=redirect और जहां google.accounts.id.prompt() का इस्तेमाल One Tap को दिखाने के लिए नहीं किया जाता है या अपने-आप साइन इन होना.

अगर आपके पास कोई ऐसी सेवा है जो कुकी मैनेज करती है, तो दो नई कुकी ज़रूर जोड़ें माइग्रेशन पूरा होने पर, पुरानी कुकी को हटा दें.

अगर आप एक से ज़्यादा डोमेन या सबडोमेन को मैनेज करते हैं, तो 'Google डिसप्ले नेटवर्क पर एक टैप में सभी कार्रवाइयां' लेख देखें) सबडोमेन ताकि g_state कुकी के साथ काम करने के बारे में ज़्यादा निर्देशों का पालन किया जा सके.

उपयोगकर्ता साइन इन के लिए, ऑब्जेक्ट माइग्रेशन के बारे में जानकारी

पुराना नए दर्शक नोट
JavaScript लाइब्रेरी
apis.google.com/js/platform.js accounts.google.com/gsi/client पुराने को नए से बदलें.
apis.google.com/js/api.js accounts.google.com/gsi/client पुराने को नए से बदलें.
GoogleAuth ऑब्जेक्ट और संबंधित तरीके:
GoogleAuth.attachClickHandler() IdConfiguration.callback JS और एचटीएमएल डेटा-कॉलबैक के लिए पुराने को नए से बदलें.
GoogleAuth.currentUser.get() CredentialResponse इसके बजाय, CredentialResponse का इस्तेमाल करें. अब आपको इसकी ज़रूरत नहीं है.
GoogleAuth.currentUser.listen() हटाएं पर टैप करें. Google पर उपयोगकर्ता के साइन-इन करने की मौजूदा स्थिति की जानकारी उपलब्ध नहीं है. उपयोगकर्ताओं की सहमति लेने और साइन-इन करने के दौरान, यह ज़रूरी है कि उन्होंने Google में साइन-इन किया हो. कॉन्टेंट बनाने select_by CredentialResponse के फ़ील्ड का इस्तेमाल करके, साइन-इन करने के तरीके के साथ-साथ उपयोगकर्ता की सहमति लेते हैं.
GoogleAuth.disconnect() google.accounts.id.revoke पुराने को नए से बदलें. https://myaccount.google.com/permissions पर जाकर भी, सहमति को रद्द किया जा सकता है
GoogleAuth.grantOfflineAccess() हटाएं पर टैप करें. आईडी टोकन ने OAuth 2.0 ऐक्सेस टोकन और स्कोप की जगह ले ली है.
GoogleAuth.isSignedIn.get() हटाएं पर टैप करें. Google पर उपयोगकर्ता के साइन-इन करने की मौजूदा स्थिति की जानकारी उपलब्ध नहीं है. उपयोगकर्ताओं की सहमति लेने और साइन-इन करने के दौरान, यह ज़रूरी है कि उन्होंने Google में साइन-इन किया हो.
GoogleAuth.isSignedIn.listen() हटाएं पर टैप करें. Google पर उपयोगकर्ता के साइन-इन करने की मौजूदा स्थिति की जानकारी उपलब्ध नहीं है. उपयोगकर्ताओं की सहमति लेने और साइन-इन करने के दौरान, यह ज़रूरी है कि उन्होंने Google में साइन-इन किया हो.
GoogleAuth.signIn() हटाएं पर टैप करें. HTML DOM लोडिंग g_id_signin या JS कॉल टू google.accounts.id.renderButton ट्रिगर करती है, जब कोई उपयोगकर्ता Google खाते में साइन-इन करता है.
GoogleAuth.signOut() हटाएं पर टैप करें. आपके ऐप्लिकेशन और Google खाते के लिए, उपयोगकर्ता की साइन इन की स्थिति: स्वतंत्र. Google आपके ऐप्लिकेशन के लिए, सेशन की स्थिति को मैनेज नहीं करता.
GoogleAuth.then() हटाएं पर टैप करें. GoogleAuth अब सेवा में नहीं है.
GoogleUser ऑब्जेक्ट और उससे जुड़े तरीके:
GoogleUser.disconnect() google.accounts.id.revoke पुराने को नए से बदलें. https://myaccount.google.com/permissions पर जाकर भी, सहमति को रद्द किया जा सकता है
GoogleUser.getAuthResponse()
GoogleUser.getBasicProfile() CredentialResponse BasicProfile के बजाय, सीधे credential और सब-फ़ील्ड का इस्तेमाल करें.
GoogleUser.getGrantedScopes() हटाएं पर टैप करें. आईडी टोकन ने OAuth 2.0 ऐक्सेस टोकन और स्कोप की जगह ले ली है.
GoogleUser.getHostedDomain() CredentialResponse इसके बजाय, सीधे credential.hd का इस्तेमाल करें.
GoogleUser.getId() CredentialResponse इसके बजाय, सीधे credential.sub का इस्तेमाल करें.
GoogleUser.grantOfflineAccess() हटाएं पर टैप करें. आईडी टोकन ने OAuth 2.0 ऐक्सेस टोकन और स्कोप की जगह ले ली है.
GoogleUser.grant() हटाएं पर टैप करें. आईडी टोकन ने OAuth 2.0 ऐक्सेस टोकन और स्कोप की जगह ले ली है.
GoogleUser.hasGrantedScopes() हटाएं पर टैप करें. आईडी टोकन ने OAuth 2.0 ऐक्सेस टोकन और स्कोप की जगह ले ली है.
GoogleUser.isSignedIn() हटाएं पर टैप करें. Google पर उपयोगकर्ता के साइन-इन करने की मौजूदा स्थिति की जानकारी उपलब्ध नहीं है. उपयोगकर्ताओं की सहमति लेने और साइन-इन करने के दौरान, यह ज़रूरी है कि उन्होंने Google में साइन-इन किया हो.
GoogleUser.reloadAuthResponse() हटाएं पर टैप करें. आईडी टोकन ने OAuth 2.0 ऐक्सेस टोकन और स्कोप की जगह ले ली है.
gapi.auth2 ऑब्जेक्ट और उससे जुड़े तरीके:
gapi.auth2.AuthorizeConfig ऑब्जेक्ट हटाएं पर टैप करें. आईडी टोकन ने OAuth 2.0 ऐक्सेस टोकन और स्कोप की जगह ले ली है.
gapi.auth2.AuthorizeResponse ऑब्जेक्ट हटाएं पर टैप करें. आईडी टोकन ने OAuth 2.0 ऐक्सेस टोकन और स्कोप की जगह ले ली है.
gapi.auth2.AuthResponse ऑब्जेक्ट हटाएं पर टैप करें. आईडी टोकन ने OAuth 2.0 ऐक्सेस टोकन और स्कोप की जगह ले ली है.
gapi.auth2.authorize() हटाएं पर टैप करें. आईडी टोकन ने OAuth 2.0 ऐक्सेस टोकन और स्कोप की जगह ले ली है.
gapi.auth2.ClientConfig() हटाएं पर टैप करें. आईडी टोकन ने OAuth 2.0 ऐक्सेस टोकन और स्कोप की जगह ले ली है.
gapi.auth2.getAuthInstance() हटाएं पर टैप करें. आईडी टोकन ने OAuth 2.0 ऐक्सेस टोकन और स्कोप की जगह ले ली है.
gapi.auth2.init() हटाएं पर टैप करें. आईडी टोकन ने OAuth 2.0 ऐक्सेस टोकन और स्कोप की जगह ले ली है.
gapi.auth2.offlineAccessOptions ऑब्जेक्ट हटाएं पर टैप करें. आईडी टोकन ने OAuth 2.0 ऐक्सेस टोकन और स्कोप की जगह ले ली है.
gapi.auth2.SignInOptions ऑब्जेक्ट हटाएं पर टैप करें. आईडी टोकन ने OAuth 2.0 ऐक्सेस टोकन और स्कोप की जगह ले ली है.
gapi.signin2 ऑब्जेक्ट और उससे जुड़े तरीके:
gapi.signin2.render() हटाएं पर टैप करें. HTML DOM लोडिंग g_id_signin या JS कॉल टू google.accounts.id.renderButton ट्रिगर करती है, जो किसी Google खाते में उपयोगकर्ता के साइन-इन को ट्रिगर करती है.