इस गाइड का इस्तेमाल करके, Merchant API को अपने मौजूदा Content API for Shopping लागू करने के तरीके के साथ इंटिग्रेट किया जा सकता है.
शुरू करें
Merchant API और इसके सब-एपीआई के बारे में जानने के लिए, Merchant API का डिज़ाइन देखें.
Merchant API का इस्तेमाल शुरू करने के लिए, अनुरोध के यूआरएल को इन फ़ॉर्मैट में बदलें:
https://merchantapi.googleapis.com/{sub-API}/{version}/{resource name}/{service}:{method}…
ज़्यादा जानकारी के लिए, क्विकस्टार्ट गाइड और Merchant API का रेफ़रंस देखें.
gRPC सहायता
Merchant API, gRPC और REST के साथ काम करता है. Merchant API के लिए gRPC और Content API for Shopping के लिए REST का इस्तेमाल एक साथ किया जा सकता है.
Merchant API क्लाइंट लाइब्रेरी के लिए gRPC ज़रूरी होता है.
ज़्यादा जानकारी के लिए gRPC का इस्तेमाल करना देखें.
इनके साथ काम करता है
इस गाइड में ऐसे सामान्य बदलावों के बारे में बताया गया है जो पूरे Merchant API पर लागू होते हैं. खास सुविधाओं में होने वाले बदलावों के बारे में जानने के लिए, नीचे दी गई गाइड देखें:
- माइग्रेट खातों के मैनेजमेंट
- शिपिंग की सेटिंग माइग्रेट करना
- प्रॉडक्ट मैनेजमेंट को माइग्रेट करना
- डेटा सोर्स मैनेजमेंट को माइग्रेट करना
- इन्वेंट्री मैनेज करना
- प्रमोशन मैनेजमेंट को माइग्रेट करना
- रिपोर्टिंग मैनेजमेंट को माइग्रेट करना
- कन्वर्ज़न के सोर्स मैनेजमेंट को माइग्रेट करना
- लोकल फ़ीड के पार्टनरशिप मैनेजमेंट को माइग्रेट करना
Merchant API को Content API for Shopping के मौजूदा 2.1 वर्शन की सुविधाओं के साथ काम करने के लिए डिज़ाइन किया गया है.
उदाहरण के लिए, Content API for Shopping की मौजूदा 2.1 इन्वेंट्री और products
को लागू करने के तरीके के साथ, Merchant Inventories API का इस्तेमाल किया जा सकता है. ऐसा हो सकता है कि किसी स्थानीय स्टोर में बेचा जाने वाला कोई नया स्थानीय प्रॉडक्ट अपलोड करने के लिए, Content API for Shopping का इस्तेमाल किया जाए. इसके बाद, उस प्रॉडक्ट की इन-स्टोर जानकारी को मैनेज करने के लिए, Merchant Inventories API LocalInventory
संसाधन का इस्तेमाल किया जा सकता है.
बैच रिक्वेस्ट
Merchant API, Content API for Shopping में दिखाए गए customBatch
तरीके के साथ काम नहीं करता. इसके बजाय, एक साथ कई अनुरोध भेजने का तरीका देखें. अगर आपने customBatch
का इस्तेमाल किया है और आपको Merchant API के लिए यह सुविधा चाहिए, तो अपने सुझाव में हमें इसकी वजह बताएं.
आइडेंटिफ़ायर
Google के एपीआई को बेहतर बनाने के सिद्धांतों के हिसाब से, हमने Merchant API के संसाधनों के आइडेंटिफ़ायर में कुछ बदलाव किए हैं.
Id का नाम बदल गया
Merchant API के सभी संसाधन, name
फ़ील्ड को अपने यूनीक आइडेंटिफ़ायर के तौर पर इस्तेमाल करते हैं.
यहां एक उदाहरण दिया गया है, जिसमें बताया गया है कि कॉल में name
फ़ील्ड का इस्तेमाल कैसे किया जा सकता है:
POST https://merchantapi.googleapis.com/inventories/v1beta/{parent}/regionalInventories:insert
Merchant API में, name
के इस नए फ़ील्ड को रिसोर्स आइडेंटिफ़ायर के तौर पर दिखाया जाता है.
यह वैल्यू, पढ़े और लिखे जाने वाले सभी कॉल के लिए होती है.
name
फ़ील्ड में दिखाई गई वैल्यू, आईडी के नए फ़ॉर्मैट का इस्तेमाल करती है.
उदाहरण के लिए, किसी संसाधन से name
वापस पाने के लिए, getName()
तरीका लागू करें और कारोबारी या कंपनी और रिसॉर्स आईडी से name
बनाने के बजाय, आउटपुट को वैरिएबल के तौर पर सेव करें.
नया आईडी फ़ॉर्मैट
Merchant API में, रिसॉर्स आईडी इस फ़ॉर्मैट का इस्तेमाल करते हैं:
channel~language~feedLabel~offerId
Content API संसाधनों ने आईडी में हर वैल्यू के लिए, ~
के बजाय :
का इस्तेमाल किया:
channel:language:feedLabel:offerId
सभी Merchant API कॉल, नए फ़ॉर्मैट में आईडी की वैल्यू के बीच ~
दिखाते हैं. हमारा सुझाव है कि आप रिस्पॉन्स से मिले इस नए फ़ॉर्मैट को सेव करें और आने वाले समय में किए जाने वाले कॉल में इसका इस्तेमाल करें.
चाइल्ड रिसॉर्स के लिए पैरंट फ़ील्ड
Merchant API में, चाइल्ड रिसॉर्स में parent
फ़ील्ड होता है. पैरंट रिसॉर्स को पास करने के बजाय, parent
फ़ील्ड का इस्तेमाल करके रिसॉर्स के name
के बारे में बताया जा सकता है, ताकि बच्चे को उस रिसॉर्स में शामिल किया जा सके. उस parent
के चाइल्ड रिसॉर्स की सूची बनाने के लिए, list
तरीकों के साथ parent
फ़ील्ड का इस्तेमाल भी किया जा सकता है.
उदाहरण के लिए, किसी प्रॉडक्ट की स्थानीय इन्वेंट्री दिखाने के लिए, parent
फ़ील्ड में list
तरीके के हिसाब से प्रॉडक्ट के name
की जानकारी दें. इस मामले में, दिया गया product
, दिए गए
LocalInventory
संसाधनों का parent
है.
टाइप
Merchant API के सब-एपीआई में शेयर किए जाने वाले कुछ सामान्य टाइप, यहां दिए गए हैं.
कीमत
'व्यापारी सामान्य' पैकेज में Price
के लिए हुए बदलावों की जानकारी यहां दी गई है:
Content API | मर्चेंट एपीआई | |
---|---|---|
रकम फ़ील्ड | value:string |
amountMicros:int64 |
मुद्रा फ़ील्ड | currency:string
|
currencyCode:string |
Price
की रकम अब माइक्रो में रिकॉर्ड की जाती है, जहां 10 लाख माइक्रो आपकी मुद्रा की स्टैंडर्ड यूनिट
के बराबर है.
Content API for Shopping में Price
, स्ट्रिंग के तौर पर दशमलव वाली एक संख्या होती है.
रकम फ़ील्ड का नाम value
से बदलकर amountMicros
कर दिया गया है
मुद्रा फ़ील्ड का नाम currency
से बदलकर currencyCode
कर दिया गया है. हालांकि, यह फ़ॉर्मैट ISO 4217 फ़ॉर्मैट में बना रहता है.