चेतावनी: इस डेटा के तहत प्रदान की जाती है गूगल उपयोगकर्ता डेटा नीति । कृपया नीति की समीक्षा करें और उसका अनुपालन करें। ऐसा करने में विफलता के परिणामस्वरूप परियोजना या खाता निलंबन हो सकता है।

Google HTML API संदर्भ के साथ साइन इन करें

यह संदर्भ पृष्ठ Google HTML डेटा विशेषता API के साथ साइन इन का वर्णन करता है। आप अपने वेब पेजों पर वन टैप प्रॉम्प्ट या साइन इन विथ गूगल बटन प्रदर्शित करने के लिए एपीआई का उपयोग कर सकते हैं।

"g_id_onload" आईडी वाला तत्व

आप इस तरह के रूप में किसी भी दृश्य या अदृश्य तत्व है, Google में डेटा विशेषताओं साइन इन रख सकते हैं <div> और <span> । केवल आवश्यकता है कि तत्व आईडी के लिए सेट है g_id_onload । इस आईडी को कई तत्वों पर न लगाएं।

डेटा विशेषताएँ

निम्न तालिका डेटा विशेषताओं को उनके विवरण के साथ सूचीबद्ध करती है:

गुण
data-client_id आपके आवेदन की क्लाइंट आईडी
data-auto_prompt Google One टैप प्रदर्शित करें।
data-auto_select Google One Tap पर स्वचालित चयन सक्षम करता है।
data-login_uri आपके लॉगिन समापन बिंदु का URL
data-callback जावास्क्रिप्ट आईडी टोकन हैंडलर फ़ंक्शन का नाम
data-native_login_uri आपके पासवर्ड क्रेडेंशियल हैंडलर एंडपॉइंट का URL
data-native_callback जावास्क्रिप्ट पासवर्ड क्रेडेंशियल हैंडलर फ़ंक्शन का नाम
data-native_id_param के लिए पैरामीटर नाम credential.id मूल्य
data-native_password_param के लिए पैरामीटर नाम credential.password मूल्य
data-cancel_on_tap_outside नियंत्रित करता है कि यदि उपयोगकर्ता प्रॉम्प्ट के बाहर क्लिक करता है तो प्रॉम्प्ट को रद्द करना है या नहीं।
data-prompt_parent_id वन टैप प्रॉम्प्ट कंटेनर एलिमेंट की DOM ID
data-skip_prompt_cookie यदि निर्दिष्ट कुकी में एक गैर-रिक्त मान है, तो एक टैप को छोड़ देता है।
data-nonce आईडी टोकन के लिए एक यादृच्छिक स्ट्रिंग
data-context वन टैप प्रॉम्प्ट में शीर्षक और शब्द
data-moment_callback शीघ्र UI स्थिति सूचना श्रोता का कार्य नाम
data-state_cookie_domain यदि आपको मूल डोमेन और उसके उप डोमेन में वन टैप कॉल करने की आवश्यकता है, तो इस विशेषता को मूल डोमेन पास करें ताकि एक साझा कुकी का उपयोग किया जा सके।
data-ux_mode Google के साथ साइन इन करें बटन UX प्रवाह
data-allowed_parent_origin वे मूल जिन्हें मध्यवर्ती iframe एम्बेड करने की अनुमति है। यदि यह विशेषता प्रस्तुत करती है तो एक टैप मध्यवर्ती iframe मोड में चलेगा।
data-intermediate_iframe_close_callback जब उपयोगकर्ता मैन्युअल रूप से वन टैप को बंद करते हैं, तो डिफ़ॉल्ट मध्यवर्ती iframe व्यवहार को ओवरराइड करता है।

विशेषता प्रकार

निम्नलिखित अनुभागों में प्रत्येक विशेषता के प्रकार और एक उदाहरण के बारे में विवरण हैं।

डेटा-क्लाइंट_आईडी

यह विशेषता आपके ऐप की क्लाइंट आईडी है, जो Google Developers Console में पाई और बनाई जाती है। अधिक जानकारी के लिए निम्न तालिका देखें:

प्रकार आवश्यक उदाहरण
डोरी हां data-client_id="CLIENT_ID.apps.googleusercontent.com"

डेटा-ऑटो_प्रॉम्प्ट

यह विशेषता निर्धारित करती है कि एक टैप प्रदर्शित करना है या नहीं। डिफ़ॉल्ट मान है true । जब यह मान है गूगल एक टैप प्रदर्शित नहीं किया जाएगा false । अधिक जानकारी के लिए निम्न तालिका देखें:

प्रकार आवश्यक उदाहरण
बूलियन ऐच्छिक data-auto_prompt="true"

डेटा-ऑटो_सेलेक्ट

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

प्रकार आवश्यक उदाहरण
बूलियन ऐच्छिक data-auto_select="true"

डेटा-लॉगिन_यूरी

यह विशेषता आपके लॉगिन एंडपॉइंट का यूआरआई है। यदि वर्तमान पृष्ठ आपका लॉगिन पृष्ठ है, तो छोड़ा जा सकता है, इस स्थिति में क्रेडेंशियल डिफ़ॉल्ट रूप से इस पृष्ठ पर पोस्ट किया जाता है।

जब कोई कॉलबैक फ़ंक्शन परिभाषित नहीं होता है और उपयोगकर्ता साइन इन Google या वन टैप बटन पर क्लिक करता है, या स्वचालित साइन होता है, तो आईडी टोकन क्रेडेंशियल प्रतिक्रिया आपके लॉगिन एंडपॉइंट पर पोस्ट की जाती है।

अधिक जानकारी के लिए निम्न तालिका देखें:

प्रकार ऐच्छिक उदाहरण
यूआरएल वर्तमान पृष्ठ के यूआरआई या आपके द्वारा निर्दिष्ट मान के लिए डिफ़ॉल्ट।
जब ध्यान नहीं दिया गया data-ux_mode="popup" और data-callback निर्धारित है।
data-login_uri="https://www.example.com/login"

आपका लॉगिन endpoint एक युक्त पोस्ट अनुरोध संभाल चाहिए credential मुख्य भाग में एक आईडी टोकन मूल्य के साथ कुंजी।

आपके लॉगिन समापन बिंदु के लिए एक उदाहरण अनुरोध निम्नलिखित है:

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

credential=ID_TOKEN

डेटा-कॉलबैक

यह विशेषता जावास्क्रिप्ट फ़ंक्शन का नाम है जो लौटाए गए आईडी टोकन को संभालती है। अधिक जानकारी के लिए निम्न तालिका देखें:

प्रकार आवश्यक उदाहरण
डोरी किए जाने पर आवश्यक data-login_uri सेट नहीं है। data-callback="handleToken"

में से एक data-login_uri और data-callback विशेषताओं में इस्तेमाल किया जा सकता है। यह निम्नलिखित घटक और UX मोड कॉन्फ़िगरेशन पर निर्भर करता है:

  • data-login_uri विशेषता के साथ गूगल साइन इन बटन के लिए आवश्यक है redirect UX मोड है, जो ध्यान नहीं देता है data-callback विशेषता।

  • इन दो विशेषताओं में से एक Google एक टैप करके Google साइन-इन बटन के लिए सेट किया जाना चाहिए popup UX मोड। यदि दोनों सेट कर रहे हैं, data-callback विशेषता एक उच्च पूर्वता है।

नाम स्थान के भीतर JavaScript फ़ंक्शन HTML API द्वारा समर्थित नहीं हैं। इसके बजाय, नामस्थान के बिना वैश्विक जावास्क्रिप्ट फ़ंक्शन का उपयोग करें। उदाहरण के लिए, का उपयोग mylibCallback के बजाय mylib.callback

data-native_login_uri

यह विशेषता आपके पासवर्ड क्रेडेंशियल हैंडलर एंडपॉइंट का URL है। आप या तो सेट करते हैं data-native_login_uri विशेषता या data-native_callback विशेषता, JavaScript लाइब्रेरी वापस देशी क्रेडेंशियल प्रबंधक पर गिर जाता है जब वहाँ एक Google सत्र नहीं है। आप दोनों सेट करने की अनुमति नहीं कर रहे हैं data-native_callback और data-native_login_uri विशेषताओं। अधिक जानकारी के लिए निम्न तालिका देखें:

प्रकार आवश्यक उदाहरण
डोरी ऐच्छिक data-login_uri="https://www.example.com/password_login"

डेटा-देशी_कॉलबैक

यह विशेषता जावास्क्रिप्ट फ़ंक्शन का नाम है जो ब्राउज़र के मूल क्रेडेंशियल मैनेजर से लौटाए गए पासवर्ड क्रेडेंशियल को संभालता है। आप या तो सेट करते हैं data-native_login_uri विशेषता या data-native_callback विशेषता, JavaScript लाइब्रेरी वापस देशी क्रेडेंशियल प्रबंधक पर गिर जाता है जब वहाँ एक Google सत्र नहीं है। आप दोनों सेट करने की अनुमति नहीं कर रहे हैं data-native_callback और data-native_login_uri । अधिक जानकारी के लिए निम्न तालिका देखें:

प्रकार आवश्यक उदाहरण
डोरी ऐच्छिक data-native_callback="handlePasswordCredential"

नाम स्थान के भीतर JavaScript फ़ंक्शन HTML API द्वारा समर्थित नहीं हैं। इसके बजाय, नामस्थान के बिना वैश्विक जावास्क्रिप्ट फ़ंक्शन का उपयोग करें। उदाहरण के लिए, का उपयोग mylibCallback के बजाय mylib.callback

data-native_id_param

जब आप पासवर्ड क्रेडेंशियल हैंडलर समाप्ति बिंदु को पासवर्ड क्रेडेंशियल सबमिट करते हैं, आप के लिए पैरामीटर नाम निर्दिष्ट कर सकते हैं credential.id क्षेत्र। डिफ़ॉल्ट नाम है email । अधिक जानकारी के लिए निम्न तालिका देखें:

प्रकार आवश्यक उदाहरण
यूआरएल ऐच्छिक data-native_id_param="user_id"

डेटा-देशी_पासवर्ड_परम

जब आप पासवर्ड क्रेडेंशियल हैंडलर समाप्ति बिंदु को पासवर्ड क्रेडेंशियल सबमिट करते हैं, आप के लिए पैरामीटर नाम निर्दिष्ट कर सकते हैं credential.password मूल्य। डिफ़ॉल्ट नाम है password । अधिक जानकारी के लिए निम्न तालिका देखें:

प्रकार आवश्यक उदाहरण
यूआरएल ऐच्छिक data-native_password_param="pwd"

डेटा-रद्द_ऑन_टैप_बाहर

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

प्रकार आवश्यक उदाहरण
बूलियन ऐच्छिक data-cancel_on_tap_outside="false"

डेटा-प्रॉम्प्ट_पेरेंट_आईडी

यह विशेषता कंटेनर तत्व की DOM ID सेट करती है। यदि यह सेट नहीं है, तो विंडो के ऊपरी-दाएँ कोने में वन टैप प्रॉम्प्ट प्रदर्शित होता है। अधिक जानकारी के लिए निम्न तालिका देखें:

प्रकार आवश्यक उदाहरण
डोरी ऐच्छिक data-prompt_parent_id="parent_id"

यदि निर्दिष्ट कुकी में एक गैर-रिक्त मान है, तो यह विशेषता वन टैप को छोड़ देती है। अधिक जानकारी के लिए निम्न तालिका देखें:

प्रकार आवश्यक उदाहरण
डोरी ऐच्छिक data-skip_prompt_cookie="SID"

डेटा-गैर

यह विशेषता एक यादृच्छिक स्ट्रिंग है जिसका उपयोग आईडी टोकन द्वारा रीप्ले हमलों को रोकने के लिए किया जाता है। अधिक जानकारी के लिए निम्न तालिका देखें:

प्रकार आवश्यक उदाहरण
डोरी ऐच्छिक data-nonce="biaqbm70g23"

गैर-लंबाई आपके पर्यावरण द्वारा समर्थित अधिकतम JWT आकार और अलग-अलग ब्राउज़र और सर्वर HTTP आकार की बाधाओं तक सीमित है।

डेटा-संदर्भ

यह विशेषता वन टैप प्रॉम्प्ट में दिखाए गए शीर्षक और संदेशों के टेक्स्ट को बदल देती है। अधिक जानकारी के लिए निम्न तालिका देखें:

प्रकार आवश्यक उदाहरण
डोरी ऐच्छिक data-context="use"

निम्न तालिका उपलब्ध संदर्भों और उनके विवरणों को सूचीबद्ध करती है:

संदर्भ
signin "Google के साथ साइन इन करें"
signup "Google के साथ साइन अप करें"
use "Google के साथ प्रयोग करें"

डेटा-पल_कॉलबैक

यह विशेषता प्रॉम्प्ट UI स्थिति सूचना श्रोता का फ़ंक्शन नाम है। अधिक जानकारी के लिए डेटा प्रकार का उल्लेख PromptMomentNotification । अधिक जानकारी के लिए निम्न तालिका देखें:

प्रकार आवश्यक उदाहरण
डोरी ऐच्छिक data-moment_callback="logMomentNotification"

नाम स्थान के भीतर JavaScript फ़ंक्शन HTML API द्वारा समर्थित नहीं हैं। इसके बजाय, नामस्थान के बिना वैश्विक जावास्क्रिप्ट फ़ंक्शन का उपयोग करें। उदाहरण के लिए, का उपयोग mylibCallback के बजाय mylib.callback

यदि आपको पैरेंट डोमेन और उसके उप डोमेन में वन टैप प्रदर्शित करने की आवश्यकता है, तो पैरेंट डोमेन को इस विशेषता को पास करें ताकि एकल साझा-राज्य कुकी का उपयोग किया जा सके। अधिक जानकारी के लिए निम्न तालिका देखें:

प्रकार आवश्यक उदाहरण
डोरी ऐच्छिक data-state_cookie_domain="example.com"

डेटा-ux_mode

यह विशेषता Google के साथ साइन इन करें बटन द्वारा उपयोग किए जाने वाले UX प्रवाह को सेट करती है। डिफ़ॉल्ट मान है popup । इस विशेषता का वन टैप यूएक्स पर कोई प्रभाव नहीं पड़ता है। अधिक जानकारी के लिए निम्न तालिका देखें:

प्रकार आवश्यक उदाहरण
डोरी ऐच्छिक data-ux_mode="redirect"

निम्न तालिका उपलब्ध UX मोड और उनके विवरण को सूचीबद्ध करती है।

यूएक्स मोड
popup पॉप-अप विंडो में साइन-इन UX फ़्लो करता है।
redirect पूर्ण पृष्ठ पुनर्निर्देशन द्वारा साइन-इन UX प्रवाह निष्पादित करता है।

data-allowed_parent_origin

वे मूल जिन्हें मध्यवर्ती iframe एम्बेड करने की अनुमति है। यदि यह विशेषता प्रस्तुत करती है तो एक टैप मध्यवर्ती iframe मोड में चलेगा। अधिक जानकारी के लिए निम्न तालिका देखें:

प्रकार आवश्यक उदाहरण
स्ट्रिंग या स्ट्रिंग सरणी ऐच्छिक data-allowed_parent_origin="https://example.com"

निम्न तालिका समर्थित मान प्रकारों और उनके विवरणों को सूचीबद्ध करती है।

मूल्य प्रकार
string एक एकल डोमेन यूआरआई। "https://example.com"
string array अल्पविराम से अलग किए गए डोमेन URI की सूची। "https://news.example.com,https://local.example.com"

यदि का मान data-allowed_parent_origin विशेषता अमान्य है, मध्यवर्ती आइफ्रेम मोड के प्रारंभ एक नल असफल और बंद होगा।

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

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

डेटा-मध्यवर्ती_iframe_close_callback

जब उपयोगकर्ता मैन्युअल रूप से वन टैप UI में 'X' बटन पर टैप करके वन टैप को बंद करते हैं, तो डिफ़ॉल्ट मध्यवर्ती iframe व्यवहार को ओवरराइड करता है। डिफ़ॉल्ट व्यवहार मध्यवर्ती iframe को DOM से तुरंत हटा देना है।

data-intermediate_iframe_close_callback क्षेत्र केवल मध्यवर्ती आइफ्रेम मोड में प्रभावी होता है। और इसका प्रभाव केवल एक टैप आईफ्रेम के बजाय मध्यवर्ती आईफ्रेम पर पड़ता है। कॉलबैक लागू होने से पहले वन टैप UI हटा दिया जाता है।

प्रकार आवश्यक उदाहरण
समारोह ऐच्छिक data-intermediate_iframe_close_callback='logBeforeClose'

नाम स्थान के भीतर JavaScript फ़ंक्शन HTML API द्वारा समर्थित नहीं हैं। इसके बजाय, नामस्थान के बिना वैश्विक जावास्क्रिप्ट फ़ंक्शन का उपयोग करें। उदाहरण के लिए, का उपयोग mylibCallback के बजाय mylib.callback

"g_id_signin" वर्ग वाला तत्व

जोड़ते हैं g_id_signin एक तत्व के लिए class विशेषता, तत्व के रूप में गूगल के साथ बटन में साइन इन बना देता है।

आप एक ही पृष्ठ पर एकाधिक साइन इन Google बटन प्रस्तुत कर सकते हैं। प्रत्येक बटन की अपनी दृश्य सेटिंग्स हो सकती हैं। सेटिंग्स को निम्न डेटा विशेषताओं द्वारा परिभाषित किया गया है।

दृश्य डेटा विशेषताएँ

निम्न तालिका दृश्य डेटा विशेषताओं और उनके विवरणों को सूचीबद्ध करती है:

गुण
data-type बटन प्रकार: चिह्न, या मानक बटन।
data-theme बटन थीम। उदाहरण के लिए, भरा_नीला या भरा_काला।
data-size बटन का आकार। उदाहरण के लिए, छोटा या बड़ा।
data-text बटन पाठ। उदाहरण के लिए, "Google से साइन इन करें" या "Google के साथ साइन अप करें"।
data-shape बटन का आकार। उदाहरण के लिए, आयताकार या गोलाकार।
data-logo_alignment Google लोगो संरेखण: बाएँ या मध्य।
data-width बटन की चौड़ाई, पिक्सेल में।
data-locale बटन टेक्स्ट इस विशेषता में सेट की गई भाषा में रेंडर करता है।

विशेषता प्रकार

निम्नलिखित अनुभागों में प्रत्येक विशेषता के प्रकार और एक उदाहरण के बारे में विवरण हैं।

डाटा प्रकार

बटन प्रकार। डिफ़ॉल्ट मान है standard । अधिक जानकारी के लिए निम्न तालिका देखें:

प्रकार आवश्यक उदाहरण
डोरी हां data-type="icon"

निम्न तालिका उपलब्ध बटन प्रकारों और उनके विवरणों को सूचीबद्ध करती है:

प्रकार
standard टेक्स्ट या वैयक्तिकृत जानकारी वाला एक बटन:
icon टेक्स्ट के बिना एक आइकन बटन:

डेटा-विषय

बटन थीम। डिफ़ॉल्ट मान है outline । अधिक जानकारी के लिए निम्न तालिका देखें:

प्रकार आवश्यक उदाहरण
डोरी ऐच्छिक data-theme="filled_blue"

निम्न तालिका उपलब्ध विषयों और उनके विवरणों को सूचीबद्ध करती है:

विषय
outline मानक बटन विषय:
सफ़ेद बैकग्राउंड वाला एक मानक बटनसफेद पृष्ठभूमि वाला एक आइकन बटनसफेद पृष्ठभूमि वाला एक व्यक्तिगत बटन
filled_blue ब्लू-भरा बटन थीम:
नीले रंग की पृष्ठभूमि वाला एक मानक बटननीले रंग की पृष्ठभूमि वाला एक आइकन बटननीले रंग की पृष्ठभूमि वाला एक व्यक्तिगत बटन
filled_black ब्लैक-भरा बटन थीम:
काली पृष्ठभूमि वाला एक मानक बटनकाली पृष्ठभूमि वाला आइकन बटनकाली पृष्ठभूमि वाला एक व्यक्तिगत बटन

डेटा-आकार

बटन का आकार। डिफ़ॉल्ट मान है large । अधिक जानकारी के लिए निम्न तालिका देखें:

प्रकार आवश्यक उदाहरण
डोरी ऐच्छिक data-size="small"

निम्न तालिका उपलब्ध बटन आकारों और उनके विवरणों को सूचीबद्ध करती है।

आकार
large एक बड़ा बटन:
एक बड़ा मानक बटनएक बड़ा आइकन बटनएक बड़ा, वैयक्तिकृत बटन
medium एक मध्यम आकार का बटन:
एक मध्यम मानक बटनएक मध्यम आइकन बटन
small एक छोटा बटन:
एक छोटा बटनएक छोटा आइकन बटन

डेटा-पाठ

बटन पाठ। डिफ़ॉल्ट मान है signin_with । वहाँ अलग अलग है कि आइकन बटन के पाठ के लिए कोई दृश्य मतभेद हैं data-text विशेषताओं। एकमात्र अपवाद तब होता है जब स्क्रीन एक्सेसिबिलिटी के लिए टेक्स्ट पढ़ा जाता है।

अधिक जानकारी के लिए निम्न तालिका देखें:

प्रकार आवश्यक उदाहरण
डोरी ऐच्छिक data-text="signup_with"

निम्न तालिका में उपलब्ध बटन टेक्स्ट और उनके विवरण सूचीबद्ध हैं:

मूलपाठ
signin_with बटन टेक्स्ट "Google के साथ साइन इन करें" है:
'Google से साइन इन करें' लेबल वाला एक मानक बटनएक आइकन बटन जिसमें कोई दृश्यमान टेक्स्ट नहीं है
signup_with बटन टेक्स्ट "Google के साथ साइन अप करें" है:
'Google के साथ साइन अप करें' लेबल वाला एक मानक बटनएक आइकन बटन जिसमें कोई दृश्यमान टेक्स्ट नहीं है
continue_with बटन टेक्स्ट "Google के साथ जारी रखें" है:
'Google के साथ जारी रखें' लेबल वाला एक मानक बटनएक आइकन बटन जिसमें कोई दृश्यमान टेक्स्ट नहीं है
signup_with बटन टेक्स्ट "साइन इन" है:
'साइन इन' लेबल वाला एक मानक बटनएक आइकन बटन जिसमें कोई दृश्यमान टेक्स्ट नहीं है

डेटा-आकार

बटन का आकार। डिफ़ॉल्ट मान है rectangular । अधिक जानकारी के लिए निम्न तालिका देखें:

प्रकार आवश्यक उदाहरण
डोरी ऐच्छिक data-shape="rectangular"

निम्न तालिका उपलब्ध बटन आकृतियों और उनके विवरणों को सूचीबद्ध करती है:

आकार
rectangular आयताकार आकार का बटन। तो के लिए इस्तेमाल किया icon बटन प्रकार, यह रूप में एक ही है square
एक आयताकार मानक बटनएक आयताकार आइकन बटनएक आयताकार व्यक्तिगत बटन
pill गोली के आकार का बटन। तो के लिए इस्तेमाल किया icon बटन प्रकार, तो यह की तरह ही है circle
एक गोली के आकार का मानक बटनएक गोली के आकार का आइकन बटनएक गोली के आकार का व्यक्तिगत बटन
circle वृत्त के आकार का बटन। तो के लिए इस्तेमाल standard बटन प्रकार, तो यह की तरह ही है pill
एक गोलाकार मानक बटनएक गोलाकार आइकन बटनएक गोलाकार व्यक्तिगत बटन
square चौकोर आकार का बटन। तो के लिए इस्तेमाल standard बटन प्रकार, तो यह की तरह ही है rectangular
एक वर्ग मानक बटनएक वर्गाकार चिह्न बटनएक वर्ग वैयक्तिकृत बटन

डेटा-लोगो_संरेखण

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

प्रकार आवश्यक उदाहरण
डोरी ऐच्छिक data-logo_alignment="center"

निम्न तालिका उपलब्ध संरेखण और उनके विवरण को सूचीबद्ध करती है:

लोगो_संरेखण
left Google लोगो को बाएँ-संरेखित करता है:
बाईं ओर G लोगो वाला एक मानक बटन
center Google लोगो को केंद्र-संरेखित करता है:
केंद्र में G लोगो वाला एक मानक बटन

डेटा-चौड़ाई

न्यूनतम बटन चौड़ाई, पिक्सेल में। उपलब्ध अधिकतम चौड़ाई 400 पिक्सेल है।

अधिक जानकारी के लिए निम्न तालिका देखें:

प्रकार आवश्यक उदाहरण
डोरी ऐच्छिक data-width=400

डेटा लोकेल

बटन टेक्स्ट का प्री-सेट लोकेल। यदि यह सेट नहीं है, तो ब्राउज़र का डिफ़ॉल्ट स्थान या Google सत्र उपयोगकर्ता की वरीयता का उपयोग किया जाता है। इसलिए, अलग-अलग उपयोगकर्ताओं को स्थानीयकृत बटनों के विभिन्न संस्करण दिखाई दे सकते हैं, और संभवतः विभिन्न आकारों के साथ।

अधिक जानकारी के लिए निम्न तालिका देखें:

प्रकार आवश्यक उदाहरण
डोरी ऐच्छिक data-locale="zh_CN"

सर्वर-साइड एकीकरण

आपका सर्वर साइड अंतिमबिंदुओं निम्न HTTP संभाल चाहिए POST अनुरोध।

आईडी टोकन हैंडलर एंडपॉइंट

आईडी टोकन हैंडलर एंडपॉइंट आईडी टोकन को संसाधित करता है। संबंधित खाते की स्थिति के आधार पर, आप उपयोगकर्ता को साइन इन कर सकते हैं और या तो उन्हें साइन-अप पृष्ठ पर निर्देशित कर सकते हैं या अतिरिक्त जानकारी के लिए उन्हें खाता-लिंकिंग पृष्ठ पर निर्देशित कर सकते हैं।

HTTP POST अनुरोध निम्न जानकारी होती है:

प्रारूप नाम विवरण
कुकी g_csrf_token एक यादृच्छिक स्ट्रिंग जो प्रत्येक अनुरोध के साथ हैंडलर एंडपॉइंट में बदल जाती है।
अनुरोध पैरामीटर g_csrf_token एक स्ट्रिंग है कि पिछले कुकी मान के रूप में ही है, g_csrf_token .
अनुरोध पैरामीटर credential आईडी टोकन जो Google जारी करता है।
अनुरोध पैरामीटर select_by क्रेडेंशियल कैसे चुना जाता है.

जब डीकोड , आईडी टोकन दिखता निम्न उदाहरण की तरह:

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": "Eliza",
  "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"
}

निम्न तालिका के लिए संभावित मान को सूचीबद्ध करता है select_by क्षेत्र। सत्र और सहमति स्थिति के साथ उपयोग किए जाने वाले बटन के प्रकार का उपयोग मान सेट करने के लिए किया जाता है,

  • उपयोगकर्ता ने या तो वन टैप या साइन इन विथ गूगल बटन दबाया या टचलेस स्वचालित साइन-इन प्रक्रिया का उपयोग किया।

  • एक मौजूदा सत्र पाया गया था, या उपयोगकर्ता ने एक नया सत्र स्थापित करने के लिए Google खाते में चयनित और साइन-इन किया था।

  • अपने ऐप के साथ आईडी टोकन क्रेडेंशियल साझा करने से पहले उपयोगकर्ता या तो

    • क्रेडेंशियल साझा करने के लिए अपनी सहमति देने के लिए पुष्टि करें बटन दबाया, या
    • पहले सहमति दी थी और Google खाता चुनने के लिए एक खाते का चयन करें का उपयोग किया था।

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

मूल्य विवरण
auto किसी मौजूदा सत्र वाले उपयोगकर्ता का स्वचालित साइन-इन जिसने पहले क्रेडेंशियल साझा करने की सहमति दी थी।
user मौजूदा सत्र वाला उपयोगकर्ता, जिसने पहले सहमति दी थी, क्रेडेंशियल साझा करने के लिए वन टैप 'इस रूप में जारी रखें' बटन दबाया।
user_1tap मौजूदा सत्र वाले उपयोगकर्ता ने सहमति देने और क्रेडेंशियल साझा करने के लिए वन टैप 'इस रूप में जारी रखें' बटन दबाया। केवल क्रोम v75 और उच्चतर पर लागू होता है।
user_2tap एक मौजूदा सत्र के बिना एक उपयोगकर्ता ने एक खाते का चयन करने के लिए एक टैप 'इस रूप में जारी रखें' बटन दबाया और फिर सहमति देने और क्रेडेंशियल साझा करने के लिए एक पॉप-अप विंडो में पुष्टि करें बटन दबाया। गैर-क्रोमियम आधारित ब्राउज़र पर लागू होता है।
btn एक मौजूदा सत्र वाला उपयोगकर्ता जिसने पहले सहमति दी थी, उसने Google के साथ साइन इन करें बटन दबाया और क्रेडेंशियल साझा करने के लिए 'खाता चुनें' से एक Google खाता चुना।
btn_confirm मौजूदा सत्र वाले उपयोगकर्ता ने Google के साथ साइन इन बटन दबाया और सहमति देने और क्रेडेंशियल साझा करने के लिए पुष्टि करें बटन दबाया।
btn_add_session मौजूदा सत्र के बिना एक उपयोगकर्ता, जिसने पहले सहमति दी थी, Google खाते का चयन करने और क्रेडेंशियल साझा करने के लिए Google के साथ साइन इन करें बटन दबाया।
btn_confirm_add_session बिना किसी मौजूदा सत्र के उपयोगकर्ता ने पहले Google खाते का चयन करने के लिए Google के साथ साइन इन बटन दबाया और फिर सहमति और क्रेडेंशियल साझा करने के लिए पुष्टि करें बटन दबाया।

पासवर्ड क्रेडेंशियल हैंडलर एंडपॉइंट

पासवर्ड क्रेडेंशियल हैंडलर एंडपॉइंट पासवर्ड क्रेडेंशियल को संसाधित करता है जिसे मूल क्रेडेंशियल प्रबंधक पुनर्प्राप्त करता है।

HTTP POST अनुरोध निम्न जानकारी होती है:

प्रारूप नाम विवरण
कुकी g_csrf_token एक यादृच्छिक स्ट्रिंग जो प्रत्येक अनुरोध के साथ हैंडलर एंडपॉइंट में बदल जाती है।
अनुरोध पैरामीटर g_csrf_token एक स्ट्रिंग है कि पिछले कुकी मान के रूप में ही है, g_csrf_token
अनुरोध पैरामीटर email यह आईडी टोकन जिसे Google जारी करता है।
अनुरोध पैरामीटर password क्रेडेंशियल कैसे चुना जाता है.