শিপিং সেটিংসের ওভারভিউ

ShippingSettings রিসোর্স আপনাকে আপনার অ্যাকাউন্টের শিপিং সেটিংস পুনরুদ্ধার এবং আপডেট করতে দেয়।

দ্রষ্টব্য: shippingsettings রিসোর্স অ্যাকাউন্ট-লিঙ্কিং বা অর্ডার ট্র্যাকিং ইতিহাসের ম্যানুয়াল আপলোডের মাধ্যমে তৈরি করা শিপিং সেটিংসের জন্য কাজ করে না। এই এন্ডপয়েন্টে কল করে সেই শিপিং সেটিংস ফেরত, পরিবর্তন বা মুছে ফেলা হবে না।

Google স্বয়ংক্রিয়ভাবে কিছু পণ্যের জন্য আনুমানিক বিতরণ সময় আপডেট করতে পারে। আরও তথ্যের জন্য, স্বয়ংক্রিয় উন্নতি সক্ষম করুন দেখুন।

শিপিং সেটিংস পড়ুন, লিখুন বা আপডেট করুন

মার্চেন্ট API শিপিং পরিষেবা ব্যবহার করতে, নিম্নলিখিতগুলি করুন:

1. আপনার অ্যাকাউন্টের সম্পূর্ণ শিপিং সেটিংস পুনরুদ্ধার করার জন্য একটি GET অনুরোধ করুন।
2. শিপিং সেটিংস পরিবর্তন করুন।
3. পরিবর্তিত শিপিং সেটিংস সহ একটি INSERT অনুরোধ করুন৷

ইটাগ

Etag হল অ্যাসিঙ্ক্রোনাস আপডেট এড়াতে একটি এনকোড করা টোকেন। শিপিং সেটিংস ডেটা পরিবর্তন হলে etag পরিবর্তিত হয়। ব্যবহারকারীদের GET অনুরোধ থেকে প্রাপ্ত etagটি INSERT অনুরোধের বডিতে অনুলিপি করতে হবে।

যদি শিপিং সেটিংস ডেটা GET অনুরোধ এবং INSERT অনুরোধের মধ্যে পরিবর্তিত হয়, আপনি একটি ত্রুটির বার্তা পাবেন যাতে সাম্প্রতিকতম etag টোকেন পুনরুদ্ধার করার জন্য আরেকটি GET অনুরোধের অনুরোধ করা হয়। নতুন etag টোকেন পুনরুদ্ধার করতে আপনাকে GET অনুরোধ কল করতে হবে এবং INSERT অনুরোধের বডিতে নতুন etag টোকেনটি অনুলিপি করতে হবে।

আপনার শিপিং সেটিংস যোগ করুন

আপনার অ্যাকাউন্টের জন্য শিপিং সেটিংস যোগ বা আপডেট করতে shippingsettings.insert ব্যবহার করুন। এখানে একটি নমুনা অনুরোধ রয়েছে যা GSA শিপিং নামক একটি শিপিং পরিষেবার জন্য 7-এ maxTransitDays আপডেট করে - অ্যাকাউন্ট 10-এর অধীনে $49.99-এর বেশি ফ্রি শিপ ৷

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 রিসোর্সের সম্পূর্ণ রিসোর্স বডি থাকা উচিত, এমনকি যদি আপনি শুধুমাত্র একটি অ্যাট্রিবিউট আপডেট করেন, কারণ রিকোয়েস্ট বডিতে কোনো NULL বা অনুপস্থিত মান বিদ্যমান মানগুলিকে বাতিল করে দেয়।

গুদাম সেট করুন

নিম্নলিখিত 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 এর মাধ্যমে উল্লেখ করা যেতে পারে।

আপনার গুদামগুলি পরিচালনা করুন

আপনার গুদামগুলি পরিচালনা করতে মার্চেন্ট API কীভাবে ব্যবহার করবেন তা এখানে:

1. আপনার সমস্ত বিদ্যমান shippingsettings এবং গুদামগুলি পুনরুদ্ধার করার জন্য একটি GET অনুরোধ করুন৷

2. GET অনুরোধ থেকে UPDATE অনুরোধে shippingsettings কপি করুন।

   দ্রষ্টব্য: আপনি যদি সমস্ত বিদ্যমান shippingsettings অনুলিপি না করেন তবে INSERT অনুরোধে সেগুলি আপনার অ্যাকাউন্ট থেকে মুছে ফেলা হবে৷

3. আপনি যদি INSERT অনুরোধের জন্য warehouses বিভাগে ব্যবহার করতে চান তবে গুদামগুলিকে পপুলেট করুন৷

4. একটি UPDATE অনুরোধ করুন যাতে shippingsettings এবং warehouses সংস্থান রয়েছে৷

নিউ ইয়র্ক থেকে মাউন্টেন ভিউতে আপডেট করা ওয়্যারহাউস 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"
        }
      ]
    }
  ]
}

একই দিনে ডেলিভারি যোগ করুন

আপনার স্থানীয় ইনভেন্টরি থাকলে একই দিনের ডেলিভারি শিপিং পরিষেবাগুলি কনফিগার করতে আপনি কেনাকাটার জন্য সামগ্রী API ব্যবহার করতে পারেন৷ একই দিনে ডেলিভারি শিপিং পরিষেবাগুলিতে তাদের 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 হয়।

আরও জানুন

কেনাকাটার জন্য সামগ্রী API থেকে স্থানান্তর সম্পর্কে জানতে, শিপিং সেটিংস ব্যবস্থাপনা মাইগ্রেট দেখুন।