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 और Merchant's Shipping settings API की तुलना का एक सैंपल दिया गया है:

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

इस सूची में, Content API for Shopping की तुलना में Merchant Shipping settings API में हुए बड़े अपडेट के बारे में बताया गया है:

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

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

Merchant Shipping settings API, Content API for Shopping की तुलना में इन नए फ़ील्ड के साथ काम करता है:

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

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

Merchant API में इन फ़ील्ड के नाम बदले गए हैं:

Shopping के लिए Content API	Merchant Shipping settings 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 का इस्तेमाल नहीं किया जा सकता.

काम न करने वाले फ़ील्ड

Content API के इन फ़ील्ड का इस्तेमाल, Merchant API में नहीं किया जा सकता. Merchant API, इन फ़ील्ड के लिए कोई विकल्प नहीं देता.

• postal_code_group
• service
• Pickup_service
• Eligibility
• Scheduling_channel
• Delivery_time
• Holiday_cutoff
• Min_scheduling_time_in_days
• Max_scheduling_time_in_days
• Scheduling_business_day_config
• Rate_group
  • single_value_alternative_list

तरीके

यहां Content API for Shopping और Merchant Shipping settings API के तरीकों की तुलना की गई है:

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