इंटिग्रेशन का तरीका चुनें
अपनी ज़रूरत के हिसाब से, सबसे सही तरीका चुनें:
| तरीका | इन स्थितियों में बेहतर है | ज़्यादा जानें |
|---|---|---|
| यूनिवर्सल कॉमर्स प्रोटोकॉल (यूसीपी) | मर्चेंट और खुदरा कारोबार करने वाले लोग या कंपनियां. | यूसीपी के बारे में जानकारी देने वाले दस्तावेज़ |
| खाता लिंक करने का स्टैंडर्ड तरीका | स्मार्ट होम, टीवी, और YouTube. | दस्तावेज़ |
खाता लिंक करने की सुविधा से, 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, लाइटें चालू करो".
बातचीत वाले ऐक्शन की मदद से, Google Assistant के अनुभव और सुविधाओं को उपयोगकर्ता के हिसाब से बनाना. जैसे, "Ok Google, Starbucks से मेरा पसंदीदा ऑर्डर करो".
उपयोगकर्ताओं को अपने Google खाते को, इनाम देने वाले किसी पार्टनर खाते से लिंक करने के बाद, YouTube पर इनाम की ज़रूरी शर्तें पूरी करने वाली लाइव स्ट्रीम देखने पर इनाम पाने की सुविधा देना.
Google खाते की प्रोफ़ाइल से, सहमति से शेयर किए गए डेटा की मदद से, साइन-अप के दौरान नए खातों में पहले से जानकारी भरना.
ज़रूरी शर्तें और सुविधाएं
यहां दी गई मैट्रिक्स में, लिंक करने के हर फ़्लो के लिए सहायता और सुझावों के बारे में बताया गया है.
| लिंक करने का फ़्लो | मानक सुविधाएं | यूसीपी की सुविधाएं |
|---|---|---|
| ऐप्लिकेशन फ़्लिप | सुझाए गए | सुझाए गए |
| आसान तरीके से लिंक करना | सुझाए गए | सुझाए गए |
| OAuth से लिंक करना | ज़रूरी है (फ़ॉलबैक) | ज़रूरी है (फ़ॉलबैक) |
| OAuth 2.1 | सुझाए गए | सुझाए गए |
एजेंटिक डेवलपमेंट (एमसीपी और यूसीपी)
लार्ज लैंग्वेज मॉडल (एलएलएम) और एआई एजेंट को, उपयोगकर्ता के डेटा को ऐक्सेस करने के लिए, मज़बूत पुष्टि की ज़रूरत होती है. Google खाते को किसी दूसरे खाते से लिंक करने की सुविधा, इन नए तरीकों के साथ काम करती है:
- मॉडल कॉन्टेक्स्ट प्रोटोकॉल (एमसीपी): 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 खाते से लिंक करने की सहमति दे पाते हैं. ऐप्लिकेशन फ़्लिप की सुविधा चालू करने के लिए, आपकी सेवा को OAuth से लिंक करने या Google से साइन इन करने की सुविधा को OAuth-आधारित लिंक करने की सुविधा का इस्तेमाल करके, ऑथराइज़ेशन कोड फ़्लो के साथ काम करना होगा.
ऐप्लिकेशन फ़्लिप की सुविधा, Android और iOS, दोनों के लिए उपलब्ध है.
यह सुविधा कैसे काम करती है:
Google का ऐप्लिकेशन, यह देखता है कि आपका ऐप्लिकेशन, उपयोगकर्ता के डिवाइस पर इंस्टॉल है या नहीं:
- अगर ऐप्लिकेशन इंस्टॉल है, तो उपयोगकर्ता को आपके ऐप्लिकेशन पर "फ़्लिप" कर दिया जाता है. आपका ऐप्लिकेशन, Google के साथ खाता लिंक करने के लिए, उपयोगकर्ता से सहमति लेता है. इसके बाद, Google के प्लैटफ़ॉर्म पर "फ़्लिप बैक" कर दिया जाता है.
- अगर ऐप्लिकेशन इंस्टॉल नहीं है या ऐप्लिकेशन फ़्लिप लिंक करने की प्रोसेस के दौरान कोई गड़बड़ी होती है, तो उपयोगकर्ता को आसान तरीके से लिंक करने या OAuth से लिंक करने के फ़्लो पर रीडायरेक्ट कर दिया जाता है.
दूसरी इमेज. ऐप्लिकेशन फ़्लिप की मदद से, किसी उपयोगकर्ता के फ़ोन पर खाता लिंक करना
OAuth-आधारित आसान तरीके से लिंक करना ('आसान तरीके से लिंक करना')
Google से साइन इन करने की सुविधा को OAuth-आधारित आसान तरीके से लिंक करने की सुविधा, OAuth से लिंक करने की सुविधा के साथ, Google से साइन इन करने की सुविधा जोड़ती है. इससे, लोग Google के प्लैटफ़ॉर्म से बाहर निकले बिना, लिंक करने की प्रोसेस पूरी कर पाते हैं. इससे, लोगों को होने वाली परेशानी और ड्रॉप-ऑफ़ कम हो जाते हैं.
OAuth-आधारित आसान तरीके से लिंक करने की सुविधा, Google से साइन इन करने की सुविधा को OAuth से लिंक करने की सुविधा के साथ मिलाकर, लोगों को बेहतर अनुभव देती है. इससे, लोग आसानी से साइन इन कर पाते हैं, खाता बना पाते हैं, और खाता
लिंक कर पाते हैं. आपकी सेवा को, OAuth 2.0 के मुताबिक अनुमति और टोकन एक्सचेंज एंडपॉइंट के साथ काम करना होगा.
इसके अलावा, आपके टोकन एक्सचेंज एंडपॉइंट को
JSON वेब टोकन (JWT)
के दावे के साथ काम करना होगा. साथ ही, ज़रूरी check और get इंटेंट को लागू करना होगा. इसके अलावा,
create इंटेंट को लागू करना ज़रूरी नहीं है.
यह सुविधा कैसे काम करती है:
Google, उपयोगकर्ता के खाते की पुष्टि करता है और यह जानकारी आपको पास करता है:
- अगर आपके डेटाबेस में उपयोगकर्ता का कोई खाता मौजूद है, तो उपयोगकर्ता अपने Google खाते को आपकी सेवा पर मौजूद अपने खाते से सफलतापूर्वक लिंक कर लेता है.
- अगर आपके डेटाबेस में उपयोगकर्ता का कोई खाता मौजूद नहीं है और आपकी सेवा, खाता बनाने की सुविधा देती है, तो उपयोगकर्ता, Google की ओर से दी गई पुष्टि की गई जानकारी (ईमेल, नाम, और प्रोफ़ाइल फ़ोटो) की मदद से, तीसरे पक्ष का नया खाता बना सकता है. इसके अलावा, OAuth से लिंक करने की सुविधा का इस्तेमाल करके, किसी दूसरे ईमेल से साइन इन और लिंक करने का विकल्प भी चुना जा सकता है.
तीसरी इमेज. आसान तरीके से लिंक करने की सुविधा की मदद से, किसी उपयोगकर्ता के फ़ोन पर खाता लिंक करना
आपको कौनसा फ़्लो इस्तेमाल करना चाहिए?
हमारा सुझाव है कि सभी फ़्लो लागू करें, ताकि लोगों को लिंक करने का बेहतर अनुभव मिल सके. आसान तरीके से लिंक करने और ऐप्लिकेशन फ़्लिप के फ़्लो से, लिंक करने में होने वाली परेशानी कम हो जाती है. ऐसा इसलिए, क्योंकि लोग लिंक करने की प्रोसेस को बहुत कम चरणों में पूरा कर पाते हैं. OAuth से लिंक करने के फ़्लो में, कम मेहनत लगती है. इसे लागू करने के बाद, लिंक करने के अन्य फ़्लो जोड़े जा सकते हैं.
टोकन के साथ काम करना
Google खाते को किसी दूसरे खाते से लिंक करने की सुविधा, OAuth 2.0 के स्टैंडर्ड टोकन मैकेनिज़्म पर काम करती है. उपयोगकर्ता की सहमति मिलने के बाद, Google को ऐक्सेस टोकन और रीफ़्रेश टोकन जारी किए जाते हैं, ताकि उसके खाते को लिंक किया जा सके.
- ऐक्सेस टोकन: ये कम समय के लिए मान्य टोकन होते हैं. इनका इस्तेमाल, Google आपके एपीआई को ऐक्सेस करने के लिए करता है.
- रीफ़्रेश टोकन: ये लंबे समय के लिए मान्य टोकन होते हैं. इनका इस्तेमाल, Google नए ऐक्सेस टोकन पाने के लिए करता है. ऐसा तब किया जाता है, जब ऐक्सेस टोकन की समयसीमा खत्म हो जाती है.
प्रोटोकॉल के कानूनी समझौतों और पैरामीटर से जुड़ी ज़रूरी शर्तों के बारे में ज़्यादा जानने के लिए, टोकन एक्सचेंज एंडपॉइंट देखें.
लगातार लिंक करने की सुविधा
लगातार लिंक करने की सुविधा, स्थिर इंटिग्रेशन के लिए ज़रूरी है. इससे यह पक्का होता है कि नेटवर्क में कुछ समय के लिए गड़बड़ी होने या क्रेडेंशियल को समय-समय पर रीफ़्रेश करने के दौरान भी, उपयोगकर्ता के खाते लिंक रहें.
लगातार लिंक करने की सुविधा को लागू करने के लिए, "स्लाइडिंग विंडो" तरीका इस्तेमाल करें. इसमें, मौजूदा रीफ़्रेश टोकन को रोटेट करने के बजाय, उसकी समयसीमा बढ़ाएं (आरएफ़सी 6749 का सेक्शन 6 देखें). इससे, रेस कंडीशन और अनचाहे तरीके से अनलिंक होने की समस्या से बचा जा सकता है. ऐसा तब हो सकता है, जब नया रीफ़्रेश टोकन जारी किया जाता है, लेकिन Google को वह नहीं मिलता या सेव नहीं होता.
Google के साथ रजिस्टर करना
हमें OAuth 2.0 के सेटअप की जानकारी और क्रेडेंशियल शेयर करने की ज़रूरत होगी, ताकि खाता लिंक करने की सुविधा चालू की जा सके. ज़्यादा जानकारी के लिए, रजिस्टर करने का तरीका देखें.