डेटा की सुरक्षा, ऐक्सेस कंट्रोल लागू करने, और सिस्टम की अखंडता बनाए रखने के लिए, आपको Merchant API के सभी अनुरोधों की पुष्टि करनी होगी. एपीआई, पुष्टि की गई पहचान का इस्तेमाल करके यह तय करता है कि कॉल करने वाले के पास कौनसी कार्रवाइयां करने की अनुमति है. उदाहरण के लिए, कुछ कॉलर के पास प्रॉडक्ट डेटा को सिर्फ़ पढ़ने का ऐक्सेस हो सकता है. वहीं, अन्य कॉलर Merchant Center में खाता सेटिंग में बदलाव कर सकते हैं.
यह दस्तावेज़, Merchant API का इस्तेमाल शुरू करने के बारे में जानकारी देने वाली सीरीज़ का हिस्सा है. अगर आपने Merchant API के साथ पहले से ही पुष्टि करने की सुविधा सेट अप की है, तो अगले सेक्शन पर जाएं: डेवलपर के तौर पर रजिस्टर करें
Merchant API को अनुरोधों की अनुमति देना
Merchant API को भेजे गए हर अनुरोध में अनुमति वाला टोकन होना चाहिए, ताकि Google आपके ऐप्लिकेशन की पहचान कर सके. पुष्टि करने और अनुमति देने की सुविधा सेट अप करने के लिए, इस्तेमाल का वह उदाहरण चुनें जो Merchant API के साथ काम करने के आपके तरीके के बारे में सबसे अच्छी तरह बताता हो:
क्या आपको दूसरे कारोबारों के इस्तेमाल के लिए कोई ऐप्लिकेशन बनाना है?
अगर हां, तो OAuth 2.0 ऑथराइज़ेशन का इस्तेमाल करें. अगर आपको ये काम करने हैं, तो OAuth 2.0 ऑथराइज़ेशन चुनें:
- आप तीसरे पक्ष की कंपनी या एजेंसी हैं: आपको एक ऐसा ऐप्लिकेशन बनाना है जिसका इस्तेमाल अन्य कारोबार, अपने Merchant Center खाते का डेटा मैनेज करने के लिए करेंगे. जैसे, SaaS प्लैटफ़ॉर्म.
- आपको कई बाहरी खाते मैनेज करने हैं: आपको एक ही ऐप्लिकेशन को अलग-अलग क्लाइंट के मालिकाना हक वाले कई 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 खाते का ऐक्सेस देना और सेवा खातों की खास जानकारी लेख पढ़ें.