Content API for Shopping के साथ काम करने की सुविधा

इस गाइड का इस्तेमाल करके, 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 संसाधन का इस्तेमाल किया जा सकता है.

ध्यान दें: बेहतर डिज़ाइन की वजह से, हम Content API for Shopping और Merchant API की एक जैसी सुविधाओं के लिए, पुराने सिस्टम के साथ काम करने की गारंटी नहीं दे सकते. उदाहरण के लिए, Content API for Shopping और Merchant API में एक ही संसाधन के लिए फ़ील्ड के नाम या तरीके की उपलब्धता अलग-अलग हो सकती है.

बैच रिक्वेस्ट

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 फ़ील्ड में दी गई वैल्यू का इस्तेमाल करें.

उदाहरण के लिए, किसी संसाधन से name वापस पाने के लिए, getName() तरीका लागू करें और कारोबारी या कंपनी और रिसॉर्स आईडी से name बनाने के बजाय, आउटपुट को वैरिएबल के तौर पर सेव करें.

नया आईडी फ़ॉर्मैट

ध्यान दें: Merchant API, 13 नवंबर, 2023 तक बिना channel वैल्यू के आईडी दिखाएगा. 13 नवंबर के बाद, सभी कॉल के लिए पूरा संसाधन आईडी दिखेगा. आपको 1 फ़रवरी, 2024 से पहले अपने कॉल में channel के साथ-साथ पूरे रिसॉर्स आईडी का इस्तेमाल करना होगा.

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 फ़ॉर्मैट में बना रहता है.