शिपिंग की सेटिंग की खास जानकारी

shippingsettings संसाधन की मदद से, अपने खाते की शिपिंग सेटिंग को वापस पाया जा सकता है और उन्हें अपडेट किया जा सकता है.

ध्यान दें: shippingsettings संसाधन उन शिपिंग सेटिंग के लिए काम नहीं करता है जिन्हें खाता लिंक करने की मदद से या ऑर्डर ट्रैकिंग के इतिहास को मैन्युअल तरीके से अपलोड करके बनाया गया है. इस एंडपॉइंट पर किए जाने वाले कॉल से, शिपिंग की ये सेटिंग न तो वापस की जाएंगी, न उनमें बदलाव किया जाएगा, और न ही उन्हें मिटाया जाएगा.

Google, कुछ प्रॉडक्ट के लिए डिलीवरी का अनुमानित समय अपने-आप अपडेट कर सकता है. ज़्यादा जानकारी के लिए, अपने-आप हाेने वाले सुधार चालू करें देखें.

शिपिंग की सेटिंग में मौजूद जानकारी को पढ़ना, लिखना या अपडेट करना

Merchant API की शिपिंग सेवा इस्तेमाल करने के लिए, ये काम करें:

1. अपने खाते की शिपिंग की पूरी सेटिंग वापस पाने के लिए, GET का अनुरोध करें.
2. शिपिंग की सेटिंग में बदलाव करें.
3. शिपिंग की सेटिंग में बदलाव करके, INSERT का अनुरोध करें.

ईटैग

एसिंक्रोनस अपडेट से बचने के लिए, Etag कोड में बदला गया टोकन है. शिपिंग की सेटिंग के डेटा में बदलाव होने पर, etag बदल जाता है. उपयोगकर्ताओं को GET अनुरोध से मिले ई-टैग को INSERT अनुरोध के मुख्य हिस्से में कॉपी करना होगा.

अगर GET अनुरोध और INSERT अनुरोध के बीच शिपिंग की सेटिंग का डेटा बदल जाता है, तो आपको गड़बड़ी का एक मैसेज मिलेगा. इस मैसेज में, सबसे हाल ही के etag टोकन को वापस पाने के लिए, GET का दूसरा अनुरोध किया जाएगा. नया etag टोकन वापस पाने के लिए, आपको GET अनुरोध को कॉल करना होगा. साथ ही, नए etag टोकन को INSERT अनुरोध वाले हिस्से में कॉपी करना होगा.

शिपिंग की सेटिंग जोड़ें

अपने खाते की शिपिंग सेटिंग जोड़ने या अपडेट करने के लिए, shippingsettings.insert का इस्तेमाल करें. यहां एक सैंपल अनुरोध दिया गया है, जिसमें GSA शिपिंग - 49.99 डॉलर से ज़्यादा के शिपिंग शुल्क नाम की शिपिंग सेवा के लिए, maxTransitDays को 7 पर अपडेट किया गया है.

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

{
  "services": [
    {
      "name": "FedEx",
      "active": true,
      "deliveryCountries": ["US"],
      "currencyCode": "USD",
      "deliveryTime": {
        "minTransitDays": 4,
        "maxTransitDays": 6,
        "minHandlingDays": 0,
        "maxHandlingDays": 0
      },
      "rateGroups": [
        {
          "singleValue": {
            "flatRate": {
              "amountMicros": 5990000,
              "currencyCode": "USD"
            }
          },
          "name": "All products"
        }
      ]
    },
    {
      "name": "GSA Shipping - Free Ship Over $49.99",
      "active": true,
      "deliveryCountries": "US",
      "currencyCode": "USD",
      "deliveryTime": {
        "minTransitDays": 3,
        "maxTransitDays": 7,
        "minHandlingDays": 1,
        "maxHandlingDays": 2
      },
      "rateGroups": [
        {
          "mainTable": {
            "rowHeaders": {
              "prices": [
                {
                  "amountMicros": 49990000,
                  "currencyCode": "USD"
                },
                {
                  "amountMicros": -1,
                  "currencyCode": "USD"
                }
              ]
            },
            "rows": [
              {
                "cells": [
                  {
                    "flatRate": {
                      "amountMicros": 6990000,
                      "currencyCode": "USD"
                    }
                  }
                ]
              },
              {
                "cells": [
                  {
                    "flatRate": {
                      "amountMicros": 0,
                      "currencyCode": "USD"
                    }
                  }
                ]
              }
            ]
          },
          "name": "Free Ship Over $49.99"
        }
      ]
    }
  ]
}

अहम जानकारी: INSERT अनुरोध के मुख्य हिस्से में shippingsettings संसाधन का पूरा संसाधन होना चाहिए, भले ही आप सिर्फ़ एक एट्रिब्यूट अपडेट कर रहे हों. ऐसा इसलिए होता है, क्योंकि अनुरोध के मुख्य हिस्से में कोई भी शून्य या मौजूद न होने पर, मौजूदा वैल्यू शून्य हो जाती हैं.

वेयरहाउस सेट करें

नीचे दिए गए JSON सैंपल से पता चलता है कि अपने व्यापारी खाते के लिए वेयरहाउस की जानकारी मैनेज करने के लिए, व्यापारी या कंपनी की शिपिंग सेटिंग की सेवा का इस्तेमाल कैसे किया जा सकता है:

"warehouses": [
  {
    "name": "warehouse 1",
    "shippingAddress": {
      "streetAddress": {street_address},
      "city": {city},
      "administrativeArea": {administrative_area},
      "postalCode": {postal_code},
      "regionCode": {region_code}
    },
    "cutoffTime": {
      "minutes": {minutes}
    },
    "handlingDays": {handling_days},
    "businessDaysConfig": {
      "businessDays": [
        "MONDAY", "SUNDAY"
      ]
    }
  }
]

इन्हें बदलें:

• {street_address}: वेयरहाउस के पते का सड़क के लेवल का हिस्सा.
• {city}: शहर, कस्बा या वह इलाका जहां वेयरहाउस मौजूद है.
• {administrative_area}: देश का प्रशासनिक डिवीज़न. उदाहरण के लिए, कोई राज्य.
• {postal_code}: पिन कोड या पिन कोड.
• {region_code}: स्ट्रिंग में देश का कोड.
• {minutes}: कटऑफ़ समय के मिनट का हिस्सा, जब तक कि किसी ऑर्डर को वेयरहाउस से उसी दिन प्रोसेस करने के लिए सबमिट नहीं किया जाता.
• {handling_days}: किसी आइटम को पैक करने और भेजने में इस वेयरहाउस को लगने वाले दिन.

warehouses संसाधन, वेयरहाउस की सूची है. हर वेयरहाउस को warehouse.name तक, शिपिंग सेवा के वेयरहाउस के हिसाब से डिलीवरी में लगने वाले समय के हिसाब से बताया जा सकता है.

अपने वेयरहाउस मैनेज करें

अपने वेयरहाउस मैनेज करने के लिए, Merchant API का इस्तेमाल करने का तरीका यहां बताया गया है:

1. अपने सभी मौजूदा shippingsettings और वेयरहाउस को वापस पाने के लिए, GET का अनुरोध करें.

2. GET अनुरोध से shippingsettings को UPDATE अनुरोध में कॉपी करें.

   ध्यान दें: अगर सभी मौजूदा shippingsettings कॉपी नहीं किए जाते हैं, तो INSERT के अनुरोध में उन्हें आपके खाते से मिटा दिया जाता है.

3. अगर आप INSERT अनुरोध के लिए warehouses सेक्शन में वेयरहाउस का इस्तेमाल करना चाहते हैं, तो उन्हें भरें.

4. UPDATE अनुरोध करें, जिसमें shippingsettings और warehouses संसाधन शामिल हों.

न्यूयॉर्क से माउंटेन व्यू में अपडेट किए गए Warehouse 1 के वेयरहाउस के लिए, INSERT के अनुरोध से जुड़े मुख्य हिस्से का सैंपल यहां दिया गया है:

{
  "services": [
    {
      "name": "Standard Shipping",
      "active": true,
      "deliveryCountries": ["US", "UK"],
      "currencyCode": "USD",
      "deliveryTime": {
        "minHandlingDays": 0,
        "maxHandlingDays": 1,
        "warehouseBasedDeliveryTimes": [
{"carrier": "Fedex"
 "carrierService": "ground"
 "warehouse": "Warehouse 1"
},
{"carrier": "Fedex"
 "carrierService": "2 days"
 "warehouse": "Warehouse 2"
}
]
      },
      "rateGroups": [
        {
          "singleValue": {
            "flatRate": {
              "amountMicros": 0,
              "currencyCode": "USD"
            }
          },
          "name": "Standard Shipping"
        }
      ],
    },
    {
      "name": "Expedited",
            "flatRate": {
              "amountMicros": 9990000,
              "currencyCode": "USD"
            }
          },
          "name": "Expedited"
        }
      ],
    }
  ],
  "warehouses": [
    {
      "name": "Warehouse1",
      "shippingAddress": [
        {
        "streetAddress": "1111 shoreline street"
          "city": "Mountain View",
          "administrativeArea": "CA"
        }
      ]
    },
    {
      "name": "Warehouse 2",
      "country": "US",
      "postalCodeRanges": [
        {
        "streetAddress": "1111 5th avenue"
          "city": "New York",
          "administrativeArea": "NY"
        }
      ]
    }
  ]
}

ऑर्डर वाले दिन प्रॉडक्ट डिलीवर करने की सुविधा जोड़ें

अगर आपके पास स्थानीय इन्वेंट्री है, तो ऑर्डर वाले दिन डिलीवरी करने की सुविधा वाली शिपिंग सेवाओं को कॉन्फ़िगर करने के लिए, Content API for Shopping का इस्तेमाल किया जा सकता है. ऑर्डर वाले दिन डिलीवरी करने वाली शिपिंग सेवाओं की shipment_type के तौर पर, local_delivery मौजूद हैं. फ़िलहाल, local_delivery की सभी शिपिंग सेवाओं को ऑर्डर वाले दिन ही डिलीवर करने वाली सेवा माना जाता है.

स्थानीय डिलीवरी के लिए, delivery_time की जानकारी में बदलाव नहीं किया जा सकता. अपने स्थानीय इन्वेंट्री प्रॉडक्ट की डिलीवरी वाले दिन ही प्रॉडक्ट डिलीवर करने की सुविधा सेट अप करने के लिए, shippingsettings.insert का इस्तेमाल करें.

यहां सैंपल के लिए अनुरोध का एक मुख्य हिस्सा दिया गया है. इसमें आपके खाते के लिए, सभी स्टोर में ऑर्डर वाले दिन प्रॉडक्ट डिलीवर करने की सेवा जोड़ी जाती है:

{
  "name": "accounts/accountId/shippingSettings",
  "services": [
    {
      "name": "Local Delivery",
      "active": true,
      "shipmentType": "local_delivery",
      "deliveryCountries": "US",
      "currencyCode": "USD",
      "rateGroups": [
        {
          "singleValue": {
            "flatRate": {
              "amountMicros": 0,
              "currencyCode": "USD"
            }
          }
        }
      ],
      "storeConfig": {
        "storeServiceType": "all stores",
        "storeCodes": [],
        "cutoffConfig": {
          "storeCloseOffsetHours": 2,
          "noDeliveryPostCutoff": true
        },
        "serviceRadius": {
          "value": 4,
          "unit": "Miles"
        }
      }
    }
  ]
}

अगले दिन डिलीवरी की सुविधा जोड़ें

ऑर्डर वाले दिन ही डिलीवरी करने के कटऑफ़ समय के बाद किए जाने वाले ऑर्डर, डिफ़ॉल्ट रूप से अगले दिन डिलीवरी के लिए शेड्यूल किए जाते हैं. अगले दिन डिलीवरी की सुविधा बंद करने के लिए, no_delivery_post_cutoff फ़ील्ड को 'सही' पर सेट करें. अगर अगले दिन डिलीवरी की सुविधा बंद कर दी जाती है, तो हर दिन कटऑफ़ समय से पहले ही आपकी शिपिंग सेवाएं दिखेंगी.

अगले दिन डिलीवरी की सुविधा सिर्फ़ तब उपलब्ध होगी, जब shipment_type local_delivery हो.