इस गाइड में, Google Sign-in प्लैटफ़ॉर्म लाइब्रेरी के ज़रिए FedCM API को अपनाने के बारे में बताया गया है. इस लेख में, लाइब्रेरी को पुराने वर्शन के साथ काम करने वाले वर्शन में अपडेट करने के लिए, टाइमलाइन और अगले चरण के बारे में बताया गया है. साथ ही, असर का आकलन करने और यह पुष्टि करने का तरीका भी बताया गया है कि उपयोगकर्ता का साइन-इन, उम्मीद के मुताबिक काम कर रहा है. ज़रूरत पड़ने पर, अपने वेब ऐप्लिकेशन को अपडेट करने के निर्देश भी दिए गए हैं. ट्रांज़िशन पीरियड मैनेज करने के विकल्पों के साथ-साथ, सहायता पाने का तरीका भी बताया गया है.
लाइब्रेरी का स्टेटस
नए वेब ऐप्लिकेशन, 'Google साइन इन' प्लैटफ़ॉर्म की लाइब्रेरी का इस्तेमाल नहीं कर सकते. हालांकि, लाइब्रेरी का इस्तेमाल करने वाले ऐप्लिकेशन अगली सूचना मिलने तक इसका इस्तेमाल कर सकते हैं. लाइब्रेरी के बंद होने की आखिरी तारीख (बंद होने) तय नहीं हुई है. ज़्यादा जानकारी के लिए, सहायता बंद होने और बंद होने की प्रक्रिया देखें.
पुराने सिस्टम के साथ काम करने वाले अपडेट में, Google Sign-In लाइब्रेरी में FedCM API जोड़े गए हैं. ज़्यादातर बदलाव बिना किसी रुकावट के लागू हो जाते हैं. हालांकि, अपडेट में उपयोगकर्ता के प्रॉम्प्ट, iframe permissions-policy, और कॉन्टेंट की सुरक्षा के बारे में नीति (सीएसपी) में बदलाव किए गए हैं. इन बदलावों से आपके वेब ऐप्लिकेशन पर असर पड़ सकता है. साथ ही, ऐप्लिकेशन कोड और साइट कॉन्फ़िगरेशन में बदलाव करने की ज़रूरत पड़ सकती है.
ट्रांज़िशन की अवधि के दौरान, कॉन्फ़िगरेशन के विकल्प से यह कंट्रोल किया जाता है कि उपयोगकर्ता के साइन-इन के दौरान, FedCM API का इस्तेमाल किया जाए या नहीं.
ट्रांज़िशन पीरियड के बाद, Google Sign-In लाइब्रेरी का इस्तेमाल करने वाले सभी वेब ऐप्लिकेशन के लिए, FedCM API का इस्तेमाल करना ज़रूरी है.
टाइमलाइन
पिछली बार सितंबर 2024 में अपडेट किया गया
इन तारीखों और बदलावों का असर उपयोगकर्ताओं के साइन इन करने के तरीके पर पड़ता है:
- मार्च 2023 Google Sign-in प्लैटफ़ॉर्म की लाइब्रेरी के लिए, सहायता बंद कर दी जाएगी.
- जुलाई 2024 में ट्रांज़िशन पीरियड शुरू होता है. साथ ही, Google साइन इन प्लैटफ़ॉर्म लाइब्रेरी में, FedCM API के लिए सहायता जोड़ी जाती है. डिफ़ॉल्ट रूप से, इस समय के दौरान उपयोगकर्ता के साइन-इन करने के अनुरोधों का प्रतिशत Google FedCM का इस्तेमाल करके तय करता है. वेब ऐप्लिकेशन,
use_fedcm
पैरामीटर का इस्तेमाल करके, इस व्यवहार को साफ़ तौर पर बदल सकते हैं. - Google साइन इन प्लैटफ़ॉर्म लाइब्रेरी के लिए, FedCM एपीआई का मार्च 2025 से ज़रूरी रूप से इस्तेमाल करना होगा. इसके बाद,
use_fedcm
पैरामीटर को अनदेखा कर दिया जाएगा और उपयोगकर्ता के सभी साइन इन अनुरोधों के लिए, FedCM का इस्तेमाल किया जाएगा.
अगले चरण
आपके पास इन तीन विकल्पों में से किसी एक को चुनने का विकल्प है:
- असर का आकलन करें. अगर ज़रूरी हो, तो अपने वेब ऐप्लिकेशन को अपडेट करें. इससे यह आकलन किया जाता है कि जिन सुविधाओं के लिए आपके वेब ऐप्लिकेशन में बदलाव करना ज़रूरी है उनका इस्तेमाल किया जा रहा है या नहीं. इस गाइड के अगले सेक्शन में निर्देश दिए गए हैं.
- Google Identity Services (GIS) लाइब्रेरी में ले जाएं. हमारा सुझाव है कि आप नई और काम करने वाली साइन-इन लाइब्रेरी पर स्विच करें. इसके लिए, इन निर्देशों का पालन करें.
- कुछ न करें. जब उपयोगकर्ता के साइन इन करने के लिए, Google Sign-in लाइब्रेरी को FedCM API पर माइग्रेट किया जाएगा, तब आपका वेब ऐप्लिकेशन अपने-आप अपडेट हो जाएगा. यह सबसे कम काम है, लेकिन इस बात का थोड़ा जोखिम है कि उपयोगकर्ता आपके वेब ऐप्लिकेशन में साइन-इन न कर पाएं.
असर का आकलन करना
इन निर्देशों का पालन करके यह पता लगाएं कि आपके वेब ऐप्लिकेशन को, बैकवर्ड कम्पैटिबल अपडेट की मदद से आसानी से अपडेट किया जा सकता है या नहीं. इसके अलावा, यह भी पता लगाएं कि Google Sign-in प्लैटफ़ॉर्म लाइब्रेरी के FedCM API को पूरी तरह से अपनाने पर, उपयोगकर्ताओं को साइन-इन करने में आने वाली समस्याओं से बचने के लिए बदलाव करना ज़रूरी है या नहीं.
सेटअप
उपयोगकर्ता के लिए साइन-इन करने के दौरान, ब्राउज़र एपीआई और 'Google साइन इन' प्लैटफ़ॉर्म लाइब्रेरी के नए वर्शन के लिए FedCM का इस्तेमाल करना ज़रूरी है.
आगे बढ़ने से पहले:
- Chrome for Desktop को नए वर्शन पर अपडेट करें. Android के लिए Chrome का इस्तेमाल करने के लिए, M128 या इसके बाद के वर्शन वाले वर्शन की ज़रूरत होती है और इसकी जांच पुराने वर्शन पर नहीं की जा सकती.
chrome://flags
खोलें और इन सुविधाओं को इन वैल्यू पर सेट करें:- #fedcm-authz चालू है
- #tracking-protection-3pcd चालू है
- #third-party-cookie-deprecation-trial बंद है
- #tpcd-metadata-grants बंद है
- #tpcd-heuristics-grants बंद है
और Chrome को फिर से लॉन्च करें.
अपने वेब ऐप्लिकेशन में Google साइन इन प्लैटफ़ॉर्म की लाइब्रेरी को शुरू करते समय,
use_fedcm
कोtrue
पर सेट करें. आम तौर पर, शुरू करने की प्रोसेस इस तरह दिखती है:gapi.client.init({use_fedcm: true})
याgapi.auth2.init({use_fedcm: true})
याgapi.auth2.authorize({use_fedcm: true})
.
Google Sign-in प्लैटफ़ॉर्म लाइब्रेरी के कैश मेमोरी में सेव किए गए वर्शन अमान्य कर दें. आम तौर पर, यह चरण ज़रूरी नहीं होता, क्योंकि लाइब्रेरी का नया वर्शन सीधे ब्राउज़र पर डाउनलोड हो जाता है. इसके लिए,
<script src>
टैग मेंapi.js
,client.js
याplatform.js
शामिल किए जाते हैं. अनुरोध, लाइब्रेरी के लिए इनमें से किसी भी बंडल नाम का इस्तेमाल कर सकता है.अपने OAuth क्लाइंट आईडी के लिए OAuth सेटिंग की पुष्टि करें:
- Google API Consoleका क्रेडेंशियल पेज खोलें
पुष्टि करें कि आपकी वेबसाइट का यूआरआई, अनुमति वाले JavaScript ऑरिजिन में शामिल है. यूआरआई में सिर्फ़ स्कीम और पूरी तरह से सही होस्टनेम शामिल होता है. उदाहरण के लिए,
https://www.example.com
.इसके अलावा, क्रेडेंशियल को JavaScript कॉलबैक के बजाय, होस्ट किए गए एंडपॉइंट पर रीडायरेक्ट का इस्तेमाल करके दिखाया जा सकता है. अगर ऐसा है, तो पुष्टि करें कि आपके रीडायरेक्ट यूआरआई अनुमति वाले रीडायरेक्ट यूआरआई में शामिल किए गए हैं. रीडायरेक्ट यूआरआई में स्कीम, पूरी तरह से क्वालिफ़ाइड होस्टनेम, और पाथ शामिल होता है. साथ ही, यह रीडायरेक्ट यूआरआई की पुष्टि करने के नियमों का पालन करता है. उदाहरण के लिए,
https://www.example.com/auth-receiver
.
टेस्ट करना
सेटअप में दिए गए निर्देशों का पालन करने के बाद:
- Chrome की सभी मौजूदा गुप्त विंडो बंद करें और नई गुप्त विंडो खोलें. ऐसा करने पर, कैश मेमोरी में सेव किया गया कॉन्टेंट या कुकी मिट जाती हैं.
- उपयोगकर्ता के साइन-इन पेज को लोड करें और साइन-इन करने की कोशिश करें.
जानी-पहचानी समस्याओं की पहचान करने और उन्हें ठीक करने के लिए, इस गाइड के इन सेक्शन में दिए गए निर्देशों का पालन करें:
Console में, Google Sign-in लाइब्रेरी से जुड़ी कोई गड़बड़ी या चेतावनी देखें.
इस प्रोसेस को तब तक दोहराएं, जब तक कोई गड़बड़ी न हो और आप साइन-इन न कर पाएं. साइन इन होने की पुष्टि करने के लिए, यह पुष्टि करें कि
BasicProfile.getEmail()
आपका ईमेल पता दिखाता है और यह पुष्टि करता है किGoogleUser.isSignedIn()
True
है.
Google Sign-in लाइब्रेरी का अनुरोध ढूंढना
'Google साइन-इन' प्लैटफ़ॉर्म लाइब्रेरी के लिए अनुरोध की जांच करके देखें कि अनुमतियों की नीति और कॉन्टेंट की सुरक्षा नीति में बदलाव करना ज़रूरी है या नहीं. इसके लिए, लाइब्रेरी के नाम और ऑरिजिन का इस्तेमाल करके अनुरोध ढूंढें:
- Chrome में, DevTools का नेटवर्क पैनल खोलें और पेज को फिर से लोड करें.
- लाइब्रेरी के अनुरोध का पता लगाने के लिए, डोमेन और नाम कॉलम में मौजूद वैल्यू का इस्तेमाल करें:
- डोमेन
apis.google.com
है और - नाम
api.js
,client.js
याplatform.js
है. Name की खास वैल्यू, दस्तावेज़ के अनुरोध किए गए लाइब्रेरी बंडल पर निर्भर करती है.
- डोमेन
उदाहरण के लिए, डोमेन कॉलम में apis.google.com
और नाम कॉलम में platform.js
पर फ़िल्टर करें.
iframe की अनुमतियों की नीति देखें
आपकी साइट, क्रॉस-ऑरिजिन वाले iframe में Google साइन-इन प्लैटफ़ॉर्म लाइब्रेरी का इस्तेमाल कर सकती है. अगर ऐसा है, तो इसे अपडेट करना ज़रूरी है.
Google साइन इन लाइब्रेरी के अनुरोध का पता लगाएं के निर्देशों का पालन करने के बाद, DevTools के नेटवर्क पैनल में Google साइन इन लाइब्रेरी का अनुरोध चुनें. इसके बाद, हेडर टैब में अनुरोध हेडर सेक्शन में जाकर, Sec-Fetch-Site
हेडर ढूंढें. अगर हेडर की वैल्यू:
same-site
याsame-origin
पर सेट है, तो क्रॉस-ऑरिजिन नीतियां लागू नहीं होतीं और किसी भी तरह के बदलाव की ज़रूरत नहीं होती.- अगर iframe का इस्तेमाल किया जा रहा है, तो
cross-origin
में बदलाव करना ज़रूरी हो सकता है.
iframe मौजूद है या नहीं, इसकी पुष्टि करने के लिए:
- Chrome DevTools में एलिमेंट पैनल चुनें और
- दस्तावेज़ में कोई iframe ढूंढने के लिए, Ctrl-F का इस्तेमाल करें.
अगर कोई iframe मिलता है, तो दस्तावेज़ की जांच करें. इससे, gapi.auth2 फ़ंक्शन या script src
डायरेक्टिव को किए गए कॉल की जांच की जा सकती है. ये निर्देश, iframe में 'Google साइन इन' लाइब्रेरी को लोड करते हैं. अगर ऐसा है, तो:
- पैरंट iframe में,
allow="identity-credentials-get"
की अनुमतियों की नीति जोड़ें.
दस्तावेज़ में हर iframe के लिए यह प्रक्रिया दोहराएं. iframe को नेस्ट किया जा सकता है, इसलिए आस-पास के सभी पैरंट iframe में अनुमति देने का निर्देश जोड़ना न भूलें.
कॉन्टेंट की सुरक्षा के बारे में नीति देखना
अगर आपकी साइट पर कॉन्टेंट की सुरक्षा नीति का इस्तेमाल किया जाता है, तो Google साइन इन लाइब्रेरी का इस्तेमाल करने की अनुमति देने के लिए, आपको अपनी सीएसपी को अपडेट करना पड़ सकता है.
Google Sign-in लाइब्रेरी के अनुरोध का पता लगाएं के निर्देशों का पालन करने के बाद, DevTools के नेटवर्क पैनल में Google Sign-in लाइब्रेरी का अनुरोध चुनें. इसके बाद, हेडर टैब के रिस्पॉन्स हेडर सेक्शन में Content-Security-Policy
हेडर ढूंढें.
अगर हेडर नहीं मिलता है, तो कोई बदलाव करने की ज़रूरत नहीं है. अगर ऐसा नहीं है, तो देखें कि इनमें से कोई भी सीएसपी डायरेक्टिव, सीएसपी हेडर में दिया गया है या नहीं. अगर दिया गया है, तो उन्हें अपडेट करने के लिए:
किसी भी
connect-src
,default-src
याframe-src
निर्देश मेंhttps://apis.google.com/js/
,https://accounts.google.com/gsi/
, औरhttps://acounts.google.com/o/fedcm/
जोड़ना.script-src
के लिएhttps://apis.google.com/js/bundle-name.js
को जोड़ना. दस्तावेज़ के अनुरोधों को लाइब्रेरी बंडल के हिसाब से,bundle-name.js
कोapi.js
,client.js
याplatform.js
से बदलें.
उपयोगकर्ता के प्रॉम्प्ट में हुए बदलावों की जांच करना
उपयोगकर्ता के प्रॉम्प्ट व्यवहार में कुछ अंतर हैं. FedCM, ब्राउज़र से दिखाया जाने वाला मॉडल डायलॉग जोड़ता है और उपयोगकर्ता को चालू करने से जुड़ी ज़रूरी शर्तों को अपडेट करता है.
मोडल डायलॉग
अपनी साइट के लेआउट की जांच करके पुष्टि करें कि ब्राउज़र के मॉडल डायलॉग बॉक्स से, मौजूदा कॉन्टेंट को सुरक्षित तरीके से ओवरले किया जा सकता है और कुछ समय के लिए छिपाया जा सकता है. अगर ऐसा नहीं है, तो आपको अपनी वेबसाइट के कुछ एलिमेंट के लेआउट या पोज़िशन में बदलाव करना पड़ सकता है.
उपयोगकर्ता ऐक्टिवेशन
FedCM में, उपयोगकर्ता को चालू करने से जुड़ी अपडेट की गई ज़रूरी शर्तें शामिल हैं. बटन दबाना या लिंक पर क्लिक करना, उपयोगकर्ता के जेस्चर के उदाहरण हैं. इनसे तीसरे पक्ष के ऑरिजिन को नेटवर्क अनुरोध करने या डेटा स्टोर करने की अनुमति मिलती है. FedCM के साथ, ब्राउज़र उपयोगकर्ता की सहमति के लिए तब अनुरोध करता है, जब:
- जब कोई उपयोगकर्ता किसी नए ब्राउज़र इंस्टेंस का इस्तेमाल करके, पहली बार किसी वेब ऐप्लिकेशन में साइन-इन करता है या
GoogleAuth.signIn
को कॉल किया जाता है.
अगर उपयोगकर्ता ने पहले कभी आपकी वेबसाइट पर साइन इन किया है, तो gapi.auth2.init
का इस्तेमाल करके Google Sign-In लाइब्रेरी को शुरू करने पर, उपयोगकर्ता के इंटरैक्शन के बिना ही उसकी साइन इन की जानकारी हासिल की जा सकती है. ऐसा तब तक नहीं किया जा सकता, जब तक उपयोगकर्ता ने कम से कम एक बार FedCM साइन इन फ़्लो को पूरा न कर लिया हो.
FedCM में ऑप्ट इन करने और GoogleAuth.signIn
को कॉल करने से, अगली बार
वही उपयोगकर्ता आपकी वेबसाइट पर आने पर, gapi.auth2.init
उपयोगकर्ता के इंटरैक्शन के बिना शुरू करने के दौरान उपयोगकर्ता की साइन इन
जानकारी पा सकता है.
इस्तेमाल के सामान्य उदाहरण
Google Sign-In लाइब्रेरी के लिए डेवलपर दस्तावेज़ में, इस्तेमाल के सामान्य उदाहरणों के लिए गाइड और कोड के सैंपल शामिल होते हैं. इस सेक्शन में बताया गया है कि FedCM चैनल के काम करने के तरीके पर कैसे असर पड़ता है.
अपने वेब ऐप्लिकेशन में Google साइन इन को इंटिग्रेट करना
इस डेमो में,
<div>
एलिमेंट और क्लास बटन को रेंडर करते हैं. साथ ही, पहले से साइन इन किए हुए उपयोगकर्ताओं के लिए, पेजonload
इवेंट, उपयोगकर्ता क्रेडेंशियल दिखाता है. साइन इन करने और नया सेशन शुरू करने के लिए, उपयोगकर्ता इंटरैक्शन ज़रूरी है.लाइब्रेरी को शुरू करने की प्रोसेस,
g-signin2
क्लास के ज़रिए की जाती है. यह क्लास,gapi.load
औरgapi.auth2.init
को कॉल करती है.उपयोगकर्ता का कोई जेस्चर,
<div>
एलिमेंटonclick
इवेंट, साइन-इन के दौरानauth2.signIn
और साइन-आउट के दौरानauth2.signOut
को कॉल करता है.Google साइन इन का कस्टम बटन बनाना
पहले डेमो में, साइन इन बटन के दिखने के तरीके को कंट्रोल करने के लिए कस्टम एट्रिब्यूट का इस्तेमाल किया जाता है. साथ ही, पहले से साइन इन किए हुए उपयोगकर्ताओं के लिए, पेज
onload
इवेंट, उपयोगकर्ता के क्रेडेंशियल दिखाता है. साइन-इन करने और नया सेशन शुरू करने के लिए, उपयोगकर्ता के इंटरैक्शन की ज़रूरत होती है.लाइब्रेरी को शुरू करने की प्रोसेस,
platform.js
लाइब्रेरी के लिएonload
इवेंट के ज़रिए की जाती है. साथ ही, बटन कोgapi.signin2.render
दिखाया जाता है.उपयोगकर्ता के जेस्चर से, साइन इन बटन दबाने पर
auth2.signIn
को कॉल किया जाता है.दूसरे डेमो में, साइन-इन बटन के दिखने के तरीके को कंट्रोल करने के लिए,
<div>
एलिमेंट, सीएसएस स्टाइल, और कस्टम ग्राफ़िक का इस्तेमाल किया गया है. साइन-इन करने और नया सेशन शुरू करने के लिए, उपयोगकर्ता इंटरैक्शन ज़रूरी है.लाइब्रेरी को, दस्तावेज़ लोड होने पर स्टार्ट फ़ंक्शन का इस्तेमाल करके शुरू किया जाता है. यह फ़ंक्शन
gapi.load
,gapi.auth2.init
, औरgapi.auth2.attachClickHandler
को कॉल करता है.उपयोगकर्ता का कोई जेस्चर,
<div>
एलिमेंटonclick
इवेंट, साइन इन के दौरानauth2.attachClickHandler
का इस्तेमाल करकेauth2.signIn
को कॉल करता है या साइन आउट के दौरानauth2.signOut
को कॉल करता है.उपयोगकर्ता के सेशन की स्थिति पर नज़र रखना
इस डेमो में, उपयोगकर्ता के साइन इन और साइन आउट करने के लिए एक बटन दबाने का इस्तेमाल किया जाता है. साइन-इन करने और नया सेशन शुरू करने के लिए, उपयोगकर्ता का इंटरैक्शन ज़रूरी है.
लाइब्रेरी को शुरू करने के लिए,
script src
का इस्तेमाल करकेplatform.js
लोड करने के बाद, सीधेgapi.load
,gapi.auth2.init
, औरgapi.auth2.attachClickHandler()
को कॉल किया जाता है.उपयोगकर्ता का कोई जेस्चर,
<div>
एलिमेंटonclick
इवेंट, साइन इन के दौरानauth2.attachClickHandler
का इस्तेमाल करकेauth2.signIn
को कॉल करता है या साइन आउट के दौरानauth2.signOut
को कॉल करता है.अतिरिक्त अनुमतियों का अनुरोध करना
इस डेमो में, बटन दबाने का इस्तेमाल, OAuth 2.0 के अतिरिक्त स्कोप का अनुरोध करने और नया ऐक्सेस टोकन पाने के लिए किया जाता है. साथ ही, पहले से साइन इन किए हुए उपयोगकर्ताओं के लिए, पेज
onload
इवेंट, उपयोगकर्ता के क्रेडेंशियल दिखाता है. साइन इन करने और नया सेशन शुरू करने के लिए, उपयोगकर्ता के इंटरैक्शन की ज़रूरत होती है.लाइब्रेरी को शुरू करने की प्रोसेस,
platform.js
लाइब्रेरी के लिएonload
इवेंट के ज़रिए की जाती है. इसके लिए,gapi.signin2.render
को कॉल किया जाता है.<button>
एलिमेंट पर क्लिक करने से, उपयोगकर्ता के जेस्चर से साइन-आउट करने पर,googleUser.grant
याauth2.signOut
का इस्तेमाल करके, OAuth 2.0 के अतिरिक्त स्कोप के लिए अनुरोध ट्रिगर होता है.लिसनर का इस्तेमाल करके 'Google साइन-इन' को इंटिग्रेट करना
इस डेमो में, पहले से साइन इन किए हुए उपयोगकर्ताओं के लिए, पेज
onload
इवेंट, उपयोगकर्ता के क्रेडेंशियल दिखाता है. साइन-इन करने और नया सेशन शुरू करने के लिए, उपयोगकर्ता के इंटरैक्शन की ज़रूरत होती है.दस्तावेज़ लोड होने पर, लाइब्रेरी को शुरू करने की प्रोसेस शुरू की जाती है. इसके लिए, start फ़ंक्शन का इस्तेमाल किया जाता है, जो
gapi.load
,gapi.auth2.init
, औरgapi.auth2.attachClickHandler
को कॉल करता है. इसके बाद,auth2.isSignedIn.listen
औरauth2.currentUser.listen
का इस्तेमाल, सेशन की स्थिति में हुए बदलावों की सूचना सेट अप करने के लिए किया जाता है. आखिर में, साइन इन किए हुए उपयोगकर्ताओं के क्रेडेंशियल दिखाने के लिए,auth2.SignIn
को कॉल किया जाता है.उपयोगकर्ता का कोई जेस्चर,
<div>
एलिमेंटonclick
इवेंट, साइन इन के दौरानauth2.attachClickHandler
का इस्तेमाल करकेauth2.signIn
को कॉल करता है या साइन आउट के दौरानauth2.signOut
को कॉल करता है.सर्वर साइड ऐप्लिकेशन के लिए Google Sign-In
इस डेमो में, OAuth 2.0 ऑथराइज़ेशन कोड का अनुरोध करने के लिए उपयोगकर्ता के जेस्चर का इस्तेमाल किया गया है. साथ ही, पुष्टि के लिए बैकएंड सर्वर को जवाब भेजने के लिए, JS कॉलबैक एक AJAX कॉल करता है.
लाइब्रेरी को शुरू करने के लिए,
platform.js
लाइब्रेरी के लिएonload
इवेंट का इस्तेमाल किया जाता है. यह इवेंट,gapi.load
औरgapi.auth2.init
को कॉल करने के लिए स्टार्ट फ़ंक्शन का इस्तेमाल करता है.उपयोगकर्ता का जेस्चर,
<button>
एलिमेंट पर क्लिक करने सेauth2.grantOfflineAccess
को कॉल करके ऑथराइज़ेशन कोड के लिए अनुरोध ट्रिगर करता है.-
FedCM को हर ब्राउज़र इंस्टेंस के लिए सहमति की ज़रूरत होती है, भले ही Android उपयोगकर्ताओं ने पहले से साइन इन किया हो, एक बार सहमति देना ज़रूरी है.
ट्रांज़िशन की अवधि मैनेज करना
ट्रांज़िशन पीरियड के दौरान, उपयोगकर्ता के साइन इन का कुछ प्रतिशत हिस्सा FedCM का इस्तेमाल कर सकता है. हालांकि, सटीक प्रतिशत अलग-अलग हो सकता है और समय के साथ बदल सकता है. डिफ़ॉल्ट रूप से, Google यह कंट्रोल करता है कि कितने साइन इन अनुरोधों में FedCM का इस्तेमाल किया जाए. हालांकि, ट्रांज़िशन पीरियड के दौरान, आपके पास FedCM का इस्तेमाल करने के लिए ऑप्ट-इन या ऑप्ट-आउट करने का विकल्प होता है. ट्रांज़िशन की अवधि खत्म होने के बाद, FedCM का इस्तेमाल करना ज़रूरी हो जाता है. साथ ही, इसका इस्तेमाल सभी साइन-इन अनुरोधों के लिए किया जाता है.
ऑप्ट-इन करने पर, उपयोगकर्ता को FedCM साइन-इन फ़्लो पर भेजा जाता है. वहीं, ऑप्ट-आउट करने पर, उपयोगकर्ताओं को मौजूदा साइन-इन फ़्लो पर भेजा जाता है. इस व्यवहार को use_fedcm
पैरामीटर का इस्तेमाल करके कंट्रोल किया जाता है.
ऑप्ट-इन करें
यह कंट्रोल करना मददगार हो सकता है कि आपकी साइट पर साइन इन करने के सभी या कुछ प्रयासों के लिए, FedCM API का इस्तेमाल किया जाए या नहीं. ऐसा करने के लिए, प्लैटफ़ॉर्म लाइब्रेरी को शुरू करते समय, use_fedcm
को true
पर सेट करें. इस मामले में, उपयोगकर्ता के साइन इन करने के अनुरोध में FedCM API का इस्तेमाल किया जाता है.
ट्रांसकोड करने से ऑप्ट-आउट करना
ट्रांज़िशन की अवधि के दौरान, आपकी साइट पर साइन इन करने के लिए की गई उपयोगकर्ताओं की संख्या का कुछ प्रतिशत, डिफ़ॉल्ट रूप से FedCM API का इस्तेमाल करेगा. अगर आपको अपने ऐप्लिकेशन में बदलाव करने के लिए ज़्यादा समय चाहिए, तो कुछ समय के लिए FedCM API का इस्तेमाल करने से ऑप्ट-आउट किया जा सकता है. ऐसा करने के लिए, प्लैटफ़ॉर्म लाइब्रेरी को शुरू करते समय, use_fedcm
को false
पर सेट करें. इस मामले में, उपयोगकर्ता के साइन-इन अनुरोध में FedCM API का इस्तेमाल नहीं किया जाएगा.
ज़रूरी शर्तें पूरी करने के बाद, Google साइन इन प्लैटफ़ॉर्म लाइब्रेरी, use_fedcm
सेटिंग को अनदेखा कर देती है.
सहायता पाएं
google-signin टैग का इस्तेमाल करके, StackOverflow पर खोजें या सवाल पूछें.