हमने Merchant API को Content API for Shopping के डेवलपर के लिए डिज़ाइन किया है. यह Content API for Shopping से मिलता-जुलता है, लेकिन इस्तेमाल करने में ज़्यादा आसान और फ़्लेक्सिबल है. Merchant API के डिज़ाइन के बारे में यहां ज़्यादा जानकारी दी गई है.
सब-एपीआई
Merchant API, सब-एपीआई का कलेक्शन है. सब-एपीआई, मिलती-जुलती सेवाओं और संसाधनों के ग्रुप होते हैं. इस डिज़ाइन का मतलब है कि अपने यूनीक इंटिग्रेशन के लिए, सिर्फ़ ज़रूरी सब-एपीआई का इस्तेमाल किया जा सकता है.
Merchant API में ये सब-एपीआई शामिल हैं:
- खाते: Merchant Center खातों को बड़े पैमाने पर मैनेज करें.
- प्रॉडक्ट: प्रॉडक्ट डेटा मैनेज करें. जैसे, कीमत और खरीदारी के लिए उपलब्धता.
- डेटा सोर्स: अपने प्रॉडक्ट के डेटा सोर्स देखें और उन्हें मैनेज करें.
- इन्वेंट्री: Google पर स्टोर या इलाके के हिसाब से अपने प्रॉडक्ट दिखाएं.
- रिपोर्ट: Google के सभी प्लैटफ़ॉर्म पर अपने प्रॉडक्ट, परफ़ॉर्मेंस, और प्रतिस्पर्धी माहौल से जुड़ा डेटा देखें.
- प्रमोशन: अपने प्रॉडक्ट के लिए खास ऑफ़र दिखाने के लिए, प्रमोशन बनाएं और उन्हें मैनेज करें.
- स्थानीय फ़ीड पार्टनरशिप: स्थानीय प्रॉडक्ट इन्वेंट्री फ़ीड अपलोड करें.
- कन्वर्ज़न के सोर्स: अपने खाते के लिए कन्वर्ज़न के सोर्स मैनेज करें.
- सूचनाएं: सूचनाएं पाने के लिए सदस्यता मैनेज करें.
- कोटा: अपने खातों का एपीआई कोटा देखें.
परिवहन
Merchant API का डिफ़ॉल्ट ट्रांसपोर्ट मैकेनिज़्म gRPC है. REST का भी इस्तेमाल किया जा सकता है.
ज़्यादा जानकारी के लिए, क्विकस्टार्ट गाइड देखें.
Enums
Merchant API के सभी Enum फ़ील्ड में, आने वाले समय में नई वैल्यू दिख सकती हैं. आपका कोड इस तरह से स्ट्रक्चर किया जाना चाहिए कि वह ऐसी वैल्यू को आसानी से हैंडल कर सके जिनकी पहचान नहीं की जा सकती. आपको ऐसी enum वैल्यू पर नज़र रखनी चाहिए जिनकी पहचान नहीं हुई है. साथ ही, कोड को अप-टू-डेट रखने के लिए ज़रूरी कार्रवाई करनी चाहिए.
वर्शन
सब-एपीआई के वर्शन अलग-अलग होते हैं. इसका मतलब है कि अगर हम किसी ऐसे सब-एपीआई को अपडेट करते हैं जिसका इस्तेमाल नहीं किया जाता, तो आपको कुछ करने की ज़रूरत नहीं है. आपको सिर्फ़ तब अपना कोड अपडेट करना होगा, जब इस्तेमाल किए जा रहे सब-एपीआई के नए वर्शन रिलीज़ किए जाते हैं. ज़्यादा जानकारी के लिए, वर्शनिंग देखें.
"बीटा" पर खत्म होने वाले वर्शन में बदलाव किया जा सकता है या उन्हें हटाया जा सकता है.