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

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

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