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

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

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

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

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

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

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

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

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

यहां Content API for Shopping और Accounts सब-एपीआई में शिपिंग की सेटिंग के संसाधन की तुलना का एक सैंपल दिया गया है:

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

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

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

इस्तेमाल किए जा सकने वाले नए फ़ील्ड

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

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

जिन फ़ील्ड के नाम बदले गए हैं

खातों के सब-एपीआई में, शिपिंग की सेटिंग के संसाधन में इन फ़ील्ड के नाम बदले गए हैं:

Shopping के लिए Content API	शिपिंग की सेटिंग का संसाधन	ब्यौरा
service	services	एक शिपिंग सेवा.
service.name	services.serviceName	सेवा का फ़्री फ़ॉर्म नाम, जो आपके Merchant Center खाते में यूनीक होना चाहिए.
service.deliveryCountry	services.deliveryCountries	उस देश का CLDR इलाके का कोड जहां शिपिंग सेवा लागू होती है.
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	हां	नहीं