Google Identity Services को FedCM API पर माइग्रेट किया जा रहा है. संभावित बदलावों की समीक्षा करने और आपकी वेबसाइट में उपयोगकर्ता के साइन-इन करने पर पड़ने वाले बुरे असर से बचने के लिए, माइग्रेशन गाइड में दिए गए निर्देशों का पालन करें.

इस पेज का अनुवाद Cloud Translation API से किया गया है.

'Google से साइन इन करें' JavaScript API का रेफ़रंस

इस रेफ़रंस पेज पर, Sign-In JavaScript API के बारे में बताया गया है. अपने वेब पेजों पर One Tap प्रॉम्प्ट या 'Google से साइन इन करें' बटन दिखाने के लिए, इस एपीआई का इस्तेमाल किया जा सकता है.

तरीका: google.accounts.id.initialize

google.accounts.id.initialize तरीका, कॉन्फ़िगरेशन ऑब्जेक्ट के आधार पर, 'Google से साइन इन करें' क्लाइंट को शुरू करता है. इस तरीके का कोड उदाहरण देखें:

google.accounts.id.initialize(IdConfiguration)

यहां दिए गए कोड के उदाहरण में, onload फ़ंक्शन के साथ google.accounts.id.initialize तरीका लागू किया गया है:

<script>
  window.onload = function () {
    google.accounts.id.initialize({
      client_id: 'YOUR_GOOGLE_CLIENT_ID',
      callback: handleCredentialResponse
    });
    google.accounts.id.prompt();
  };
</script>

google.accounts.id.initialize तरीका, 'Google से साइन इन करें' क्लाइंट इंस्टेंस बनाता है, जिसका इस्तेमाल एक ही वेब पेज के सभी मॉड्यूल में किया जा सकता है.

आपको google.accounts.id.initialize तरीके को सिर्फ़ एक बार कॉल करना होगा. भले ही, एक ही वेब पेज पर एक से ज़्यादा मॉड्यूल (जैसे, One Tap, मनमुताबिक बटन, रद्द करना वगैरह) का इस्तेमाल किया जा रहा हो.
अगर google.accounts.id.initialize तरीके को कई बार कॉल किया जाता है, तो सिर्फ़ आखिरी कॉल में किए गए कॉन्फ़िगरेशन को याद रखा जाता है और उनका इस्तेमाल किया जाता है.

google.accounts.id.initialize तरीके को कॉल करने पर, कॉन्फ़िगरेशन रीसेट हो जाते हैं. साथ ही, उसी वेब पेज पर मौजूद सभी बाद के तरीके, नए कॉन्फ़िगरेशन का तुरंत इस्तेमाल करते हैं.

डेटा टाइप: IdConfiguration

नीचे दी गई टेबल में, IdConfiguration डेटा टाइप के फ़ील्ड और उनके ब्यौरे दिए गए हैं:

फ़ील्ड
`client_id`	आपके ऐप्लिकेशन का क्लाइंट आईडी
`auto_select`	अपने-आप चुनने की सुविधा चालू करता है.
`callback`	आईडी टोकन को मैनेज करने वाला JavaScript फ़ंक्शन. Google One Tap और 'Google से साइन इन करें' बटन `popup` यूज़र एक्सपीरियंस (UX) मोड, इस एट्रिब्यूट का इस्तेमाल करता है.
`login_uri`	आपके लॉगिन एंडपॉइंट का यूआरएल. 'Google से साइन इन करें' बटन `redirect` का UX मोड इस एट्रिब्यूट का इस्तेमाल करता है.
`native_callback`	JavaScript फ़ंक्शन, जो पासवर्ड क्रेडेंशियल को मैनेज करता है.
`cancel_on_tap_outside`	अगर उपयोगकर्ता प्रॉम्प्ट के बाहर क्लिक करता है, तो प्रॉम्प्ट रद्द हो जाता है.
`prompt_parent_id`	One Tap प्रॉम्प्ट कंटेनर एलिमेंट का डीओएम आईडी
`nonce`	आईडी टोकन के लिए रैंडम स्ट्रिंग
`context`	One Tap प्रॉम्प्ट में मौजूद टाइटल और शब्द
`state_cookie_domain`	अगर आपको पैरंट डोमेन और उसके सबडोमेन में One Tap को कॉल करना है, तो पैरंट डोमेन को इस फ़ील्ड में पास करें, ताकि एक ही शेयर की गई कुकी का इस्तेमाल किया जा सके.
`ux_mode`	'Google से साइन इन करें' बटन का यूज़र एक्सपीरियंस (UX) फ़्लो
`allowed_parent_origin`	वे ऑरिजिन जिन्हें इंटरमीडियरी iframe को एम्बेड करने की अनुमति है. अगर यह फ़ील्ड मौजूद है, तो One Tap इंटरमीडियरी iframe मोड में चलाया जाता है.
`intermediate_iframe_close_callback`	जब उपयोगकर्ता मैन्युअल तरीके से One Tap को बंद करते हैं, तो यह इंटरमीडिएट iframe के डिफ़ॉल्ट व्यवहार को बदल देता है.
`itp_support`	ITP ब्राउज़र पर, One Tap के बेहतर यूज़र एक्सपीरियंस की सुविधा चालू करता है.
`login_hint`	उपयोगकर्ता संकेत देकर, खाता चुनना छोड़ें.
`hd`	डोमेन के हिसाब से खाता चुनने की सुविधा सीमित करें.
`use_fedcm_for_prompt`	ब्राउज़र को उपयोगकर्ता के साइन इन प्रॉम्प्ट को कंट्रोल करने की अनुमति दें. साथ ही, अपनी वेबसाइट और Google के बीच साइन इन फ़्लो को मध्यस्थता करने की अनुमति दें.
`enable_redirect_uri_validation`	रीडायरेक्ट यूआरआई की पुष्टि के नियमों का पालन करने वाले बटन रीडायरेक्ट फ़्लो को चालू करें.

client_id

यह फ़ील्ड आपके ऐप्लिकेशन का क्लाइंट आईडी है, जिसे Google Cloud कंसोल में ढूंढा और बनाया जाता है. ज़्यादा जानकारी के लिए, यहां दी गई टेबल देखें:

टाइप	ज़रूरी है	उदाहरण
स्ट्रिंग	हां	`client_id: "CLIENT_ID.apps.googleusercontent.com"`

auto_select

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

टाइप	ज़रूरी है	उदाहरण
बूलियन	वैकल्पिक	`auto_select: true`

कॉलबैक

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

टाइप	ज़रूरी है	उदाहरण
फ़ंक्शन	One Tap और `popup` UX मोड के लिए ज़रूरी है	`callback: handleResponse`

login_uri

यह एट्रिब्यूट, आपके लॉगिन एंडपॉइंट का यूआरआई होता है.

यह वैल्यू, OAuth 2.0 क्लाइंट के लिए अनुमति वाले किसी एक रीडायरेक्ट यूआरआई से पूरी तरह मेल खानी चाहिए. इस क्लाइंट को आपने Google Cloud Console में कॉन्फ़िगर किया है. साथ ही, यह वैल्यू रीडायरेक्ट यूआरआई की पुष्टि करने के हमारे नियमों के मुताबिक होनी चाहिए.

अगर मौजूदा पेज आपका लॉगिन पेज है, तो इस एट्रिब्यूट को छोड़ा जा सकता है. ऐसे में, क्रेडेंशियल डिफ़ॉल्ट रूप से इस पेज पर पोस्ट हो जाते हैं.

जब कोई उपयोगकर्ता 'Google से साइन इन करें' बटन पर क्लिक करता है और रीडायरेक्ट यूज़र इंटरफ़ेस (यूआई) मोड का इस्तेमाल किया जाता है, तो आईडी टोकन क्रेडेंशियल का रिस्पॉन्स आपके लॉगिन एंडपॉइंट पर पोस्ट किया जाता है.

ज़्यादा जानकारी के लिए, नीचे दी गई टेबल देखें:

टाइप	वैकल्पिक	उदाहरण
URL	डिफ़ॉल्ट रूप से, यह मौजूदा पेज के यूआरआई या आपकी बताई गई वैल्यू पर सेट होता है. इसका इस्तेमाल सिर्फ़ तब किया जाता है, जब `ux_mode: "redirect"` सेट हो.	`login_uri: "https://www.example.com/login"`

आपके लॉगिन एंडपॉइंट को ऐसे पोस्ट अनुरोधों को मैनेज करना चाहिए जिनमें मुख्य हिस्से में credential कुंजी और आईडी टोकन की वैल्यू हो.

आपके लॉगिन एंडपॉइंट के लिए अनुरोध का एक उदाहरण यहां दिया गया है:

POST /login HTTP/1.1
Host: www.example.com
Content-Type: application/x-www-form-urlencoded

credential=ID_TOKEN

पर जवाब अपने-आप सबमिट करना है, तो एचटीएमएल एपीआई आज़माएं.

native_callback

यह फ़ील्ड उस JavaScript फ़ंक्शन का नाम है जो ब्राउज़र के नेटिव क्रेडेंशियल मैनेजर से लौटाए गए पासवर्ड क्रेडेंशियल को हैंडल करता है. ज़्यादा जानकारी के लिए, यहां दी गई टेबल देखें:

टाइप	ज़रूरी है	उदाहरण
फ़ंक्शन	वैकल्पिक	`native_callback: handleResponse`

cancel_on_tap_outside

इस फ़ील्ड से यह तय होता है कि अगर कोई उपयोगकर्ता प्रॉम्प्ट के बाहर क्लिक करता है, तो एक-टैप अनुरोध रद्द किया जाए या नहीं. डिफ़ॉल्ट वैल्यू true है. वैल्यू को false पर सेट करके, इसे बंद किया जा सकता है. ज़्यादा जानकारी के लिए, यहां दी गई टेबल देखें:

टाइप	ज़रूरी है	उदाहरण
बूलियन	वैकल्पिक	`cancel_on_tap_outside: false`

prompt_parent_id

यह एट्रिब्यूट, कंटेनर एलिमेंट का डीओएम आईडी सेट करता है. अगर यह सेट नहीं है, तो विंडो के सबसे ऊपर दाएं कोने में, 'एक टैप' प्रॉम्प्ट दिखेगा. ज़्यादा जानकारी के लिए, यहां दी गई टेबल देखें:

टाइप	ज़रूरी है	उदाहरण
स्ट्रिंग	वैकल्पिक	`prompt_parent_id: 'parent_id'`

नॉन्स

यह फ़ील्ड एक रैंडम स्ट्रिंग है. इसका इस्तेमाल आईडी टोकन, रीप्ले अटैक को रोकने के लिए करता है. ज़्यादा जानकारी के लिए, नीचे दी गई टेबल देखें:

टाइप	ज़रूरी है	उदाहरण
स्ट्रिंग	वैकल्पिक	`nonce: "biaqbm70g23"`

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

कॉन्टेक्स्ट

यह फ़ील्ड, 'एक टैप' प्रॉम्प्ट में टाइटल और मैसेज का टेक्स्ट बदलता है. ज़्यादा जानकारी के लिए, यहां दी गई टेबल देखें:

टाइप	ज़रूरी है	उदाहरण
स्ट्रिंग	वैकल्पिक	`context: "use"`

इस टेबल में, सभी कॉन्टेक्स्ट और उनसे जुड़ी जानकारी दी गई है:

संदर्भ
`signin`	"Google से साइन इन करें"
`signup`	"Google से साइन अप करें"
`use`	"Google के साथ इस्तेमाल करें"

state_cookie_domain

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

टाइप	ज़रूरी है	उदाहरण
स्ट्रिंग	वैकल्पिक	`state_cookie_domain: "example.com"`

ux_mode

इस फ़ील्ड का इस्तेमाल, 'Google से साइन इन करें' बटन के लिए इस्तेमाल होने वाले UX फ़्लो को सेट करने के लिए करें. डिफ़ॉल्ट वैल्यू popup है. इस एट्रिब्यूट का, OneTap यूज़र एक्सपीरियंस पर कोई असर नहीं पड़ता. ज़्यादा जानकारी के लिए, यहां दी गई टेबल देखें:

टाइप	ज़रूरी है	उदाहरण
स्ट्रिंग	वैकल्पिक	`ux_mode: "redirect"`

यहां दी गई टेबल में, यूज़र एक्सपीरियंस (यूएक्स) के उपलब्ध मोड और उनके ब्यौरे दिए गए हैं.

यूएक्स मोड
`popup`	पॉप-अप विंडो में साइन-इन यूज़र एक्सपीरियंस (यूएक्स) फ़्लो को पूरा करता है.
`redirect`	पूरे पेज को रीडायरेक्ट करके, साइन इन यूज़र एक्सपीरियंस फ़्लो को पूरा करता है.

allowed_parent_origin

वे ऑरिजिन जिन्हें इंटरमीडियरी iframe को एम्बेड करने की अनुमति है. अगर यह फ़ील्ड मौजूद है, तो One Tap बीच में आने वाले iframe मोड में चलता है. ज़्यादा जानकारी के लिए, यहां दी गई टेबल देखें:

टाइप	ज़रूरी है	उदाहरण
स्ट्रिंग या स्ट्रिंग ऐरे	वैकल्पिक	`allowed_parent_origin: "https://example.com"`

यहां दी गई टेबल में, इस्तेमाल की जा सकने वाली वैल्यू टाइप और उनके ब्यौरे दिए गए हैं.

वैल्यू टाइप
`string`	सिंगल डोमेन यूआरआई.	`"https://example.com"`
`string array`	डोमेन यूआरआई का कलेक्शन.	`["https://news.example.com", "https://local.example.com"]`

वाइल्डकार्ड प्रीफ़िक्स भी काम करते हैं. उदाहरण के लिए, "https://*.example.com" सभी लेवल पर example.com और उसके सबडोमेन से मैच करता है.जैसे, news.example.com, login.news.example.com. वाइल्डकार्ड का इस्तेमाल करते समय इन बातों का ध्यान रखें:

पैटर्न स्ट्रिंग में सिर्फ़ वाइल्डकार्ड और टॉप लेवल डोमेन शामिल नहीं किए जा सकते. उदाहरण के लिए, https://.com और https://.co.uk अमान्य हैं. जैसा कि ऊपर बताया गया है, "https://.example.com" example.com और उसके सबडोमेन से मेल खाता है. दो अलग-अलग डोमेन दिखाने के लिए, कलेक्शन का इस्तेमाल भी किया जा सकता है. उदाहरण के लिए, ["https://example1.com", "https://.example2.com"], example1.com, example2.com, और example2.com के सबडोमेन वाले डोमेन से मैच करता है
वाइल्डकार्ड डोमेन, सुरक्षित https:// स्कीम से शुरू होने चाहिए. इसलिए, "*.example.com" को अमान्य माना जाता है.

अगर allowed_parent_origin फ़ील्ड की वैल्यू अमान्य है, तो इंटरमीडिएट iframe मोड का One Tap शुरू नहीं हो पाएगा और रुक जाएगा.

intermediate_iframe_close_callback

जब उपयोगकर्ता One Tap के यूज़र इंटरफ़ेस (यूआई) में 'X' बटन पर टैप करके, One Tap को मैन्युअल तरीके से बंद करते हैं, तो यह इंटरमीडिएट iframe के डिफ़ॉल्ट व्यवहार को बदल देता है. डिफ़ॉल्ट रूप से, इंटरमीडिएट iframe को तुरंत DOM से हटा दिया जाता है.

intermediate_iframe_close_callback फ़ील्ड सिर्फ़ इंटरमीडिएट इंटरफ़्रेम मोड में लागू होता है. साथ ही, इसका असर सिर्फ़ One Tap iframe के बजाय, इंटरमीडिएट iframe पर पड़ता है. कॉलबैक शुरू होने से पहले, One Tap का यूज़र इंटरफ़ेस हटा दिया जाता है.

टाइप	ज़रूरी है	उदाहरण
फ़ंक्शन	वैकल्पिक	`intermediate_iframe_close_callback: logBeforeClose`

itp_support

इस फ़ील्ड से यह तय होता है कि इंटेलिजेंट ट्रैकिंग प्रिवेंशन (आईटीपी) की सुविधा वाले ब्राउज़र पर, एक टैप वाले अपग्रेड किए गए यूज़र इंटरफ़ेस (यूएक्स) को चालू किया जाना चाहिए या नहीं. डिफ़ॉल्ट वैल्यू false है. ज़्यादा जानकारी के लिए, यहां दी गई टेबल देखें:

टाइप	ज़रूरी है	उदाहरण
बूलियन	वैकल्पिक	`itp_support: true`

login_hint

अगर आपके ऐप्लिकेशन को पहले से पता है कि किस उपयोगकर्ता को साइन इन करना है, तो वह Google को लॉगिन करने का संकेत दे सकता है. खाता चुनने की प्रोसेस पूरी होने पर, खाता चुनने का विकल्प स्किप कर दिया जाता है. स्वीकार की जाने वाली वैल्यू: ईमेल पता या आईडी टोकन sub फ़ील्ड की वैल्यू.

ज़्यादा जानकारी के लिए, Open Connect दस्तावेज़ में login_hint फ़ील्ड देखें.

टाइप	ज़रूरी है	उदाहरण
स्ट्रिंग, ईमेल पता या आईडी टोकन `sub` फ़ील्ड की वैल्यू.	वैकल्पिक	`login_hint: 'elisa.beckett@gmail.com'`

hd

जब किसी उपयोगकर्ता के पास एक से ज़्यादा खाते हों और उसे सिर्फ़ अपने Workspace खाते से साइन-इन करना हो, तो Google को डोमेन नेम का हिंट देने के लिए इसका इस्तेमाल करें. खाता चुनने के दौरान दिखाए गए उपयोगकर्ता खाते, दिए गए डोमेन तक सीमित होते हैं. वाइल्डकार्ड वैल्यू: *, उपयोगकर्ता को सिर्फ़ Workspace खाते दिखाता है. साथ ही, खाता चुनने के दौरान, उपभोक्ता खातों (user@gmail.com) को बाहर रखता है.

ज़्यादा जानकारी के लिए, OpenID Connect के दस्तावेज़ में hd फ़ील्ड देखें.

टाइप	ज़रूरी है	उदाहरण
स्ट्रिंग. पूरी तरह क्वालिफ़ाइड डोमेन नेम या *.	वैकल्पिक	`hd: '*'`

use_fedcm_for_prompt

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

टाइप	ज़रूरी है	उदाहरण
बूलियन	वैकल्पिक	`use_fedcm_for_prompt: true`

enable_redirect_uri_validation

रीडायरेक्ट यूआरआई की पुष्टि करने के नियमों का पालन करने वाला बटन रीडायरेक्ट फ़्लो चालू करें.

टाइप	ज़रूरी है	उदाहरण
बूलियन	वैकल्पिक	`enable_redirect_uri_validation: true`

तरीका: google.accounts.id.prompt

initialize() तरीका शुरू होने के बाद, google.accounts.id.prompt तरीका One Tap प्रॉम्प्ट या ब्राउज़र नेटिव क्रेडेंशियल मैनेजर दिखाता है. इस तरीके का कोड उदाहरण यहां देखें:

 google.accounts.id.prompt(/**
 @type{(function(!PromptMomentNotification):void)=} */ momentListener)

आम तौर पर, prompt() तरीके को पेज लोड होने पर कॉल किया जाता है. Google की ओर से सेशन की स्थिति और उपयोगकर्ता सेटिंग की वजह से, हो सकता है कि One Tap प्रॉम्प्ट का यूज़र इंटरफ़ेस (यूआई) न दिखे. अलग-अलग पलों के लिए यूज़र इंटरफ़ेस (यूआई) की स्थिति की सूचना पाने के लिए, यूज़र इंटरफ़ेस (यूआई) स्थिति की सूचनाएं पाने वाला फ़ंक्शन पास करें.

सूचनाएं इन स्थितियों में भेजी जाती हैं:

डिसप्ले मोमेंट: ऐसा prompt() तरीका कॉल करने के बाद होता है. सूचना में एक बूलियन वैल्यू होती है, जिससे यह पता चलता है कि यूज़र इंटरफ़ेस दिख रहा है या नहीं.
छोटा हुआ पल: ऐसा तब होता है, जब One Tap प्रॉम्प्ट अपने-आप रद्द हो जाता है, मैन्युअल तरीके से रद्द कर दिया जाता है या Google किसी क्रेडेंशियल को जारी नहीं कर पाता. जैसे, चुने गए सेशन से Google से साइन आउट कर दिया गया हो.

ऐसे मामलों में, हमारा सुझाव है कि आप पहचान की पुष्टि करने वाली किसी दूसरी सेवा का इस्तेमाल करें.
खारिज किया गया पल: ऐसा तब होता है, जब Google किसी क्रेडेंशियल को ऐक्सेस कर लेता है या उपयोगकर्ता क्रेडेंशियल ऐक्सेस करने के फ़्लो को रोकना चाहता है. उदाहरण के लिए, जब उपयोगकर्ता आपके लॉगिन डायलॉग में अपना उपयोगकर्ता नाम और पासवर्ड डालना शुरू करता है, तो google.accounts.id.cancel() तरीके का इस्तेमाल करके, One Tap प्रॉम्प्ट को बंद किया जा सकता है और खारिज किए गए पल को ट्रिगर किया जा सकता है.

चेतावनी: खाते को हटाने के बाद, पहचान की पुष्टि करने वाली किसी भी दूसरी सेवा का इस्तेमाल न करें.

यहां दिए गए कोड के उदाहरण में, स्किप किए गए हिस्से को लागू किया गया है:

<script>
  window.onload = function () {
    google.accounts.id.initialize(...);
    google.accounts.id.prompt((notification) => {
      if (notification.isNotDisplayed() || notification.isSkippedMoment()) {
        // continue with another identity provider.
      }
    });
  };
</script>

डेटा टाइप: PromptMomentNotification

यहां दी गई टेबल में, PromptMomentNotification डेटा टाइप के तरीकों और ब्यौरे की सूची दी गई है:

तरीका
`isDisplayMoment()`	क्या यह सूचना किसी डिसप्ले मोमेंट के लिए है? ध्यान दें: FedCM के चालू होने पर, यह सूचना नहीं मिलती है. ज़्यादा जानकारी के लिए, FedCM पर माइग्रेट करना पेज देखें.
`isDisplayed()`	क्या यह सूचना किसी डिसप्ले मोमेंट के लिए है और यूज़र इंटरफ़ेस (यूआई) दिखाया गया है? ध्यान दें: जब FedCM चालू होता है, तो यह सूचना नहीं भेजी जाती. ज़्यादा जानकारी के लिए, FedCM पर माइग्रेट करना पेज देखें.
`isNotDisplayed()`	क्या यह सूचना किसी डिसप्ले मोमेंट के लिए है और यूज़र इंटरफ़ेस (यूआई) नहीं दिख रहा है? ध्यान दें: FedCM के चालू होने पर, यह सूचना नहीं मिलती है. ज़्यादा जानकारी के लिए, FedCM पर माइग्रेट करना पेज देखें.
`getNotDisplayedReason()`	यूज़र इंटरफ़ेस (यूआई) न दिखने की पूरी वजह. इस एट्रिब्यूट की ये वैल्यू हो सकती हैं: `browser_not_supported` `invalid_client` `missing_client_id` `opt_out_or_no_session` `secure_http_required` `suppressed_by_user` `unregistered_origin` `unknown_reason` ध्यान दें: अगर FedCM की सुविधा चालू है, तो यह तरीका काम नहीं करता. ज़्यादा जानकारी के लिए, FedCM पर माइग्रेट करना पेज देखें.
`isSkippedMoment()`	क्या यह सूचना, स्किप किए गए पल के बारे में है?
`getSkippedReason()`	स्किप किए गए हिस्से की पूरी वजह. इस तरह की वैल्यू हो सकती हैं: `auto_cancel` `user_cancel` `tap_outside` `issuing_failed` ध्यान दें: अगर FedCM की सुविधा चालू है, तो यह तरीका काम नहीं करता. ज़्यादा जानकारी के लिए, FedCM पर माइग्रेट करें पेज देखें.
`isDismissedMoment()`	क्या यह सूचना किसी खारिज किए गए पल के लिए है?
`getDismissedReason()`	खारिज करने की पूरी वजह. ये वैल्यू हो सकती हैं: `credential_returned` `cancel_called` `flow_restarted`
`getMomentType()`	मोमेंट के टाइप के लिए स्ट्रिंग दिखाएं. इस तरह की वैल्यू हो सकती हैं: `display` `skipped` `dismissed`

डेटा टाइप: CredentialResponse

जब आपका callback फ़ंक्शन शुरू किया जाता है, तो पैरामीटर के तौर पर एक CredentialResponse ऑब्जेक्ट पास किया जाता है. नीचे दी गई टेबल में, क्रेडेंशियल रिस्पॉन्स ऑब्जेक्ट में मौजूद फ़ील्ड की सूची दी गई है:

फ़ील्ड
`credential`	यह फ़ील्ड, आईडी टोकन दिखाता है.
`select_by`	इस फ़ील्ड से यह तय होता है कि क्रेडेंशियल कैसे चुना जाए.
`state`	यह फ़ील्ड सिर्फ़ तब तय किया जाता है, जब उपयोगकर्ता साइन इन करने के लिए, 'Google से साइन इन करें' बटन पर क्लिक करता है और बटन का `state` एट्रिब्यूट तय किया जाता है.

क्रेडेंशियल

यह फ़ील्ड, base64-एन्कोड किए गए JSON वेब टोकन (JWT) स्ट्रिंग के तौर पर आईडी टोकन है.

डिकोड किए जाने पर, JWT नीचे दिए गए उदाहरण की तरह दिखता है:

header
{
  "alg": "RS256",
  "kid": "f05415b13acb9590f70df862765c655f5a7a019e", // JWT signature
  "typ": "JWT"
}
payload
{
  "iss": "https://accounts.google.com", // The JWT's issuer
  "nbf":  161803398874,
  "aud": "314159265-pi.apps.googleusercontent.com", // Your server's client ID
  "sub": "3141592653589793238", // The unique ID of the user's Google Account
  "hd": "gmail.com", // If present, the host domain of the user's GSuite email address
  "email": "elisa.g.beckett@gmail.com", // The user's email address
  "email_verified": true, // true, if Google has verified the email address
  "azp": "314159265-pi.apps.googleusercontent.com",
  "name": "Elisa Beckett",
                            // If present, a URL to user's profile picture
  "picture": "https://lh3.googleusercontent.com/a-/e2718281828459045235360uler",
  "given_name": "Elisa",
  "family_name": "Beckett",
  "iat": 1596474000, // Unix timestamp of the assertion's creation time
  "exp": 1596477600, // Unix timestamp of the assertion's expiration time
  "jti": "abc161803398874def"
}

sub फ़ील्ड, Google खाते के लिए दुनिया भर में यूनीक आइडेंटिफ़ायर होता है. उपयोगकर्ता के आइडेंटिफ़ायर के तौर पर, sub फ़ील्ड का इस्तेमाल सिर्फ़ करें. ऐसा इसलिए, क्योंकि यह सभी Google खातों में यूनीक होता है और इसका दोबारा इस्तेमाल नहीं किया जाता. ईमेल पते को आइडेंटिफ़ायर के तौर पर इस्तेमाल न करें, क्योंकि किसी Google खाते में समय-समय पर एक से ज़्यादा ईमेल पते हो सकते हैं.

email, email_verified, और hd फ़ील्ड का इस्तेमाल करके, यह तय किया जा सकता है कि Google किसी ईमेल पते को Google होस्ट करता है और वह आधिकारिक है या नहीं. जिन मामलों में Google के पास आधिकारिक अधिकार होता है, उनमें उपयोगकर्ता के खाते के मालिक होने की पुष्टि की जाती है.

ऐसे मामले जिनमें Google आधिकारिक है:

email के पास @gmail.com सफ़िक्स है. यह Gmail खाता है.
email_verified सही है और hd सेट है, तो यह Google Workspace खाता है.

उपयोगकर्ता, Gmail या Google Workspace का इस्तेमाल किए बिना भी Google खातों के लिए रजिस्टर कर सकते हैं. जब email में @gmail.com सफ़िक्स नहीं होता और hd मौजूद नहीं होता, तो Google के पास पुष्टि करने का अधिकार नहीं होता. साथ ही, उपयोगकर्ता की पुष्टि करने के लिए, पासवर्ड या चैलेंज के अन्य तरीकों का सुझाव दिया जाता है. email_verfied भी सही हो सकता है, क्योंकि Google खाता बनाते समय ही Google ने शुरुआत में उपयोगकर्ता की पुष्टि की थी. हालांकि, हो सकता है कि तीसरे पक्ष के ईमेल खाते का मालिकाना हक बदल गया हो.

exp फ़ील्ड की मदद से, अपने सर्वर साइड पर टोकन की पुष्टि की जा सकने वाली समयसीमा खत्म हो जाती है. 'Google से साइन इन करें' सुविधा से मिले आईडी टोकन के लिए, यह अवधि एक घंटे की होती है. समयसीमा खत्म होने से पहले, आपको टोकन की पुष्टि करनी होगी. सेशन मैनेजमेंट के लिए exp का इस्तेमाल न करें. जिस आईडी टोकन की समयसीमा खत्म हो चुकी है उसका मतलब यह नहीं है कि उपयोगकर्ता ने साइन आउट कर दिया है. आपका ऐप्लिकेशन, आपके उपयोगकर्ताओं के सेशन मैनेजमेंट के लिए ज़िम्मेदार है.

select_by

नीचे दी गई टेबल में, select_by फ़ील्ड की संभावित वैल्यू दी गई हैं. वैल्यू सेट करने के लिए, सेशन और सहमति की स्थिति के साथ इस्तेमाल किए गए बटन के टाइप का इस्तेमाल किया जाता है,

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

इस फ़ील्ड की वैल्यू इनमें से किसी एक टाइप पर सेट होती है,

मान	ब्यौरा
`auto`	मौजूदा सेशन में ऐसे उपयोगकर्ता का अपने-आप साइन-इन होना जिसने पहले क्रेडेंशियल शेयर करने की सहमति दी थी. यह सिर्फ़ उन ब्राउज़र पर लागू होता है जिन पर FedCM काम नहीं करता.
`user`	मौजूदा सेशन में पहले ही सहमति दे चुके उपयोगकर्ता ने क्रेडेंशियल शेयर करने के लिए, एक टैप में 'इस रूप में जारी रखें' बटन दबाया. यह सिर्फ़ उन ब्राउज़र पर लागू होता है जिन पर FedCM काम नहीं करता.
`fedcm`	उपयोगकर्ता ने FedCM का इस्तेमाल करके क्रेडेंशियल शेयर करने के लिए, One Tap 'इसी तौर पर जारी रखें' बटन दबाया. यह सिर्फ़ उन ब्राउज़र पर लागू होता है जिन पर FedCM काम करता है.
`fedcm_auto`	किसी मौजूदा सेशन वाले उपयोगकर्ता का अपने-आप साइन इन होना. ऐसा तब होता है, जब उसने पहले ही FedCM One Tap का इस्तेमाल करके क्रेडेंशियल शेयर करने की सहमति दी हो. यह सिर्फ़ उन ब्राउज़र पर लागू होता है जिन पर FedCM काम करता है.
`user_1tap`	किसी मौजूदा सेशन वाले उपयोगकर्ता ने सहमति देने और क्रेडेंशियल शेयर करने के लिए, One Tap 'इसी तौर पर जारी रखें' बटन को दबाया. यह सिर्फ़ Chrome के 75 और उसके बाद के वर्शन पर लागू होता है.
`user_2tap`	किसी मौजूदा सेशन के बिना, उपयोगकर्ता ने खाता चुनने के लिए, One Tap 'इसी खाते से जारी रखें' बटन दबाया. इसके बाद, सहमति देने और क्रेडेंशियल शेयर करने के लिए, पॉप-अप विंडो में पुष्टि करें बटन दबाया. यह उन ब्राउज़र पर लागू होता है जो Chromium पर आधारित नहीं हैं.
`itp`	ऐसा उपयोगकर्ता जिसके पास मौजूदा सेशन है और जिसने पहले सहमति दी थी और ITP ब्राउज़र पर, एक टैप की सुविधा का इस्तेमाल किया था.
`itp_confirm`	किसी मौजूदा सेशन वाले उपयोगकर्ता ने ITP ब्राउज़र पर, एक टैप की सुविधा का इस्तेमाल किया. साथ ही, सहमति देने और क्रेडेंशियल शेयर करने के लिए, 'पुष्टि करें' बटन दबाया.
`itp_add_session`	कोई ऐसा उपयोगकर्ता जिसके पास कोई मौजूदा सेशन नहीं है और जिसने पहले सहमति दी है, वह Google खाता चुनने और क्रेडेंशियल शेयर करने के लिए, ITP ब्राउज़र पर One Tap दबाता है.
`itp_confirm_add_session`	किसी मौजूदा सेशन के बिना, उपयोगकर्ता ने सबसे पहले ITP ब्राउज़र पर, एक टैप की सुविधा का इस्तेमाल करके Google खाता चुना. इसके बाद, सहमति देने और क्रेडेंशियल शेयर करने के लिए, पुष्टि करें बटन दबाया.
`btn`	किसी मौजूदा सेशन में मौजूद उपयोगकर्ता ने पहले सहमति दी हो और उसने क्रेडेंशियल शेयर करने के लिए, 'कोई खाता चुनें' से कोई Google खाता चुना हो. इसके बाद, उसने 'Google से साइन इन करें' बटन दबाया हो.
`btn_confirm`	किसी मौजूदा सेशन में मौजूद उपयोगकर्ता ने सहमति देने और क्रेडेंशियल शेयर करने के लिए, Google से साइन इन करें बटन पर क्लिक किया. इसके बाद, उसने पुष्टि करने के लिए 'पुष्टि करें' बटन पर क्लिक किया.
`btn_add_session`	किसी ऐसे उपयोगकर्ता ने 'Google से साइन इन करें' बटन दबाया जिसने पहले सहमति दी थी, लेकिन जिसका कोई मौजूदा सेशन नहीं था. ऐसा करने पर, उसने Google खाता चुना और क्रेडेंशियल शेयर किए.
`btn_confirm_add_session`	किसी मौजूदा सेशन के बिना, उपयोगकर्ता ने Google खाता चुनने के लिए, सबसे पहले 'Google से साइन इन करें' बटन पर दबाया. इसके बाद, सहमति देने और क्रेडेंशियल शेयर करने के लिए, 'पुष्टि करें' बटन पर दबाया.

राज्य

यह फ़ील्ड सिर्फ़ तब तय किया जाता है, जब उपयोगकर्ता साइन इन करने के लिए, 'Google से साइन इन करें' बटन पर क्लिक करता है. साथ ही, क्लिक किए गए बटन state एट्रिब्यूट के बारे में बताया जाता है. इस फ़ील्ड की वैल्यू, बटन के state एट्रिब्यूट में बताई गई वैल्यू होती है.

एक ही पेज पर, 'Google से साइन इन करें' के कई बटन रेंडर किए जा सकते हैं. इसलिए, हर बटन को एक यूनीक स्ट्रिंग असाइन की जा सकती है. इसलिए, इस state फ़ील्ड का इस्तेमाल करके यह पता लगाया जा सकता है कि उपयोगकर्ता ने साइन इन करने के लिए किस बटन पर क्लिक किया.

तरीका: google.accounts.id.renderButton

google.accounts.id.renderButton तरीका, आपके वेब पेजों पर 'Google से साइन इन करें' बटन रेंडर करता है.

इस तरीके का कोड उदाहरण यहां देखें:

google.accounts.id.renderButton(
      /** @type{!HTMLElement} */ parent,
      /** @type{!GsiButtonConfiguration} */ options
    )

डेटा टाइप: GsiButtonConfiguration

इस टेबल में, GsiButtonConfiguration के डेटा टाइप के फ़ील्ड और जानकारी दी गई है:

एट्रिब्यूट
`type`	बटन का टाइप: आइकॉन या स्टैंडर्ड बटन.
`theme`	बटन की थीम. उदाहरण के लिए, filled_blue या filled_black.
`size`	बटन का साइज़. उदाहरण के लिए, छोटा या बड़ा.
`text`	बटन का टेक्स्ट. उदाहरण के लिए, "Google से साइन इन करें" या "Google से साइन अप करें".
`shape`	बटन का आकार. उदाहरण के लिए, आयताकार या सर्कुलर.
`logo_alignment`	Google के लोगो का अलाइनमेंट: बाईं ओर या बीच में.
`width`	बटन की चौड़ाई, पिक्सल में.
`locale`	अगर यह नीति सेट है, तो बटन की भाषा रेंडर की जाती है.
`click_listener`	अगर यह फ़ंक्शन सेट है, तो 'Google से साइन इन करें' बटन पर क्लिक करने पर यह फ़ंक्शन कॉल किया जाता है.
`state`	सेट होने पर, यह स्ट्रिंग आईडी टोकन के साथ दिखती है.

एट्रिब्यूट के टाइप

नीचे दिए गए सेक्शन में, हर एट्रिब्यूट के टाइप और उदाहरण के बारे में जानकारी दी गई है.

टाइप

बटन किस तरह का है. डिफ़ॉल्ट वैल्यू standard है.

ज़्यादा जानकारी के लिए, नीचे दी गई टेबल देखें:

टाइप	ज़रूरी है	उदाहरण
स्ट्रिंग	हां	`type: "icon"`

यहां दी गई टेबल में, अलग-अलग तरह के बटन और उनसे जुड़ी जानकारी दी गई है:

टाइप
`standard`	टेक्स्ट या उपयोगकर्ता के हिसाब से बनाई गई जानकारी वाला बटन.
`icon`	बिना टेक्स्ट वाला आइकॉन बटन.

थीम

बटन की थीम. डिफ़ॉल्ट वैल्यू outline है. ज़्यादा जानकारी के लिए, नीचे दी गई टेबल देखें:

टाइप	ज़रूरी है	उदाहरण
स्ट्रिंग	वैकल्पिक	`theme: "filled_blue"`

यहां दी गई टेबल में, उपलब्ध थीम और उनके ब्यौरे दिए गए हैं:

थीम
`outline`	स्टैंडर्ड बटन थीम.
`filled_blue`	नीले रंग से भरी बटन थीम.
`filled_black`	काले रंग से भरी बटन थीम.

साइज़

बटन का साइज़. डिफ़ॉल्ट वैल्यू large है. ज़्यादा जानकारी के लिए, नीचे दी गई टेबल देखें:

टाइप	ज़रूरी है	उदाहरण
स्ट्रिंग	वैकल्पिक	`size: "small"`

यहां दी गई टेबल में, बटन के उपलब्ध साइज़ और उनके बारे में जानकारी दी गई है:

साइज़
`large`	एक बड़ा बटन.
`medium`	मीडियम साइज़ का बटन.
`small`	एक छोटा बटन.

टेक्स्ट

बटन का टेक्स्ट. डिफ़ॉल्ट वैल्यू signin_with है. अलग-अलग text एट्रिब्यूट वाले आइकॉन बटन के टेक्स्ट में कोई विज़ुअल अंतर नहीं होता. हालांकि, स्क्रीन पर टेक्स्ट को पढ़ने की सुविधा के लिए ऐसा नहीं किया जाता.

ज़्यादा जानकारी के लिए, नीचे दी गई टेबल देखें:

टाइप	ज़रूरी है	उदाहरण
स्ट्रिंग	वैकल्पिक	`text: "signup_with"`

इस टेबल में सभी बटन टेक्स्ट और उनके ब्यौरे दिए गए हैं:

टेक्स्ट
`signin_with`	बटन का टेक्स्ट "Google से साइन इन करें" है.
`signup_with`	बटन का टेक्स्ट "Google से साइन अप करें" है.
`continue_with`	बटन का टेक्स्ट "Google के साथ जारी रखें" है.
`signin`	बटन का टेक्स्ट "साइन इन करें" है.

आकार

बटन का आकार. डिफ़ॉल्ट वैल्यू rectangular है. ज़्यादा जानकारी के लिए, यहां दी गई टेबल देखें:

टाइप	ज़रूरी है	उदाहरण
स्ट्रिंग	वैकल्पिक	`shape: "rectangular"`

यहां दी गई टेबल में, बटन के उपलब्ध आकार और उनके बारे में जानकारी दी गई है:

आकार
`rectangular`	रेक्टैंगल आकार का बटन. अगर इसका इस्तेमाल `icon` बटन टाइप के लिए किया जाता है, तो यह `square` जैसा ही होगा.
`pill`	पिल के आकार वाला बटन. अगर `icon` बटन टाइप के लिए इस्तेमाल किया जाता है, तो यह `circle` जैसा ही होता है.
`circle`	सर्कल के आकार वाला बटन. अगर `standard` button type के लिए इस्तेमाल किया जाता है, तो यह `pill` जैसा ही होता है.
`square`	स्क्वेयर आकार का बटन. अगर `standard` button type के लिए इस्तेमाल किया जाता है, तो यह `rectangular` जैसा ही होता है.

logo_alignment

Google के लोगो का अलाइनमेंट. डिफ़ॉल्ट वैल्यू left है. यह एट्रिब्यूट सिर्फ़ standard बटन टाइप पर लागू होता है. ज़्यादा जानकारी के लिए, यहां दी गई टेबल देखें:

टाइप	ज़रूरी है	उदाहरण
स्ट्रिंग	वैकल्पिक	`logo_alignment: "center"`

यहां दी गई टेबल में, उपलब्ध अलाइनमेंट और उनके ब्यौरे दिए गए हैं:

logo_alignment
`left`	Google लोगो को बाईं ओर अलाइन करता है.
`center`	Google लोगो को बीच में अलाइन करता है.

चौड़ाई

पिक्सल में, बटन की कम से कम चौड़ाई. इमेज की चौड़ाई ज़्यादा से ज़्यादा 400 पिक्सल होनी चाहिए.

ज़्यादा जानकारी के लिए, नीचे दी गई टेबल देखें:

टाइप	ज़रूरी है	उदाहरण
स्ट्रिंग	वैकल्पिक	`width: "400"`

locale

ज़रूरी नहीं. चुनी गई स्थान-भाषा का इस्तेमाल करके, बटन का टेक्स्ट दिखाएं. ऐसा न करने पर, डिफ़ॉल्ट रूप से उपयोगकर्ता के Google खाते या ब्राउज़र की सेटिंग का इस्तेमाल किया जा सकता है. लाइब्रेरी लोड करते समय, src डायरेक्टिव में hl पैरामीटर और भाषा कोड जोड़ें. उदाहरण के लिए: gsi/client?hl=<iso-639-code>.

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

ज़्यादा जानकारी के लिए, नीचे दी गई टेबल देखें:

टाइप	ज़रूरी है	उदाहरण
स्ट्रिंग	वैकल्पिक	`locale: "zh_CN"`

click_listener

click_listener एट्रिब्यूट का इस्तेमाल करके, 'Google से साइन इन करें' बटन पर क्लिक किए जाने पर, JavaScript फ़ंक्शन तय किया जा सकता है.

  google.accounts.id.renderButton(document.getElementById("signinDiv"), {
      theme: 'outline',
      size: 'large',
      click_listener: onClickHandler
    });

  
  function onClickHandler(){
    console.log("Sign in with Google button clicked...")
  }

इस उदाहरण में, जब 'Google से साइन इन करें' बटन पर क्लिक किया जाता है, तो कंसोल में 'Google से साइन इन करें' बटन पर क्लिक किया गया... मैसेज लॉग होता है.

राज्य

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

ज़्यादा जानकारी के लिए, नीचे दी गई टेबल देखें:

टाइप	ज़रूरी है	उदाहरण
स्ट्रिंग	वैकल्पिक	`data-state: "button 1"`

डेटा टाइप: क्रेडेंशियल

जब आपका native_callback फ़ंक्शन शुरू किया जाता है, तो पैरामीटर के तौर पर Credential ऑब्जेक्ट पास किया जाता है. इस टेबल में, ऑब्जेक्ट में मौजूद फ़ील्ड की सूची दी गई है:

फ़ील्ड
`id`	उपयोगकर्ता की पहचान करता है.
`password`	पासवर्ड

तरीका: google.accounts.id.disableAutoSelect

जब वह व्यक्ति आपकी वेबसाइट से साइन आउट हो जाता है, तब आपको कुकी में स्थिति रिकॉर्ड करने के लिए, google.accounts.id.disableAutoSelect तरीके को कॉल करना होगा. इससे यूज़र एक्सपीरियंस में रुकावट नहीं आती. इस तरीके का कोड स्निपेट यहां देखें:

google.accounts.id.disableAutoSelect()

यहां दिए गए कोड के उदाहरण में, onSignout() फ़ंक्शन के साथ google.accounts.id.disableAutoSelect तरीका लागू किया गया है:

<script>
  function onSignout() {
    google.accounts.id.disableAutoSelect();
  }
</script>

तरीका: google.accounts.id.storeCredential

यह तरीका, ब्राउज़र के नेटिव क्रेडेंशियल मैनेजर एपीआई के store() तरीके के लिए एक रैपर है. इसलिए, इसका इस्तेमाल सिर्फ़ पासवर्ड क्रेडेंशियल को सेव करने के लिए किया जा सकता है. इस तरीके का कोड उदाहरण यहां देखें:

google.accounts.id.storeCredential(Credential, callback)

यहां दिए गए कोड के उदाहरण में, onSignIn() फ़ंक्शन के साथ google.accounts.id.storeCredential तरीका लागू किया गया है:

<script>
  function onSignIn() {
    let cred = {id: '...', password: '...'};
    google.accounts.id.storeCredential(cred);
  }
</script>

तरीका: google.accounts.id.cancel

अगर आपने भरोसेमंद पक्ष के डीओएम से प्रॉम्प्ट हटा दिया है, तो One Tap फ़्लो को रद्द किया जा सकता है. अगर कोई क्रेडेंशियल पहले से चुना गया है, तो रद्द करने की कार्रवाई को अनदेखा कर दिया जाता है. इस तरीके का कोड उदाहरण देखें:

google.accounts.id.cancel()

यहां दिए गए कोड के उदाहरण में, onNextButtonClicked() फ़ंक्शन के साथ google.accounts.id.cancel() तरीका लागू किया गया है:

<script>
  function onNextButtonClicked() {
    google.accounts.id.cancel();
    showPasswordPage();
  }
</script>

लाइब्रेरी लोड होने पर कॉलबैक: onGoogleLibraryLoad

आपके पास onGoogleLibraryLoad कॉलबैक रजिस्टर करने का विकल्प है. 'Google से साइन इन करें' JavaScript लाइब्रेरी लोड होने के बाद, इसकी सूचना दी जाती है:

window.onGoogleLibraryLoad = () => {
    ...
};

यह कॉलबैक, window.onload कॉलबैक का सिर्फ़ एक शॉर्टकट है. दर्शकों के व्यवहार में कोई अंतर नहीं है.

यहां दिए गए कोड के उदाहरण में, onGoogleLibraryLoad कॉलबैक लागू किया गया है:

<script>
  window.onGoogleLibraryLoad = () => {
   google.accounts.id.initialize({
     ...
   });
   google.accounts.id.prompt();
  };
</script>

तरीका: google.accounts.id.Revoke

google.accounts.id.revoke का तरीका, बताए गए उपयोगकर्ता के लिए आईडी टोकन को शेयर करने के लिए इस्तेमाल की गई OAuth की अनुमति को रद्द कर देता है. इस तरीके का यह कोड स्निपेट देखें: javascript google.accounts.id.revoke(login_hint, callback)

पैरामीटर	टाइप	ब्यौरा
`login_hint`	स्ट्रिंग	उपयोगकर्ता के Google खाते का ईमेल पता या यूनीक आईडी. आईडी, क्रेडेंशियल पेलोड की `sub` प्रॉपर्टी है.
`callback`	फ़ंक्शन	RevocationResponse हैंडलर, जो ज़रूरी नहीं है.

नीचे दिया गया कोड सैंपल दिखाता है कि किसी आईडी के साथ revoke तरीके का इस्तेमाल कैसे किया जाता है.

  google.accounts.id.revoke('1618033988749895', done => {
    console.log(done.error);
  });

डेटा टाइप: RevocationResponse

जब आपका callback फ़ंक्शन शुरू किया जाता है, तो पैरामीटर के तौर पर एक RevocationResponse ऑब्जेक्ट पास किया जाता है. नीचे दी गई टेबल में, रद्द करने के अनुरोध के जवाब वाले ऑब्जेक्ट में मौजूद फ़ील्ड की सूची दी गई है:

फ़ील्ड
`successful`	यह फ़ील्ड, मेथड कॉल की रिटर्न वैल्यू है.
`error`	इस फ़ील्ड में, गड़बड़ी के बारे में ज़्यादा जानकारी देने वाला मैसेज शामिल किया जा सकता है. हालांकि, ऐसा करना ज़रूरी नहीं है.

हो गया

यह फ़ील्ड एक बूलियन वैल्यू है. अगर रद्द करने के तरीके का कॉल पूरा हो जाता है, तो यह वैल्यू 'सही' पर सेट होती है. अगर कॉल पूरा नहीं हो पाता है, तो यह वैल्यू 'गलत' पर सेट होती है.

गड़बड़ी

यह फ़ील्ड एक स्ट्रिंग वैल्यू है. अगर रद्द करने का तरीका कॉल नहीं हो पाता है, तो इसमें गड़बड़ी का ज़्यादा जानकारी वाला मैसेज होता है. अगर रद्द करने का तरीका कॉल हो जाता है, तो यह वैल्यू तय नहीं होती.