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 के साथ काम करता है. Google Analytics 4 पर माइग्रेट करने के लिए, Merchant API के लिए gRPC और Shopping के लिए Content API के लिए REST एक ही समय.

Merchant API क्लाइंट लाइब्रेरी के लिए ज़रूरी है कि जीआरपीसी.

ज़्यादा जानकारी के लिए, gRPC का इस्तेमाल करें लेख देखें जानकारी.

इनके साथ काम करता है

इस गाइड में ऐसे सामान्य बदलावों के बारे में बताया गया है जो पूरे Merchant API पर लागू होते हैं. यहां जाएं: नीचे दी गई गाइड में, खास सुविधाओं में बदलाव करने के बारे में जानकारी दी गई है:

• माइग्रेट खातों के मैनेजमेंट
• शिपिंग की सेटिंग माइग्रेट करना
• प्रॉडक्ट मैनेजमेंट को माइग्रेट करना
• डेटा सोर्स मैनेजमेंट को माइग्रेट करना
• इन्वेंट्री मैनेज करना
• प्रमोशन मैनेजमेंट को माइग्रेट करना
• रिपोर्टिंग मैनेजमेंट को माइग्रेट करना
• कन्वर्ज़न के सोर्स मैनेजमेंट को माइग्रेट करना
• लोकल फ़ीड के पार्टनरशिप मैनेजमेंट को माइग्रेट करना

Merchant API को इस तरह से डिज़ाइन किया गया है कि यह Content API for Shopping के साथ काम कर सके वर्शन 2.1 की सुविधाएं उपलब्ध हैं.

उदाहरण के लिए, Merchant Center Inventories API का इस्तेमाल, अपने मौजूदा एपीआई के साथ किया जा सकता है Shopping के लिए Content API v2.1 इन्वेंट्री और products लागू करना. आपने लोगों तक पहुंचाया मुफ़्त में 'शॉपिंग के लिए Content API' का इस्तेमाल करके नया लोकल मैप अपलोड कर सकता है प्रॉडक्ट (जो बेचते हैं) का इस्तेमाल करें), इसके बाद मर्चेंट इन्वेंट्री एपीआई का इस्तेमाल करें LocalInventory उस प्रॉडक्ट के लिए स्टोर में मौजूद जानकारी को मैनेज करने के लिए संसाधन उपलब्ध हैं.

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

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

Merchant API, इस यूआरएल में दिखाए गए customBatch तरीके के साथ काम नहीं करता शॉपिंग के लिए Content API. इसके बजाय, बैच भेजें अनुरोध हैं. अगर आप customBatch का इस्तेमाल करते/करती हैं, और को Merchant API के लिए यह सुविधा चाहिए, तो हमें बताएं कि क्यों सुझाव, शिकायत या राय.

आइडेंटिफ़ायर

Google के एपीआई को बेहतर बनाने के सिद्धांतों से मेल खाने के लिए, हमने Merchant API संसाधनों के आइडेंटिफ़ायर में कुछ बदलाव किए गए हैं.

Id का नाम बदल गया

Merchant API के सभी संसाधन, name फ़ील्ड को अपने यूनीक आइडेंटिफ़ायर के तौर पर इस्तेमाल करते हैं.

यहां एक उदाहरण दिया गया है, जिसमें बताया गया है कि कॉल में name फ़ील्ड का इस्तेमाल कैसे किया जा सकता है:

POST https://merchantapi.googleapis.com/inventories/v1beta/{parent}/regionalInventories:insert

यह नया name फ़ील्ड, सभी पढ़ी गई और Merchant API में कॉल लिखें.

name फ़ील्ड में दिखाई गई वैल्यू, आईडी के नए फ़ॉर्मैट का इस्तेमाल करती है.

अहम जानकारी: हम यह सुझाव देते हैं कि आप name फ़ील्ड की वैल्यू को सीधे कॉल से बचने के लिए, संसाधन के नाम को पार्स करने या मैन्युअल तौर पर बनाने के बजाय, समस्याएं.

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

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

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

Merchant API में, संसाधन आईडी इन फ़ॉर्मैट का इस्तेमाल करते हैं: channel~language~feedLabel~offerId अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है

Content API संसाधनों ने आईडी में मौजूद हर वैल्यू के बीच, ~ के बजाय : का इस्तेमाल किया: channel:language:feedLabel:offerId

सभी Merchant API कॉल, नए फ़ॉर्मैट में वैल्यू के बीच ~ दिखाते हैं आईडी. हमारा सुझाव है कि आप जवाब से नए फ़ॉर्मैट को सेव करें और इसका इस्तेमाल अपने आने वाले कॉल.

चाइल्ड रिसॉर्स के लिए पैरंट फ़ील्ड

Merchant API में, चाइल्ड रिसॉर्स में parent फ़ील्ड होता है. Google Analytics 4 पर माइग्रेट करने के लिए, parent फ़ील्ड की मदद से, रिसॉर्स के name के बारे में बताएं, ताकि बच्चे को इसमें शामिल किया जा सके, ध्यान दें. parent का भी इस्तेमाल किया जा सकता है उस parent के चाइल्ड संसाधनों को सूचीबद्ध करने के लिए list तरीकों वाली फ़ील्ड.

उदाहरण के लिए, किसी दिए गए प्रॉडक्ट की स्थानीय इन्वेंट्री को सूची में शामिल करने के लिए, का name parent फ़ील्ड list तरीका. इस मामले में, दिया गया product,parent LocalInventory संसाधन लौटाए गए.

टाइप

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 में बना रहता है.