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 के यूज़र इंटरफ़ेस का इस्तेमाल करके, शिपिंग की सेटिंग अपडेट करने की कोशिश करते हैं.

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

Accounts sub-API में मौजूद Shipping settings रिसॉर्स में, इन फ़ील्ड के नाम बदले गए हैं:

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 हां नहीं
पीछे जाएं
Migrate data sources management
आगे बढ़ें
Migrate conversion sources management