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 में शिपिंग की सेटिंग के संसाधन की तुलना का एक सैंपल दिया गया है:

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 तरीका उपलब्ध है.

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

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

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

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

Accounts sub-API में, शिपिंग की सेटिंग के संसाधन में इन फ़ील्ड के नाम बदले गए हैं:

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 का इस्तेमाल नहीं किया जा सकता.

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

Content API for Shopping के ये फ़ील्ड, Merchant API से हटा दिए गए हैं. 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 हां नहीं
पीछे जाएं
Migrate region management
आगे बढ़ें
Migrate online return policy management