इस गाइड में, OAuth 2.0 का इस्तेमाल करके, अन्य पक्षों के Merchant Center खातों का ऐक्सेस पाने का तरीका बताया गया है. अगर आप तीसरे पक्ष की कंपनी हैं, तो इस वर्कफ़्लो का इस्तेमाल करें. इससे आपका ऐप्लिकेशन, आपके क्लाइंट के Merchant Center खातों का ऐक्सेस पाने का अनुरोध कर पाएगा.
अगर आपको ऐसा ऐप्लिकेशन बनाना है जिसे सिर्फ़ आपके Merchant Center खाते का ऐक्सेस चाहिए, तो अपने खाते को ऐक्सेस करना लेख पढ़ें.
ऐप्लिकेशन की पुष्टि करने का अनुरोध करना
Merchant API को ऐक्सेस करने वाले ऐप्लिकेशन के लिए, OAuth की पुष्टि करने वाली समीक्षा प्रक्रिया से गुज़रना ज़रूरी है. जिन ऐप्लिकेशन की पुष्टि नहीं हुई है उन्हें चेतावनी मिलेगी. साथ ही, उनमें सीमित सुविधाएं उपलब्ध होंगी.
Google Cloud में, ऐप्लिकेशन का मतलब किसी भी ऐसी चीज़ से है जिसका यूनीक OAuth 2.0 क्लाइंट आईडी हो.
पुष्टि की प्रक्रिया में आम तौर पर, तीन से पांच कामकाजी दिन लगते हैं. ज़्यादा जानने और पुष्टि के लिए अनुरोध सबमिट करने के लिए, ऐप्लिकेशन की पुष्टि लेख पढ़ें.
यह नीति सभी ऐप्लिकेशन पर लागू होती है. हमारा सुझाव है कि सभी ऐप्लिकेशन के लिए, पुष्टि की प्रक्रिया जल्द से जल्द पूरी कर लें, ताकि कारोबार में कोई रुकावट न आए.
OAuth के दायरे पाना
स्कोप चुनने से जुड़ी समस्याओं से बचने के लिए, इंक्रीमेंटल ऑथराइज़ेशन सेट अप करें.
अगर आपने एक से ज़्यादा OAuth स्कोप का अनुरोध किया है, तो आपके ऐप्लिकेशन के लिए सहमति वाली स्क्रीन में, सभी OAuth स्कोप डिफ़ॉल्ट रूप से चुने हुए नहीं होते हैं. जब आपका ऐप्लिकेशन किसी व्यक्ति को सहमति वाली स्क्रीन दिखाता है, तो उसे ऐक्सेस करने की अनुमति देने के लिए, व्यक्ति को हर स्कोप को मैन्युअल तरीके से चुनना होता है.
Merchant API का इस्तेमाल करने के लिए, आपके ऐप्लिकेशन को OAuth की सहमति वाली स्क्रीन पर इस स्कोप का अनुरोध करना होगा:
https://www.googleapis.com/auth/content
OAuth अनुरोध से मिले जवाब की जांच करें. इससे यह पुष्टि की जा सकेगी कि आपके ऐप्लिकेशन को यह स्कोप मिला है.
ज़्यादा जानकारी के लिए, OAuth 2.0 की नीतियां देखें.
अनुरोधों को अनुमति दें
आपका ऐप्लिकेशन, Merchant API को जो भी अनुरोध भेजता है उसमें अनुमति वाला टोकन होना ज़रूरी है. इस टोकन से Google आपके ऐप्लिकेशन की पहचान भी करता है.
अनुमति देने के प्रोटोकॉल के बारे में जानकारी
अनुरोधों को अनुमति देने के लिए, आपके ऐप्लिकेशन में OAuth 2.0 का इस्तेमाल किया जाना चाहिए. अनुमति देने वाले दूसरे प्रोटोकॉल इस्तेमाल नहीं किए जा सकते. अगर आपका ऐप्लिकेशन Google से साइन इन करने की सुविधा इस्तेमाल करता है, तो अनुमति देने से जुड़े कुछ पहलुओं को Google आपके लिए खुद मैनेज करता है.
OAuth 2.0 से अनुरोधों को अनुमति देना
Merchant API को भेजे गए सभी अनुरोधों के लिए अनुमति किसी ऐसे उपयोगकर्ता को देनी चाहिए जिसके पास ऐसा करने का अधिकार हो.
OAuth 2.0 के लिए अनुमति देने की प्रक्रिया या "तरीका" अलग-अलग हो सकता है. यह इस बात पर निर्भर करता है कि ऐप्लिकेशन किस तरह का है. सभी तरह के ऐप्लिकेशन के लिए नीचे दी गई सामान्य प्रक्रिया लागू होती है:
- ऐप्लिकेशन बनाने के बाद, उसे Google API Console का इस्तेमाल करके, रजिस्टर किया जाता है. इसके बाद, Google आपको क्लाइंट आईडी और क्लाइंट सीक्रेट जैसी जानकारी देगा.
- Google API Console में Merchant API को चालू करें. (अगर एपीआई को 'API कंसोल' की सूची में नहीं जोड़ा गया है, तो यह चरण छोड़ दें.)
- जब आपके ऐप्लिकेशन को उपयोगकर्ता के डेटा को ऐक्सेस करने की ज़रूरत होती है, तब वह Google से, डेटा के खास लिंक का अनुरोध करता है.
- Google, उपयोगकर्ता को सहमति वाली स्क्रीन दिखाता है, जिसमें उनसे आपके ऐप्लिकेशन को उनके कुछ डेटा को ऐक्सेस करने की अनुमति मांगी जाती है.
- अगर उपयोगकर्ता इसकी अनुमति दे देता है, तो Google आपके ऐप्लिकेशन को कुछ समय के लिए इस्तेमाल किए जा सकने वाला ऐक्सेस टोकन देता है.
- आपका ऐप्लिकेशन, ऐक्सेस टोकन से उपयोगकर्ता के डेटा को ऐक्सेस करने का अनुरोध करता है.
- अगर Google को पता चलता है कि आपका अनुरोध और टोकन मान्य है, तो वह आपके ऐप्लिकेशन को अनुरोध किए गए डेटा का ऐक्सेस दे देता है.
कुछ तरीकों में दूसरे चरण भी शामिल हो सकते हैं, जैसे कि रिफ़्रेश टोकन इस्तेमाल करके, नया ऐक्सेस टोकन पाना. अलग-अलग तरह के ऐप्लिकेशन के लिए डेटा ऐक्सेस करने के तरीकों के बारे में ज़्यादा जानकारी पाने के लिए, Google का OAuth 2.0 दस्तावेज़ पढ़ें.
यहां Merchant API के लिए, OAuth 2.0 का इस्तेमाल करके अनुमति के लिए अनुरोध करने के बारे में जानकारी दी गई है:
| दायरा | मतलब |
|---|---|
https://www.googleapis.com/auth/content |
पढ़ने/लिखने का ऐक्सेस. |
OAuth 2.0 का इस्तेमाल करके, डेटा ऐक्सेस करने का अनुरोध करने के लिए, आपके ऐप्लिकेशन को अनुरोध के तरीके की जानकारी देनी होगी. साथ ही, वह जानकारी भी देनी होगी जो आपको ऐप्लिकेशन रजिस्टर करते समय, Google से मिली थी, जैसे कि क्लाइंट आईडी और क्लाइंट सीक्रेट.
यहां एक सैंपल दिया गया है. इसका इस्तेमाल अनुमति पाने के लिए किया जा सकता है.