ShippingSettings রিসোর্সটি আপনাকে আপনার অ্যাকাউন্ট এবং এর সাথে যুক্ত সমস্ত সাব-অ্যাকাউন্টের শিপিং সেটিংস পুনরুদ্ধার ও আপডেট করার সুযোগ দেয়। আপনি কীভাবে আপনার অ্যাকাউন্টের শিপিং সেটিংস যোগ বা পরিচালনা করতে পারেন সে সম্পর্কে আরও তথ্যের জন্য, শিপিং সেটিংসের ওভারভিউ দেখুন।
শিপিং সেটিংসের তথ্য পড়ার জন্য মার্চেন্ট এপিআই ব্যবহার করতে, নিম্নলিখিত অনুরোধগুলি ব্যবহার করুন:
GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/shippingSettings
{ACCOUNT_ID} এর জায়গায় আপনার মার্চেন্ট সেন্টার অ্যাকাউন্টের অনন্য শনাক্তকারীটি বসান।
শিপিং সেটিংসের তথ্য আপডেট করতে মার্চেন্ট এপিআই ব্যবহার করার জন্য, নিম্নলিখিত অনুরোধগুলি ব্যবহার করুন:
POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/shippingSettings:insert
আরও তথ্যের জন্য, পদ্ধতি: accounts.shippingSettings.insert দেখুন।
শপিং-এর জন্য কন্টেন্ট এপিআই এবং মার্চেন্ট এপিআই-এর মধ্যে তুলনা
এখানে শপিং-এর কন্টেন্ট এপিআই এবং অ্যাকাউন্টস সাব-এপিআই-এর শিপিং সেটিংস রিসোর্সের একটি নমুনা তুলনা দেওয়া হলো:
| কন্টেন্ট এপিআই | মার্চেন্ট এপিআই | |
|---|---|---|
| ইউআরএল | https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID} /shippingsettings/ {ACCOUNT_ID} | https://merchantapi.googleapis.com/accounts/v1/accounts/ {ACCOUNT_ID} /shippingSettings:insert |
| শনাক্তকারী | {MERCHANT_ID} /shippingsettings/ {ACCOUNT_ID} | {NAME} |
শপিং-এর কন্টেন্ট এপিআই-এর তুলনায় অ্যাকাউন্টস সাব-এপিআই-এর শিপিং সেটিংস রিসোর্সে যে প্রধান আপডেটগুলো করা হয়েছে, নিম্নলিখিত তালিকায় তা উল্লেখ করা হলো:
- একই আচরণ পাওয়ার জন্য মার্চেন্ট এপিআই ব্যবহারকারীদের অবশ্যই {NAME} ফিল্ডে
accounts/ {ACCOUNT_ID} /shippingSettingsযোগ করতে হবে। - মার্চেন্ট এপিআই কাস্টম এরিয়া, যেমন লোকেশন গ্রুপে, রিড এবং রাইট অপারেশন সমর্থন করে না। লোকেশন গ্রুপের মতো কাস্টম এরিয়া শুধুমাত্র রিজিয়ন সার্ভিস ব্যবহার করে রিড বা রাইট করা যায়।
- মার্চেন্ট এপিআই-এর একটি পরিষেবা একাধিক ডেলিভারি দেশকে সমর্থন করে।
- কন্টেন্ট এপিআই-এর shippingsettings.list মেথডের মতো, মার্চেন্ট এপিআই শিপিং সেটিংসের জন্য কোনো লিস্ট মেথড প্রদান করে না।
নতুন সমর্থিত ক্ষেত্রগুলি
শপিংয়ের জন্য কন্টেন্ট এপিআই-এর তুলনায় অ্যাকাউন্টস সাব-এপিআই-এর শিপিং সেটিংস রিসোর্স নিম্নলিখিত নতুন ফিল্ডগুলো সমর্থন করে:
-
warehouses: একটি ফুলফিলমেন্ট গুদাম সম্পর্কে তথ্য প্রদান করে, যা মজুদ পণ্য সংরক্ষণ ও পরিচালনা করে। - লয়ালটি প্রোগ্রাম : মার্চেন্ট এপিআই ব্যবহারকারীরা তাদের শিপিং সেটিংসে লয়ালটি প্রোগ্রামের তথ্য যোগ করতে পারেন।
- ই-ট্যাগ ( Etag) এমন অ্যাসিঙ্ক সমস্যা সমাধানের জন্য ডিজাইন করা হয়েছে, যা তখন দেখা দেয় যখন বিভিন্ন ব্যবহারকারী একই সময়ে মার্চেন্ট এপিআই (Merchant API) এবং মার্চেন্ট সেন্টার ইউআই (Merchant Center UI) ব্যবহার করে শিপিং সেটিংস আপডেট করার চেষ্টা করেন।
ক্ষেত্রগুলির নাম পরিবর্তন করুন
অ্যাকাউন্টস সাব-এপিআই-এর শিপিং সেটিংস রিসোর্সে নিম্নলিখিত ফিল্ডগুলির নাম পরিবর্তন করা হয়েছে:
| কেনাকাটার জন্য কন্টেন্ট এপিআই | শিপিং সেটিংস রিসোর্স | বর্ণনা |
|---|---|---|
service | services | একটি একক শিপিং পরিষেবা। |
service.name | services.serviceName | পরিষেবাটির একটি মুক্ত-শৈলীর নাম যা আপনার মার্চেন্ট সেন্টার অ্যাকাউন্টের মধ্যে অবশ্যই অনন্য হতে হবে। |
service.deliveryCountry | services.deliveryCountries | যে দেশে শিপিং পরিষেবাটি প্রযোজ্য, সেই দেশের সিএলডিআর (CLDR) টেরিটরি কোড। |
service.currency | services.currencyCode | যে মুদ্রার ক্ষেত্রে এই পরিষেবাটি প্রযোজ্য, তার CLDR কোড। |
service.deliveryTime.minTransitTimeInDays | services.deliveryTime.minTransitDays | একটি অর্ডার ট্রানজিটে থাকা ন্যূনতম কর্মদিবসের সংখ্যা। উদাহরণস্বরূপ, ০ মানে একই দিনে ডেলিভারি এবং ১ মানে পরের দিন ডেলিভারি। |
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 ব্যবহার করতে পারবেন না।
অপসারিত ক্ষেত্র
শপিং-এর জন্য কন্টেন্ট এপিআই (Content API) থেকে নিম্নলিখিত ফিল্ডগুলো মার্চেন্ট এপিআই (Merchant API) থেকে সরিয়ে দেওয়া হয়েছে। মার্চেন্ট এপিআই এই ফিল্ডগুলোর কোনো বিকল্প প্রদান করে না।
-
postal_code_group -
service -
Pickup_service -
Eligibility -
Scheduling_channel -
Delivery_time -
Holiday_cutoff -
Rate_group-
single_value_alternative_list
-
পদ্ধতি
এখানে শপিং-এর কন্টেন্ট এপিআই এবং শিপিং সেটিংস রিসোর্সের মেথডগুলোর একটি তুলনা দেওয়া হলো:
| পদ্ধতি | কেনাকাটার জন্য কন্টেন্ট এপিআই | মার্চেন্ট এপিআই |
|---|---|---|
customBatch | হ্যাঁ | না |
get | হ্যাঁ | হ্যাঁ |
update | হ্যাঁ | না |
insert | না | হ্যাঁ |
list | হ্যাঁ | না |
getSupportedCarrier | হ্যাঁ | না |
getSupportedHolidays | হ্যাঁ | না |