हमने 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" लिखा होता है उनमें बदलाव किया जा सकता है या उन्हें हटाया जा सकता है.