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