Content API for Shopping से शिपिंग सेटिंग माइग्रेट करना

शिपिंग की सेटिंग की जानकारी पढ़ने के लिए Merchant API का इस्तेमाल करने के लिए, इन अनुरोधों का इस्तेमाल करें:

GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}/shippingSettings

{accountId} की जगह अपने Merchant Center खाते के यूनीक आइडेंटिफ़ायर का इस्तेमाल करें.

शिपिंग की सेटिंग की जानकारी पढ़ने के लिए Merchant API का इस्तेमाल करने के लिए, इन अनुरोधों का इस्तेमाल करें:

POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}/shippingSettings:insert

Content API for Shopping और Merchant API के बीच तुलना

यहां Shopping के लिए Content API और Merchant Shipping settings API की तुलना का सैंपल दिया गया है:

Content API मर्चेंट एपीआई
यूआरएल https://shoppingcontent.googleapis.com/content/v2.1/{accountId}/shippingsettings:insert https://merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}/shippingSettings:insert
आइडेंटिफ़ायर {accountId}/shippingsettings/{accountId} {name}

इस सूची में, Content API for Shopping के मुकाबले Merchant Shipping settings API में किए गए अहम बदलावों के बारे में बताया गया है:

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

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

Content API for Shopping की तुलना में, Merchant शिपिंग की सेटिंग वाला एपीआई, इन नए फ़ील्ड के साथ काम करता है:

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

बदले गए फ़ील्ड

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

ऐसे फ़ील्ड जो काम नहीं करते

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

Shopping के लिए Content API मर्चेंट एपीआई
postal_code_group region
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
    • |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 मर्चेंट एपीआई
      customBatch हां नहीं
      रिवॉर्ड पाएँ हां हां
      अपडेट करो हां नहीं
      इंसर्ट करें नहीं हां
      getSupportedCarrier हां नहीं
      getSupportedHolidays हां नहीं