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