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	हां	नहीं