शुरू करें

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

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

REST सहायता

हमारा REST API, दो अलग-अलग तरह के संसाधनों के लिए, बुनियादी CRUD कार्रवाइयों की सुविधा देता है:

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

अपना 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} को अपने Manufacturer Center खाते से {account_id} में बदलकर, फ़ॉर्म के 'अभिभावक' फ़ील्ड में डालें और लागू करें पर क्लिक करें.

  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 चलाएं (उदाहरण के लिए, प्रॉडक्ट सर्टिफ़िकेशन 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 दोनों के लिए बनाया है.