OAuth सेटअप

OAuth 2.0 लागू करने के लिए, अपने प्लैटफ़ॉर्म को कॉन्फ़िगर करने के लिए यह तरीका अपनाएं:

1. व्यापारी/कंपनी की सहमति वाला डायलॉग कॉन्फ़िगर करें.

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

   

   

   किसी तीसरे पक्ष को अपने खाते का ऐक्सेस देने पर, Google आपको एक ज़रूरी ईमेल सूचना भेजता है. यह सूचना आपको, यानी जगह के मालिक को चेतावनी देती है कि आपके खाते के डेटा को कौन ऐक्सेस कर सकता है में बदलाव किया गया है.

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

   

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

   1. ऐप्लिकेशन के होम पेज का लिंक: तीसरे पक्ष के उस पार्टनर का होम पेज जिसे आपने अपने खाते का ऐक्सेस दिया है.
   2. ऐप्लिकेशन की निजता नीति का लिंक: पार्टनर की निजता नीति का लिंक.
   3. आवेदन की सेवा की शर्तें (ToS) लिंक: पार्टनर की सेवा की शर्तों का लिंक.

   

   सहमति वाले कॉन्फ़िगरेशन के बारे में ज़्यादा जानने के लिए, OAuth 2.0 सेट अप करना > उपयोगकर्ता की सहमति देखें.

2. अपना ऐप्लिकेशन नाम और लोगो सेट करें.

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

   

प्लैटफ़ॉर्म के हिसाब से OAuth का इस्तेमाल

प्लैटफ़ॉर्म, मालिकों और मैनेजर की ओर से काम कर सकते हैं. इससे, व्यापारी/कंपनी/कारोबारी की ज़रूरी कार्रवाइयों की संख्या कम हो जाती है और ड्रॉप-ऑफ़ रेट कम हो जाता है.

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

प्लैटफ़ॉर्म पर OAuth का इस्तेमाल करने के आम उदाहरण यहां दिए गए हैं:

• व्यापारी/कंपनी के तौर पर जगहों को जोड़ें. इससे व्यापारी/कंपनी के Google खाते को मुख्य मालिक के तौर पर बनाया जाएगा.
• पार्टनर समीक्षाओं का जवाब दे सकते हैं. साथ ही, कारोबार के मालिक के तौर पर प्लैटफ़ॉर्म एपीआई इंटिग्रेशन की मदद से, पोस्ट बना सकते हैं.
• एपीआई का इस्तेमाल करते समय मैनेजर, कारोबार के मालिक के तौर पर जवाब दे सकते हैं.
• कारोबारी, अपने-आप Business Profile के संगठनों में जगहों की जानकारी ट्रांसफ़र कर सकते हैं.

• अपने-आप किसी खाते या जगह में एडमिन जोड़ें, जैसे कि कोई मैनेजर.

  उदाहरण के लिए, मैनेजमेंट उपयोगकर्ता के Google खाते को न्योता भेजने के लिए, कैश मेमोरी में सेव किए गए आपके OAuth 2.0 क्रेडेंशियल का इस्तेमाल किया जाता है. इसके बाद, मैनेजमेंट उपयोगकर्ता के कैश मेमोरी में सेव किए गए OAuth क्रेडेंशियल का इस्तेमाल करके, इस न्योते को स्वीकार किया जाता है.

  ध्यान दें: Google, जगह से उपयोगकर्ताओं को जोड़ने या हटाने पर, व्यापारी/कंपनी को ईमेल सूचनाएं भेजता है.

ऐसे अपवाद जिनके लिए व्यापारी/कंपनी/कारोबारी को सीधे तौर पर कार्रवाई करना ज़रूरी है

व्यापारी/कंपनी/कारोबारी के OAuth क्रेडेंशियल का इस्तेमाल करने वाले एपीआई कॉल से, सभी कार्रवाइयां अपने-आप नहीं हो सकतीं.

यहां कुछ ऐसे अपवादों के उदाहरण दिए गए हैं जिनके लिए व्यापारी/कंपनी को सीधे तौर पर कार्रवाई करना ज़रूरी है:

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