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

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

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

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

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

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

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

ইটাগ

অ্যাসিঙ্ক্রোনাস আপডেট এড়ানোর জন্য ই-ট্যাগ একটি এনকোডেড টোকেন। শিপিং সেটিংসের কোনো ডেটা পরিবর্তিত হলে ই-ট্যাগও পরিবর্তিত হয়। ব্যবহারকারীদের GET রিকোয়েস্ট থেকে প্রাপ্ত ই-ট্যাগটি INSERT রিকোয়েস্ট বডিতে কপি করতে হবে।

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

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

আপনার অ্যাকাউন্টের শিপিং সেটিংস যোগ বা আপডেট করতে shippingsettings.insert ব্যবহার করুন। এখানে একটি নমুনা অনুরোধ দেওয়া হলো, যা অ্যাকাউন্ট ১০-এর অধীনে 'GSA Shipping - Free Ship Over $49.99' নামক একটি শিপিং সার্ভিসের জন্য maxTransitDays কে ৭-এ আপডেট করে।

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"
        }
      ]
    }
  ]
}

গুরুত্বপূর্ণ: আপনি যদি শুধুমাত্র একটি অ্যাট্রিবিউট আপডেট করেন, তবুও INSERT রিকোয়েস্ট বডিতে shippingsettings রিসোর্সের সম্পূর্ণ রিসোর্স বডি থাকা আবশ্যক, কারণ রিকোয়েস্ট বডিতে কোনো NULL বা অনুপস্থিত মান থাকলে বিদ্যমান মানগুলো নাল হয়ে যায়।

শিপিং সেটিং যোগ করার জন্য এখানে একটি নমুনা দেওয়া হলো:

পাইথন

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 নমুনাটি দেখায় যে, আপনি কীভাবে আপনার মার্চেন্ট সেন্টার অ্যাকাউন্টের জন্য গুদামের তথ্য পরিচালনা করতে মার্চেন্ট শিপিং সেটিংস পরিষেবাটি ব্যবহার করতে পারেন:

"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 ব্যবহার করে প্রতিটি ওয়্যারহাউসকে উল্লেখ করা যায়।

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

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

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

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

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

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

4. একটি UPDATE অনুরোধ তৈরি করুন যাতে shippingsettings এবং warehouses রিসোর্সগুলো অন্তর্ভুক্ত থাকে।

এখানে ওয়্যারহাউস ১- এর জন্য একটি নমুনা 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"
        }
      ]
    }
  ]
}

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

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

আরও জানুন

Content API for Shopping থেকে মাইগ্রেট করার বিষয়ে জানতে, Migrate shipping settings management দেখুন।