खास जानकारी

इंटिग्रेशन का तरीका चुनें

अपनी ज़रूरतों के हिसाब से सबसे सही तरीका चुनें:

पथ	इन स्थितियों में बेहतर है	ज़्यादा जानें
यूनिवर्सल कॉमर्स प्रोटोकॉल (यूसीपी)	कारोबारी या कंपनियां और खुदरा दुकानदार.	UCP Docs
खाता लिंक करने की स्टैंडर्ड प्रोसेस	स्मार्ट होम, टीवी, और YouTube.	Docs

खाता लिंक करने की सुविधा की मदद से, Google खाता इस्तेमाल करने वाले लोग आपकी सेवाओं से तुरंत, आसानी से, और सुरक्षित तरीके से कनेक्ट हो सकते हैं. आपके पास Google खाता लिंक करने की सुविधा लागू करने का विकल्प होता है. इससे, Google के ऐप्लिकेशन और सेवाओं के साथ, उपयोगकर्ता का डेटा शेयर किया जा सकता है.

सुरक्षित OAuth 2.0 प्रोटोकॉल की मदद से, किसी व्यक्ति के Google खाते को आपके प्लैटफ़ॉर्म पर मौजूद उसके खाते से सुरक्षित तरीके से लिंक किया जा सकता है. इससे Google ऐप्लिकेशन और डिवाइसों को आपकी सेवाओं का ऐक्सेस मिल जाता है.

लोग अपने खातों को लिंक या अनलिंक कर सकते हैं. इसके अलावा, Google खाता लिंक करने की सुविधा का इस्तेमाल करके, आपके प्लैटफ़ॉर्म पर नया खाता भी बनाया जा सकता है.

उपयोग के उदाहरण

Google खाते को लिंक करने की कुछ वजहें यहां दी गई हैं:

• अपने प्लैटफ़ॉर्म से किसी उपयोगकर्ता का डेटा, Google के ऐप्लिकेशन और सेवाओं के साथ शेयर करें.

• यूनिवर्सल कॉमर्स प्रोटोकॉल (यूसीपी) का इस्तेमाल करके, Google Shopping और एआई की मदद से काम करने वाले प्लैटफ़ॉर्म (Search, Gemini) के साथ इंटिग्रेट करें.

• Google TV का इस्तेमाल करके, वीडियो और फ़िल्मों का कॉन्टेंट चलाएं.

• Google Home ऐप्लिकेशन और Google Assistant की मदद से, Google Smart Home से कनेक्ट किए गए डिवाइसों को मैनेज और कंट्रोल करना. जैसे, "Ok Google, लाइटें चालू करो".

• Conversational Actions की मदद से, Google Assistant के साथ बातचीत करने के अनुभव और इसकी सुविधाओं को उपयोगकर्ता की ज़रूरत के हिसाब से बनाएं. जैसे, "Ok Google, Starbucks से मेरा पसंदीदा ऑर्डर करो".

• लोगों को YouTube पर, ज़रूरी शर्तें पूरी करने वाली लाइव स्ट्रीम देखने के बदले इनाम जीतने का मौका दें. इसके लिए, उन्हें अपने Google खाते को इनाम देने वाले किसी पार्टनर खाते से लिंक करना होगा.

• साइन अप करने के दौरान, नए खातों में पहले से मौजूद डेटा को भरने के लिए, Google खाते की प्रोफ़ाइल से सहमति लेकर शेयर किया गया डेटा इस्तेमाल किया जा सकता है.

सुविधाएँ और ज़रूरी शर्तें

यहां दी गई मैट्रिक्स में, लिंक करने के हर फ़्लो के लिए सहायता और सुझावों के बारे में बताया गया है.

लिंक करने का फ़्लो	मानक सुविधाएं	यूसीपी की सुविधाएं
ऐप्लिकेशन फ़्लिप	सुझाए गए	सुझाए गए
लिंक करने की प्रोसेस को आसान बनाना	सुझाए गए	सुझाए गए
OAuth लिंकिंग	ज़रूरी है (फ़ॉलबैक)	ज़रूरी है (फ़ॉलबैक)
OAuth 2.1	सुझाए गए	सुझाए गए

एजेंटिक डेवलपमेंट (एमसीपी और यूसीपी)

लार्ज लैंग्वेज मॉडल (एलएलएम) और एआई एजेंट को उपयोगकर्ता के डेटा को ऐक्सेस करने के लिए, मज़बूत पुष्टि की ज़रूरत होती है. खाता लिंक करने की सुविधा, इन नए पैराडाइम के साथ काम करती है:

• मॉडल कॉन्टेक्स्ट प्रोटोकॉल (एमसीपी): GAL, सुरक्षा से जुड़ी पुष्टि करने वाले प्रोटोकॉल के तौर पर काम करता है. एजेंट, OAuth 2.1 टोकन का इस्तेमाल करके, आपके एमसीपी सर्वर टूल से सुरक्षित तरीके से क्वेरी करते हैं.

• यूनिवर्सल कॉमर्स प्रोटोकॉल (यूसीपी): इससे शॉपिंग एजेंट, उपयोगकर्ता की प्रोफ़ाइलों और पेमेंट वेक्टर को सुरक्षित तरीके से ऐक्सेस कर पाते हैं.

• सिर्फ़ ज़रूरी डेटा शेयर करने के लिए, कस्टम स्कोप तय करके उपयोगकर्ता की निजता को बेहतर बनाएं. उपयोगकर्ता के डेटा का इस्तेमाल कैसे किया जाता है, यह साफ़ तौर पर बताकर उपयोगकर्ता का भरोसा बढ़ाएं.

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

खाता लिंक करने के फ़्लो

Google खाते से लिंक करने के तीन फ़्लो हैं. ये सभी OAuth पर आधारित हैं. साथ ही, इनके लिए आपको OAuth 2.0 के मुताबिक ऑथराइज़ेशन और टोकन एक्सचेंज एंडपॉइंट को मैनेज या कंट्रोल करना होगा.

लिंक करने की प्रोसेस के दौरान, Google को अलग-अलग Google खातों के लिए ऐक्सेस टोकन जारी किए जाते हैं. इसके लिए, खाताधारकों से उनके खातों को लिंक करने और डेटा शेयर करने की सहमति ली जाती है.

OAuth लिंक करने की सुविधा

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

OAuth लिंकिंग, ऑथराइज़ेशन कोड और इंप्लिसिट OAuth फ़्लो के साथ काम करती है. आपकी सेवा को इंप्लिसिट फ़्लो के लिए, OAuth 2.0 के मुताबिक ऑथराइज़ेशन एंडपॉइंट को होस्ट करना होगा. साथ ही, ऑथराइज़ेशन कोड फ़्लो का इस्तेमाल करते समय, ऑथराइज़ेशन और टोकन एक्सचेंज, दोनों एंडपॉइंट को दिखाना होगा.

पहली इमेज. OAuth लिंकिंग की मदद से, उपयोगकर्ता के फ़ोन पर खाता लिंक करना

OAuth पर आधारित ऐप्लिकेशन फ़्लिप लिंक करना ('ऐप्लिकेशन फ़्लिप')

यह एक OAuth फ़्लो है. इससे उपयोगकर्ताओं को लिंक करने के लिए, आपके ऐप्लिकेशन पर भेजा जाता है.

OAuth पर आधारित ऐप्लिकेशन फ़्लिप लिंक करने की सुविधा, लोगों को यह जानकारी देती है कि वे पुष्टि किए गए Android या iOS मोबाइल ऐप्लिकेशन और Google के प्लैटफ़ॉर्म के बीच कैसे स्विच करें. इससे वे डेटा ऐक्सेस करने से जुड़े सुझाए गए बदलावों की समीक्षा कर पाते हैं. साथ ही, वे आपके प्लैटफ़ॉर्म पर अपने खाते को अपने Google खाते से लिंक करने की सहमति दे पाते हैं. App Flip की सुविधा चालू करने के लिए, आपकी सेवा में OAuth लिंकिंग या OAuth पर आधारित 'Google से साइन इन करें' सुविधा का इस्तेमाल करके लिंकिंग की सुविधा होनी चाहिए. इसके लिए, ऑथराइज़ेशन कोड फ़्लो का इस्तेमाल करना होगा.

ऐप्लिकेशन फ़्लिप की सुविधा, Android और iOS दोनों के लिए उपलब्ध है.

यह सुविधा कैसे काम करती है:

Google ऐप्लिकेशन यह जांच करता है कि उपयोगकर्ता के डिवाइस पर आपका ऐप्लिकेशन इंस्टॉल है या नहीं:

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

दूसरी इमेज. ऐप्लिकेशन फ़्लिप की सुविधा का इस्तेमाल करके, उपयोगकर्ता के फ़ोन पर खाता लिंक करना

OAuth पर आधारित स्ट्रीमलाइन लिंकिंग ('स्ट्रीमलाइन')

OAuth पर आधारित, Sign in with Google की मदद से आसानी से खाता लिंक करने की सुविधा, OAuth की मदद से खाता लिंक करने की सुविधा के साथ-साथ Sign in with Google की सुविधा भी जोड़ती है. इससे उपयोगकर्ता, Google प्लैटफ़ॉर्म से बाहर जाए बिना खाता लिंक करने की प्रोसेस पूरी कर पाते हैं. इससे, खाता लिंक करने में आने वाली समस्याएं कम हो जाती हैं और उपयोगकर्ता के बीच में प्रोसेस छोड़ने की दर भी कम हो जाती है. OAuth पर आधारित स्ट्रीमलाइन लिंकिंग की सुविधा, उपयोगकर्ताओं को बेहतर अनुभव देती है. इसमें 'Google से साइन इन करें' और OAuth लिंकिंग को मिलाकर, आसानी से साइन इन करने, खाता बनाने, और खाता लिंक करने की सुविधा मिलती है. आपकी सेवा में, OAuth 2.0 के मुताबिक ऑथराइज़ेशन और टोकन एक्सचेंज एंडपॉइंट काम करने चाहिए. इसके अलावा, आपके टोकन एक्सचेंज एंडपॉइंट को JSON Web Token (JWT) असर्शन के साथ काम करना चाहिए. साथ ही, ज़रूरी check और get इंटेंट लागू करने चाहिए. इसके अलावा, create इंटेंट को लागू करना ज़रूरी नहीं है.

यह सुविधा कैसे काम करती है:

Google, उपयोगकर्ता खाते की पुष्टि करता है और यह जानकारी आपको भेजता है:

• अगर आपके डेटाबेस में उपयोगकर्ता का खाता मौजूद है, तो उपयोगकर्ता अपने Google खाते को आपकी सेवा पर मौजूद खाते से लिंक कर लेता है.
• अगर आपके डेटाबेस में उपयोगकर्ता के लिए कोई खाता मौजूद नहीं है और आपकी सेवा में खाता बनाने की सुविधा उपलब्ध है, तो उपयोगकर्ता के पास दो विकल्प होते हैं. पहला, Google से मिली जानकारी (ईमेल, नाम, और प्रोफ़ाइल फ़ोटो) का इस्तेमाल करके, तीसरे पक्ष का नया खाता बनाना. दूसरा, OAuth लिंकिंग का इस्तेमाल करके, किसी अन्य ईमेल से साइन इन करना और उसे लिंक करना.

तीसरी इमेज. उपयोगकर्ता के फ़ोन पर, आसानी से खाता लिंक करने की सुविधा का इस्तेमाल करके खाता लिंक करना

आपको किस फ़्लो का इस्तेमाल करना चाहिए?

हमारा सुझाव है कि सभी फ़्लो लागू करें, ताकि उपयोगकर्ताओं को लिंक करने का सबसे अच्छा अनुभव मिल सके. आसान और ऐप्लिकेशन फ़्लिप फ़्लो की मदद से, लिंक करने की प्रोसेस को आसान बनाया जा सकता है. इससे उपयोगकर्ता, लिंक करने की प्रोसेस को कुछ ही चरणों में पूरा कर पाते हैं. OAuth लिंकिंग फ़्लो को लागू करना सबसे आसान है. इसलिए, इसे लागू करने के बाद अन्य लिंकिंग फ़्लो जोड़े जा सकते हैं.

टोकन का इस्तेमाल करना

Google खाता लिंक करने की सुविधा, OAuth 2.0 के स्टैंडर्ड टोकन मैकेनिज़्म पर काम करती है. उपयोगकर्ता के खाते को लिंक करने की सहमति देने के बाद, Google को ऐक्सेस टोकन और रीफ़्रेश टोकन जारी किए जाते हैं.

• ऐक्सेस टोकन: ये कम समय के लिए इस्तेमाल किए जाने वाले टोकन होते हैं. इनका इस्तेमाल Google, आपके एपीआई को ऐक्सेस करने के लिए करता है.
• रीफ़्रेश टोकन: ये ऐसे टोकन होते हैं जिनकी समयसीमा लंबी होती है. इनका इस्तेमाल Google, नए ऐक्सेस टोकन पाने के लिए करता है.

प्रोटोकॉल के कानूनी समझौतों और पैरामीटर की ज़रूरी शर्तों के बारे में ज़्यादा जानने के लिए, टोकन एक्सचेंज एंडपॉइंट देखें.

परसिस्टेंट लिंकिंग

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

परसिस्टेंट लिंकिंग लागू करने के लिए, "स्लाइडिंग विंडो" अप्रोच का इस्तेमाल करें: मौजूदा रीफ़्रेश टोकन को रोटेट करने के बजाय, उसकी समयसीमा बढ़ाएं (RFC 6749 सेक्शन 6 देखें). इससे रेस कंडीशन और अनचाहे तरीके से अनलिंक होने की समस्या नहीं होती. ऐसा तब हो सकता है, जब नया रीफ़्रेश टोकन जारी किया गया हो, लेकिन Google को मिला न हो या Google ने उसे सेव न किया हो.

Google से रजिस्टर करें

हमें OAuth 2.0 सेटअप की जानकारी चाहिए. साथ ही, खाता लिंक करने की सुविधा चालू करने के लिए क्रेडेंशियल शेयर करने होंगे. ज़्यादा जानकारी के लिए, रजिस्ट्रेशन देखें.