Content API for Shopping से शिपिंग सेटिंग माइग्रेट करना

ShippingSettings संसाधन की मदद से, अपने खाते और उससे जुड़े सभी उप-खातों की शिपिंग सेटिंग को वापस पाया जा सकता है और उन्हें अपडेट किया जा सकता है. अपने खाते के लिए शिपिंग की सेटिंग जोड़ने या मैनेज करने के तरीके के बारे में ज़्यादा जानने के लिए, शिपिंग की सेटिंग के बारे में खास जानकारी देखें.

शिपिंग की सेटिंग की जानकारी पढ़ने के लिए, Merchant API का इस्तेमाल करने के लिए, यहां दिए गए अनुरोधों का इस्तेमाल करें:

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/shippingSettings

{ACCOUNT_ID} की जगह अपने Merchant Center खाते का यूनीक आइडेंटिफ़ायर डालें.

शिपिंग की सेटिंग की जानकारी अपडेट करने के लिए, Merchant API का इस्तेमाल करने के लिए, यहां दिए गए अनुरोधों का इस्तेमाल करें:

POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/shippingSettings:insert

ज़्यादा जानकारी के लिए, तरीका: accounts.shippingSettings.insert देखें.

Content API for Shopping और Merchant API के बीच तुलना

यहां Content API for Shopping और Accounts sub-API में मौजूद Shipping settings resource की तुलना करने का एक उदाहरण दिया गया है:

	Content API	Merchant API
URL	https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/shippingsettings/{ACCOUNT_ID}	https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/shippingSettings:insert
आइडेंटिफ़ायर	{MERCHANT_ID}/shippingsettings/{ACCOUNT_ID}	{NAME}

यहां दी गई सूची में, Content API for Shopping की तुलना में, Accounts sub-API में शिपिंग की सेटिंग से जुड़े संसाधन के मुख्य अपडेट के बारे में बताया गया है:

1. Merchant API का इस्तेमाल करने वाले लोगों को accounts/{ACCOUNT_ID}/shippingSettings को {NAME} फ़ील्ड में डालना होगा, ताकि उन्हें एक जैसा अनुभव मिल सके.
2. Merchant API, कस्टम एरिया पर पढ़ने और लिखने की कार्रवाइयों के साथ काम नहीं करता. जैसे, लोकेशन ग्रुप. लोकेशन ग्रुप जैसे कस्टम एरिया को सिर्फ़ क्षेत्र की सेवा का इस्तेमाल करके पढ़ा या लिखा जा सकता है.
3. Merchant API में मौजूद एक सेवा, सामान की डिलीवरी के लिए कई देशों में काम करती है.
4. Merchant API, शिपिंग की सेटिंग के लिए सूची बनाने का तरीका उपलब्ध नहीं कराता. हालांकि, Content API में shippingsettings.list तरीका उपलब्ध है.

शामिल किए गए नए फ़ील्ड

Accounts sub-API में मौजूद शिपिंग सेटिंग रिसॉर्स, Content API for Shopping की तुलना में इन नए फ़ील्ड के साथ काम करता है:

1. warehouses: इससे फ़ुलफ़िलमेंट वेयरहाउस के बारे में जानकारी मिलती है. यह वेयरहाउस, इन्वेंट्री को स्टोर और मैनेज करता है.
2. लॉयल्टी प्रोग्राम: Merchant API का इस्तेमाल करने वाले लोग या कंपनियां, शिपिंग सेटिंग में लॉयल्टी प्रोग्राम की जानकारी डाल सकती हैं.
3. Etag: Etag को एसिंक की समस्याओं को हल करने के लिए डिज़ाइन किया गया है. ये समस्याएं तब होती हैं, जब अलग-अलग उपयोगकर्ता एक ही समय में Merchant API और Merchant Center UI का इस्तेमाल करके शिपिंग की सेटिंग अपडेट करने की कोशिश करते हैं.

नाम बदले गए फ़ील्ड

Accounts sub-API में, Shipping settings resource के इन फ़ील्ड के नाम बदले गए हैं:

Shopping के लिए Content API	शिपिंग की सेटिंग से जुड़ा संसाधन	ब्यौरा
service	services	एक शिपिंग सेवा.
service.name	services.serviceName	सेवा का नाम, जिसे Merchant Center खाते में यूनीक होना चाहिए.
service.deliveryCountry	services.deliveryCountries	यह एट्रिब्यूट, उस देश के सीएलडीआर रीजन कोड को दिखाता है जिस पर शिपिंग सेवा लागू होती है.
service.currency	services.currencyCode	यह उस मुद्रा का CLDR कोड है जिस पर यह सेवा लागू होती है.
service.deliveryTime.minTransitTimeInDays	services.deliveryTime.minTransitDays	किसी ऑर्डर को ट्रांज़िट में लगने वाले कम से कम कामकाजी दिनों की संख्या. उदाहरण के लिए, 0 का मतलब है कि ऑर्डर वाले दिन डिलीवरी की जाएगी और 1 का मतलब है कि अगले दिन डिलीवरी की जाएगी.
service.deliveryTime.maxTransitTimeInDays	services.deliveryTime.maxTransitDays	किसी ऑर्डर को ट्रांज़िट में लगने वाले कामकाजी दिनों की ज़्यादा से ज़्यादा संख्या.
service.deliveryTime.minHandlingTimeInDays	services.deliveryTime.minHandlingDays	ऑर्डर को शिप करने से पहले, कम से कम कितने कामकाजी दिन लगे.
service.deliveryTime.maxHandlingTimeInDays	services.deliveryTime.maxHandlingDays	किसी ऑर्डर को शिप करने से पहले, उसे प्रोसेस करने में लगने वाले कामकाजी दिनों की ज़्यादा से ज़्यादा संख्या.
service.deliveryTime.cutoffTime.timezone	services.deliveryTime.cutoffTime.timeZone	कटऑफ़ समय के लिए टाइमज़ोन आइडेंटिफ़ायर.
service.deliveryTime.transitTimeTable.postalCodeGroupName	services.deliveryTime.transitTimeTable.postalCodeGroupNames	पिन कोड ग्रुप का नाम.
service.deliveryTime.transitTimeTable.transitTimeLabel	services.deliveryTime.transitTimeTable.transitTimeLabel	प्रॉडक्ट के ट्रांज़िट समय का लेबल.
service.rate_group	services.rateGroups	शिपिंग के लिए तय की गई दर के ग्रुप की परिभाषाएं.
service.rate_group.subtable	services.rateGroups.subtables	सबटेबल की सूची.
service.rate_group.carrier_rate	services.rateGroups.carrierRates	नेटवर्क सेवा देने वाली कंपनी की दरों की सूची.
service.minimumOrderValueTable.storeCodeSetWithMovs	services.minimumOrderValueTable.storeCodeSetWithMovs	स्टोर कोड के उन सेट की सूची जिनकी कम से कम ऑर्डर वैल्यू एक जैसी है.

हटाए गए तरीके

एक ही अनुरोध में, एक से ज़्यादा खातों की शिपिंग सेटिंग को वापस पाने और अपडेट करने के लिए, shippingsettings.custombatch का इस्तेमाल नहीं किया जा सकता.

हटाए गए फ़ील्ड

Merchant API में, Content API for Shopping के इन फ़ील्ड को हटा दिया गया है. Merchant API, इन फ़ील्ड के लिए कोई दूसरा विकल्प नहीं देता है.

• postal_code_group
• service
• Pickup_service
• Eligibility
• Scheduling_channel
• Delivery_time
• Holiday_cutoff
• Rate_group
  • single_value_alternative_list

तरीके

Content API for Shopping और शिपिंग की सेटिंग वाले संसाधन में उपलब्ध तरीकों की तुलना यहां दी गई है:

तरीका	Shopping के लिए Content API	Merchant API
customBatch	हां	नहीं
get	हां	हां
update	हां	नहीं
insert	नहीं	हां
list	हां	नहीं
getSupportedCarrier	हां	नहीं
getSupportedHolidays	हां	नहीं