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