हमने 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 फ़ील्ड में नई वैल्यू दिख सकती हैं. आपका कोड इस तरह से स्ट्रक्चर्ड होना चाहिए कि वह ऐसी वैल्यू को आसानी से मैनेज कर सके जिनकी पहचान नहीं की जा सकती. आपको ऐसी enum वैल्यू पर नज़र रखनी चाहिए जिनकी पहचान नहीं हो पाई है. साथ ही, कोड को अप-टू-डेट रखने के लिए, आपको इसमें बदलाव करना चाहिए.
वर्शन
सब-एपीआई के वर्शन अलग-अलग होते हैं. इसका मतलब है कि अगर हम किसी ऐसे सब-एपीआई को अपडेट करते हैं जिसका इस्तेमाल नहीं किया जाता, तो आपको कुछ करने की ज़रूरत नहीं है. आपको अपना कोड सिर्फ़ तब अपडेट करना होगा, जब आपके इस्तेमाल किए जा रहे सब-एपीआई के नए वर्शन रिलीज़ किए जाएंगे. ज़्यादा जानकारी के लिए, वर्शनिंग देखें.