इस गाइड का इस्तेमाल करके, 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
उस प्रॉडक्ट के लिए स्टोर में मौजूद जानकारी को मैनेज करने के लिए संसाधन उपलब्ध हैं.
बैच रिक्वेस्ट
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
फ़ील्ड में दिखाई गई वैल्यू, आईडी के नए फ़ॉर्मैट का इस्तेमाल करती है.
उदाहरण के लिए, किसीgetName()
name
और आउटपुट को, name
को बनाने के बजाय वैरिएबल के तौर पर सेव करता है
और रिसॉर्स आईडी से आपको
नया आईडी फ़ॉर्मैट
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 में बना रहता है.