शुरू करें

Manufacturer Center (MfC) API की मदद से, ऐप्लिकेशन सीधे तौर पर Manufacturer Center प्लैटफ़ॉर्म से इंटरैक्ट कर सकते हैं. शुरू करने में आपकी मदद करने के लिए, हम Java और .NET में कोड के सैंपल उपलब्ध कराते हैं.

इस गाइड से आपको Manufacturer Center API का इस्तेमाल करके, पहला ऐप्लिकेशन बनाने में मदद मिलेगी. इससे पहले कि आप कोडिंग शुरू करें, आपको कुछ चीज़ें करनी होंगी.

REST सपोर्ट

हमारा REST API दो तरह के संसाधनों के लिए बुनियादी CRUD के ऑपरेशन के साथ काम करता है:

• ब्रैंड मालिकों और डेटा पार्टनर के लिए प्रॉडक्ट.
• साथ ही, सर्टिफ़िकेट देने वाली संस्थाओं के लिए ProductCertification भी लिया जाता है.

इसके अलावा, बाकी के दस्तावेज़ मुख्य रूप से Product के लिए लिखे जाएंगे. हालांकि, ProductCertification की प्रोसेस एक जैसी होनी चाहिए.

अपना Manufacturer Center खाता सेट अप करना

1. Manufacturer Center खाता बनाएं.

2. पक्का करें कि आपने इस Manufacturer Center खाते को बनाने के लिए किस ईमेल का इस्तेमाल किया था, क्योंकि आपको बाद में इसकी ज़रूरत पड़ेगी. स्क्रीनशॉट में, आपको यह manufacturer_user@example.com के तौर पर दिखेगा.

अपना पहला एपीआई अनुरोध करें (कोड की लाइन के बिना!)

1. Accounts.Products.list के लिए, हमारे डेवलपर दस्तावेज़ में मौजूद एपीआई एक्सप्लोरर पर जाएं.

2. पक्का करें कि जिस Google खाते से लॉग इन किया गया है वह सेटिंग टैब में 'उपयोगकर्ता' सेटिंग में मौजूद हो.

   

3. एपीआई एक्सप्लोरर में, पक्का करें कि पुष्टि करने की सुविधा के ड्रॉप-डाउन मेन्यू में, Google OAuth 2.0 को चुना गया हो:

   

4. accounts/{account_id} डालें. {account_id} की जगह, Manufacturer Center खाते में मौजूद अपना Manufacturer Center आईडी डालें. इसके बाद, फ़ॉर्म के 'पैरंट' फ़ील्ड में जाएं और लागू करें पर क्लिक करें.

   

5. आपको एक सफल जवाब दिखना चाहिए. बधाई हो! आपने Manufacturer Center API के लिए अपना पहला अनुरोध किया है.

6. अगर आपके Manufacturer Center में अभी तक कोई प्रॉडक्ट नहीं है, तो लिस्ट में कोई भी प्रॉडक्ट नहीं होगा. इस समय, दूसरे अनुरोधों पर पहुंचा जा सकता है और यह देखा जा सकता है कि वे क्या करते हैं. यह एक RESTful API है, इसलिए सभी अनुरोध एक ही तरह से काम करते हैं. प्रॉडक्ट खरीदने के बाद, Accounts.Products.get को आज़माएं.

Google API कंसोल प्रोजेक्ट बनाएं

Manufacturer Center API के अनुरोध, आपके एपीआई कंसोल प्रोजेक्ट के ज़रिए किए जाते हैं. हमारा सुझाव है कि आप अपना Manufacturer Center खाता ऐक्सेस करें. इसलिए, हमारा सुझाव है कि पुष्टि करने की प्रोसेस को आसान बनाने के लिए, सेवा खातों का इस्तेमाल करें. अपने Manufacturer Center खाते के साथ इस्तेमाल करने के लिए, नया सेवा खाता सेट अप करने का तरीका जानने के लिए, सेवा खाते की गाइड देखें.

Java का इस्तेमाल करके, आपका पहला अनुमति वाला एपीआई अनुरोध

आपने सेवा खाता सेट अप कर लिया है और अपने Manufacturer Center खाते में सेवा खाता आईडी जोड़ लिया है, तो उपलब्ध सैंपल कोड का इस्तेमाल करके अपना खाता ऐक्सेस किया जा सकता है. इस गाइड में Java के सैंपल का इस्तेमाल करके, यह बताया गया है कि एपीआई को कैसे इस्तेमाल करना है.

1. अगर आपने पहले से Apache Maven इंस्टॉल नहीं किया है, तो उसे इंस्टॉल करें.

2. हमारे GitHub पेज से, शॉपिंग के सैंपल डाउनलोड करें.

3. java सबडायरेक्ट्री से, Java के सैंपल बनाएं:

   $ mvn compile
   

4. अब इस कोड को ProductsListSample (ProductCertification का उदाहरण ListProductCertificationsSample होगा) चलाएं:

   $ mvn exec:java -Dexec.mainClass="shopping.manufacturers.v1.samples.products.ProductsListSample"
   

5. अगर आपने सोर्स फ़ाइलों के साथ मौजूद README में दिए गए कॉन्फ़िगरेशन के निर्देशों का पालन नहीं किया है, तो आपको यह गड़बड़ी दिखेगी कि कोई सैंपल कॉन्फ़िगरेशन नहीं मिला. कॉन्फ़िगरेशन डायरेक्ट्री बनाने और उसमें सही जानकारी डालने के लिए, README में दिए गए निर्देशों का पालन करें. सेवा खाता सेट अप करते समय, आपने जो JSON फ़ाइल डाउनलोड की है उसे service-account.json फ़ाइल नाम के साथ उस डायरेक्ट्री में रखा जाना चाहिए. यहां दिए गए एनवायरमेंट वैरिएबल को सेट करके, कोड को यह बताना न भूलें कि आपकी फ़ाइल कहां है.

   export GOOGLE_APPLICATION_CREDENTIALS=<Path to your JSON credentials file>
   

6. अब आपने सैंपल कॉन्फ़िगरेशन को सेट अप कर लिया है, तो ProductsListSample कोड को फिर से चलाएं.

   $ mvn exec:java -Dexec.mainClass="shopping.manufacturers.v1.samples.products.ProductsListSample"
   

7. यहां पहुंचने के बाद, Java प्रोग्राम अपना काम पूरा कर लेता है. फिर, उसे मिले प्रॉडक्ट की सूची या यह मैसेज प्रिंट कर लें कि आपके खाते में कोई भी प्रॉडक्ट नहीं था. अगर आपको "उपयोगकर्ता खाते 1234567890 को ऐक्सेस नहीं कर पा रहा है" जैसा गड़बड़ी का कोई मैसेज मिलता है, तो इसकी वजह यह हो सकती है कि आपने सेवा खाते के उपयोगकर्ता को Manufacturer Center में, अनुमति वाले उपयोगकर्ता के तौर पर सेट अप नहीं किया है. एपीआई के हिसाब से देखा जाए, तो एपीआई कंसोल प्रोजेक्ट ने ऐसे उपयोगकर्ता की ओर से अनुरोध भेजा था जो Manufacturer Center के आधिकारिक एडमिन की सूची में नहीं था. इसलिए, वह उस अनुरोध को अस्वीकार कर देगा.

8. आप जितनी बार चाहें उतनी बार ProductsListSample चलाकर प्रयोग कर सकते हैं, क्योंकि यह सिर्फ़ रीड-ओनली अनुरोध है. आप चाहें, तो Java और .NET, दोनों के लिए बनाए गए अन्य सैंपल भी देखें.