Merchant API डिज़ाइन

हमने Merchant API को Content API for Shopping के डेवलपर के लिए, जाना-पहचाना बनाया है. हालांकि, यह ज़्यादा आसान और फ़्लेक्सिबल है. Merchant API के डिज़ाइन के बारे में यहां ज़्यादा जानकारी दी गई है.

सब-एपीआई

Merchant API, सब-एपीआई का कलेक्शन है. सब-एपीआई, मिलती-जुलती सेवाओं और संसाधनों के ग्रुप होते हैं. इस डिज़ाइन का मतलब है कि अपने यूनीक इंटिग्रेशन के लिए, सिर्फ़ ज़रूरी सब-एपीआई का इस्तेमाल किया जा सकता है.

Merchant API में ये सब-एपीआई शामिल हैं:

  • खाते: एक साथ कई Merchant Center खातों को मैनेज करें.
  • कन्वर्ज़न: अपने खाते के लिए कन्वर्ज़न सोर्स मैनेज करें.
  • डेटा सोर्स: अपने प्रॉडक्ट के डेटा सोर्स देखें और उन्हें मैनेज करें.
  • समस्या हल करना: अपने खाते पर असर डालने वाली समस्याएं ढूंढें और ऐप्लिकेशन में डाइग्नोस्टिक्स पेज बनाएं.
  • इन्वेंट्री: Google पर स्टोर या इलाके के हिसाब से अपने प्रॉडक्ट दिखाएं.
  • स्थानीय फ़ीड पार्टनरशिप: स्थानीय प्रॉडक्ट इन्वेंट्री फ़ीड अपलोड करें.
  • सूचनाएं: सूचनाएं पाने के लिए सदस्यताएं मैनेज करें.
  • ऑर्डर ट्रैकिंग: शिपिंग में लगने वाले समय के अनुमान को बेहतर बनाने के लिए, पुराने ऑर्डर का ट्रैकिंग डेटा उपलब्ध कराएं. साथ ही, शिपिंग के एनोटेशन के साथ लिस्टिंग को बेहतर बनाएं.
  • प्रॉडक्ट: प्रॉडक्ट डेटा मैनेज करें. जैसे, कीमत और उपलब्धता.
  • Product Studio: Google Product Studio का इस्तेमाल करके, प्रॉडक्ट की इमेज और टेक्स्ट के सुझाव अपने-आप जनरेट करें.
  • प्रमोशन: अपने प्रॉडक्ट के लिए खास ऑफ़र दिखाने के लिए, प्रमोशन बनाएं और उन्हें मैनेज करें.
  • Quota: अपने खातों के एपीआई कोटा की जांच करें.
  • रिपोर्ट: Google के अलग-अलग प्लैटफ़ॉर्म पर अपने प्रॉडक्ट, परफ़ॉर्मेंस, और प्रतिस्पर्धी माहौल से जुड़ा डेटा देखें.
  • समीक्षाएं: प्रॉडक्ट और सेलर की समीक्षाएं मैनेज करें.

परिवहन

Merchant API का डिफ़ॉल्ट ट्रांसपोर्ट मैकेनिज़्म gRPC है. REST का भी इस्तेमाल किया जा सकता है.

ज़्यादा जानकारी के लिए, क्विकस्टार्ट गाइड देखें.

Enums

Merchant API के सभी enum फ़ील्ड में, आने वाले समय में नई वैल्यू दिख सकती हैं. आपके कोड को इस तरह से स्ट्रक्चर किया जाना चाहिए कि वह ऐसी वैल्यू को आसानी से हैंडल कर सके जिनकी पहचान नहीं हो पाई है. आपको ऐसी एनम वैल्यू पर नज़र रखनी चाहिए जिन्हें पहचाना नहीं जा सकता. साथ ही, कोड को अप-टू-डेट रखने के लिए ज़रूरी कार्रवाई करनी चाहिए.

वर्शन

सब-एपीआई के वर्शन अलग-अलग होते हैं. इसका मतलब है कि अगर हम किसी ऐसे सब-एपीआई को अपडेट करते हैं जिसका इस्तेमाल नहीं किया जाता, तो आपको कुछ भी करने की ज़रूरत नहीं है. आपको सिर्फ़ तब अपना कोड अपडेट करना होगा, जब आपके इस्तेमाल किए गए सब-एपीआई के नए वर्शन रिलीज़ किए जाते हैं. ज़्यादा जानकारी के लिए, वर्शनिंग देखें.

"बीटा" पर खत्म होने वाले वर्शन में बदलाव किया जा सकता है या उन्हें हटाया जा सकता है.