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

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

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

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

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

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

ইটাগ

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

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

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

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

POST https://merchantapi.googleapis.com/accounts/v1/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"
        }
      ]
    }
  ]
}

শিপিং সেটিং সন্নিবেশ করার জন্য আপনি এখানে একটি নমুনা ব্যবহার করতে পারেন:

পাইথন 

from examples.authentication import configuration
from examples.authentication import generate_user_credentials
from google.shopping.merchant_accounts_v1 import GetShippingSettingsRequest
from google.shopping.merchant_accounts_v1 import ShippingSettingsServiceClient

_ACCOUNT = configuration.Configuration().read_merchant_info()
_PARENT = f"accounts/{_ACCOUNT}"


def get_shipping_settings():
  """Gets the ShippingSettings for a given Merchant Center account."""

  # Gets OAuth Credentials.
  credentials = generate_user_credentials.main()

  # Creates a client.
  client = ShippingSettingsServiceClient(credentials=credentials)

  # Creates the Shipping Settings name
  name = _PARENT + "/shippingSettings"

  # Creates the request.
  request = GetShippingSettingsRequest(name=name)

  # Makes the request and prints the retrieved ShippingSettings.
  try:
    response = client.get_shipping_settings(request=request)
    print("Retrieved ShippingSettings below")
    print(response)
  except RuntimeError as e:
    print(e)


if __name__ == "__main__":
  get_shipping_settings()

get_shipping_settings_sample.py

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

নিম্নলিখিত JSON নমুনাটি দেখায় যে কীভাবে আপনি আপনার Merchant Center অ্যাকাউন্টের জন্য গুদামের তথ্য পরিচালনা করতে Merchant Shipping সেটিংস পরিষেবা ব্যবহার করতে পারেন:

"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 অনুরোধ থেকে shippingsettings UPDATE অনুরোধে কপি করুন।

  3. INSERT অনুরোধের জন্য warehouses বিভাগে গুদামগুলি ব্যবহার করতে চাইলে সেগুলি পূরণ করুন।

  4. shippingsettings এবং warehouses সম্পদ সম্বলিত একটি UPDATE অনুরোধ করুন।

নিউ ইয়র্ক থেকে মাউন্টেন ভিউতে আপডেট করা ওয়্যারহাউস ১- এর জন্য ওয়্যারহাউস সহ 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 ফিল্ডটি true তে সেট করুন। আপনি যদি পরের দিনের ডেলিভারি বন্ধ করেন, তাহলে আপনার শিপিং পরিষেবাগুলি প্রতিদিন কাটঅফ সময়ের আগেই দৃশ্যমান হবে।

shipment_type local_delivery হলেই কেবল পরের দিন ডেলিভারি পাওয়া যাবে।

আরও জানুন

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