Google Sign-In, OAuth 2.0 फ़्लो और टोकन लाइफ़साइकल को मैनेज करता है. इससे, Google API के साथ इंटिग्रेशन को आसान बनाना होता है. उपयोगकर्ता के पास किसी भी समय, किसी ऐप्लिकेशन का ऐक्सेस वापस लेने का विकल्प होता है.
इस दस्तावेज़ में, Google Sign-In के बुनियादी इंटिग्रेशन को पूरा करने का तरीका बताया गया है.
अनुमति देने वाले क्रेडेंशियल बनाना
Google API को ऐक्सेस करने के लिए OAuth 2.0 का इस्तेमाल करने वाले किसी भी ऐप्लिकेशन के पास, अनुमति देने वाले ऐसे क्रेडेंशियल होने चाहिए जिनसे Google के OAuth 2.0 सर्वर को ऐप्लिकेशन की पहचान की जा सके. यहां अपने प्रोजेक्ट के लिए क्रेडेंशियल बनाने का तरीका बताया गया है. इसके बाद, आपके ऐप्लिकेशन उन एपीआई को ऐक्सेस करने के लिए क्रेडेंशियल का इस्तेमाल कर सकते हैं जिन्हें आपने उस प्रोजेक्ट के लिए चालू किया है.
- Go to the Credentials page.
- क्रेडेंशियल बनाएं > OAuth क्लाइंट आईडी पर क्लिक करें.
- वेब ऐप्लिकेशन ऐप्लिकेशन टाइप चुनें.
- अपने OAuth 2.0 क्लाइंट को नाम दें और बनाएं पर क्लिक करें
कॉन्फ़िगरेशन पूरा होने के बाद, बनाए गए क्लाइंट आईडी को नोट करें. अगले चरण पूरे करने के लिए, आपको क्लाइंट आईडी की ज़रूरत होगी. (एक क्लाइंट सीक्रेट भी बनाया जाता है, लेकिन आपको इसकी ज़रूरत सिर्फ़ सर्वर साइड ऑपरेशंस के लिए होती है.)
Google Platform लाइब्रेरी लोड करना
आपको अपने उन वेब पेजों पर Google Platform Library शामिल करनी होगी जिनमें 'Google साइन इन' को इंटिग्रेट किया गया है.
<script src="https://apis.google.com/js/platform.js" async defer></script>
अपने ऐप्लिकेशन का क्लाइंट आईडी डालें
google-signin-client_id मेटा एलिमेंट की मदद से, Google Developers Console में अपने ऐप्लिकेशन के लिए बनाया गया क्लाइंट आईडी डालें.
<meta name="google-signin-client_id" content="YOUR_CLIENT_ID.apps.googleusercontent.com">
'Google साइन इन' बटन जोड़ना
अपनी साइट पर Google साइन इन बटन जोड़ने का सबसे आसान तरीका, अपने-आप रेंडर होने वाले साइन इन बटन का इस्तेमाल करना है. सिर्फ़ कुछ लाइनों के कोड की मदद से, ऐसा बटन जोड़ा जा सकता है जो उपयोगकर्ता के साइन-इन स्टेटस और आपके अनुरोध किए गए स्कोप के लिए, सही टेक्स्ट, लोगो, और रंगों के साथ अपने-आप कॉन्फ़िगर हो जाता है.
डिफ़ॉल्ट सेटिंग का इस्तेमाल करने वाला Google साइन इन बटन बनाने के लिए, अपने साइन इन पेज पर क्लास g-signin2 वाला div
एलिमेंट जोड़ें:
<div class="g-signin2" data-onsuccess="onSignIn"></div>
प्रोफ़ाइल की जानकारी पाना
डिफ़ॉल्ट स्कोप का इस्तेमाल करके, किसी उपयोगकर्ता को Google से साइन इन करने के बाद, आपके पास उस उपयोगकर्ता का Google आईडी, नाम, प्रोफ़ाइल यूआरएल, और ईमेल पता ऐक्सेस करने का विकल्प होता है.
किसी उपयोगकर्ता की प्रोफ़ाइल की जानकारी पाने के लिए, getBasicProfile() का इस्तेमाल करें.
function onSignIn(googleUser) {
var profile = googleUser.getBasicProfile();
console.log('ID: ' + profile.getId()); // Do not send to your backend! Use an ID token instead.
console.log('Name: ' + profile.getName());
console.log('Image URL: ' + profile.getImageUrl());
console.log('Email: ' + profile.getEmail()); // This is null if the 'email' scope is not present.
}
किसी उपयोगकर्ता को साइन आउट करना
उपयोगकर्ताओं को Google खाते से साइन आउट किए बिना, आपके ऐप्लिकेशन से साइन आउट करने की सुविधा दी जा सकती है. इसके लिए, अपनी साइट पर साइन आउट बटन या लिंक जोड़ें. साइन-आउट करने का लिंक बनाने के लिए, लिंक के onclick इवेंट में ऐसा फ़ंक्शन अटैच करें जो GoogleAuth.signOut() तरीका कॉल करता हो.
<a href="#" onclick="signOut();">Sign out</a>
<script>
function signOut() {
var auth2 = gapi.auth2.getAuthInstance();
auth2.signOut().then(function () {
console.log('User signed out.');
});
}
</script>