डेटा की सुरक्षा, ऐक्सेस कंट्रोल लागू करने, और सिस्टम की अखंडता बनाए रखने के लिए, आपको Merchant API के सभी अनुरोधों की पुष्टि करनी होगी. एपीआई, पुष्टि की गई पहचान का इस्तेमाल करके यह तय करता है कि कॉल करने वाले के पास कौनसी कार्रवाइयां करने की अनुमति है. उदाहरण के लिए, कुछ कॉलर के पास प्रॉडक्ट डेटा को सिर्फ़ पढ़ने का ऐक्सेस हो सकता है. वहीं, अन्य कॉलर Merchant Center में खाता सेटिंग में बदलाव कर सकते हैं.
यह दस्तावेज़, Merchant API का इस्तेमाल शुरू करने के बारे में जानकारी देने वाली सीरीज़ का हिस्सा है. अगर आपने Merchant API के साथ पहले से ही पुष्टि करने की सुविधा सेट अप की है, तो अगले सेक्शन पर जाएं: डेवलपर के तौर पर रजिस्टर करें
Merchant API को अनुरोधों की अनुमति देना
Merchant API को भेजे गए हर अनुरोध में, अनुमति वाला टोकन शामिल होना चाहिए. इससे Google को आपके ऐप्लिकेशन की पहचान करने में मदद मिलती है. पुष्टि करने और अनुमति देने की सुविधा सेट अप करने के लिए, उस इस्तेमाल के उदाहरण को चुनें जो Merchant API के साथ काम करने के आपके तरीके के बारे में सबसे अच्छी तरह से बताता हो:
क्या आपको दूसरे कारोबारों के इस्तेमाल के लिए कोई ऐप्लिकेशन बनाना है?
अगर हां, तो OAuth 2.0 ऑथराइज़ेशन का इस्तेमाल करें. अगर आपको ये काम करने हैं, तो OAuth 2.0 ऑथराइज़ेशन चुनें:
- आप तीसरे पक्ष की कंपनी या एजेंसी हैं: आपको एक ऐसा ऐप्लिकेशन बनाना है, जैसे कि SaaS प्लैटफ़ॉर्म. इसका इस्तेमाल अन्य कारोबार, अपने Merchant Center खाते का डेटा मैनेज करने के लिए करेंगे.
- आपको कई बाहरी खातों को मैनेज करना है: आपको एक ही ऐप्लिकेशन को अलग-अलग क्लाइंट के मालिकाना हक वाले कई Merchant Center खातों में इस्तेमाल करना है. आपके क्लाइंट, अपने Google खातों में साइन इन करके और सहमति वाली स्क्रीन पर "अनुमति दें" पर क्लिक करके अनुमतियां देते हैं.
क्या आपको अपने कारोबार के लिए ऐप्लिकेशन बनाना है?
अगर हां, तो Merchant API को ऐक्सेस करने के लिए, सेवा खाते की अनुमति का इस्तेमाल करें. इन स्थितियों में, सेवा खाते की अनुमति चुनें:
- आपने खुद ही अपना ऐप्लिकेशन बनाया है: आपने अपने कारोबार के लिए खास तौर पर एक टूल बनाया है, ताकि Merchant Center का डेटा मैनेज किया जा सके. इसके अलावा, आपको क्रेडेंशियल किसी खास व्यक्ति के बजाय, ऐप्लिकेशन के लिए चाहिए.
- आपको बिना किसी व्यक्ति के लॉगिन किए, ऑटोमेशन की ज़रूरत है: आपका ऐप्लिकेशन बैकग्राउंड में टास्क रन करता है. जैसे, इन्वेंट्री अपने-आप अपडेट होना या "क्रॉन" जॉब.
OAuth 2.0 ऑथराइज़ेशन
अगर आप तीसरे पक्ष की कोई कंपनी या एजेंसी हैं और एक से ज़्यादा क्लाइंट खाते मैनेज करती हैं, तो अनुरोधों को अनुमति देने के लिए, आपके ऐप्लिकेशन में OAuth 2.0 का इस्तेमाल किया जाना चाहिए. Merchant API के लिए OAuth 2.0 सेट अप करने के लिए, यह तरीका अपनाएं:
- Google Cloud Console में एपीआई और सेवाएं में जाकर, OAuth 2.0 क्रेडेंशियल बनाएं
- OAuth2 क्लाइंट क्रेडेंशियल को फ़ाइल में डाउनलोड करें. जैसे,
client-secrets.json - Merchant Center में ईमेल खाते को उपयोगकर्ता के तौर पर जोड़ें: पक्का करें कि अनुरोधों को मंज़ूरी देने के लिए इस्तेमाल किया जाने वाला Google खाता, Merchant Center में उपयोगकर्ता के तौर पर मौजूद हो. ज़्यादा जानकारी के लिए, Merchant Center खाते में किसी उपयोगकर्ता को जोड़ने या हटाने का तरीका लेख पढ़ें
- रजिस्ट्रेशन करने के लिए, उसे
Adminकी भूमिका असाइन करें. भूमिकाओं के बारे में ज़्यादा जानने के लिए, Merchant Center में ऐक्सेस लेवल और लोगों को मैनेज करना लेख पढ़ें - कोड के सैंपल की मदद से पुष्टि करने की सुविधा सेट अप करना: पुष्टि करने की सुविधा सेट अप करना और सैंपल कॉन्फ़िगरेशन के बारे में जानकारी देने वाले दस्तावेज़ सेक्शन में दिए गए निर्देशों का पालन करें
OAuth 2.0 ऑथराइज़ेशन के बारे में ज़्यादा जानने के लिए, तीसरे पक्ष के ऐप्लिकेशन को Merchant Center खाते का ऐक्सेस देना और Google API को ऐक्सेस करने के लिए OAuth 2.0 का इस्तेमाल करना लेख पढ़ें.
सेवा खाते की अनुमति
सेवा खाते का इस्तेमाल करके, Merchant API को अपने Merchant Center खाते का ऐक्सेस दिया जाता है. Merchant API के लिए सेवा खाते की अनुमति सेट अप करने के लिए, यह तरीका अपनाएं:
- Google Cloud Console में, एपीआई और सेवाएं में जाकर सेवा खाते के क्रेडेंशियल बनाएं
- निजी पासकोड डाउनलोड करें: सेवा खाते के लिए, JSON फ़ॉर्मैट में निजी पासकोड बनाएं और डाउनलोड करें. फ़ाइल का नाम बदलकर
service-account.jsonकरें - Merchant Center में सेवा खाता जोड़ना: सेवा खाते का यूनीक ईमेल पता कॉपी करें. जैसे,
sa@project.iam.gserviceaccount.comऔर इसे Merchant Center में नए उपयोगकर्ता के तौर पर जोड़ें. ज़्यादा जानकारी के लिए, Merchant Center में किसी उपयोगकर्ता को जोड़ने या हटाने का तरीका देखें - उसे
Adminका ऐक्सेस असाइन करें. ऐक्सेस लेवल के बारे में ज़्यादा जानने के लिए, Merchant Center में ऐक्सेस लेवल और लोगों को मैनेज करना लेख पढ़ें - कोड के सैंपल की मदद से पुष्टि करने की सुविधा सेट अप करना: पुष्टि करने की सुविधा सेट अप करना और सैंपल कॉन्फ़िगरेशन के बारे में जानकारी देने वाले दस्तावेज़ सेक्शन में दिए गए दिशा-निर्देशों का पालन करें
सेवा खाते को अनुमति देने के बारे में ज़्यादा जानने के लिए, अपने Merchant Center खाते का ऐक्सेस देने की अनुमति देना और सेवा खातों की खास जानकारी लेख पढ़ें.