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 का इस्तेमाल करने वाले लोगों या कंपनियों को, {NAME} फ़ील्ड में accounts/{ACCOUNT_ID}/shippingSettings डालना होगा, ताकि उन्हें वही अनुभव मिले.
  2. Merchant API, कस्टम इलाकों पर रीड और राइट ऑपरेशन की सुविधा नहीं देता. जैसे, लोकेशन ग्रुप. लोकेशन ग्रुप जैसे कस्टम इलाकों को सिर्फ़ रीजन सेवा का इस्तेमाल करके पढ़ा या लिखा जा सकता है.
  3. Merchant API में मौजूद एक सेवा, डिलीवरी के लिए कई देशों की सुविधा देती है.
  4. Content API में shippingsettings.list तरीका उपलब्ध है. हालांकि, Merchant API में शिपिंग सेटिंग के लिए, सूची का कोई तरीका उपलब्ध नहीं है.

नए फ़ील्ड

Content API for Shopping की तुलना में, Accounts sub-API में मौजूद शिपिंग सेटिंग संसाधन में ये नए फ़ील्ड उपलब्ध हैं:

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

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

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

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

तरीका Content API for Shopping Merchant API
customBatch हां नहीं
get हां हां
update हां नहीं
insert नहीं हां
list हां नहीं
getSupportedCarrier हां नहीं
getSupportedHolidays हां नहीं
पीछे जाएं
Migrate region management
आगे बढ़ें
Migrate online return policy management