v1beta থেকে v1-এ স্থানান্তর করুন

এই নির্দেশিকা আপনাকে মার্চেন্ট API v1beta থেকে v1 এ স্থানান্তর করতে সাহায্য করে, সাধারণ উপলব্ধতার প্রথম সংস্করণ। v1 সংস্করণে বেশ কিছু আপডেট এবং কিছু পরিবর্তন রয়েছে যার জন্য কোড আপডেটের প্রয়োজন হতে পারে। এই পরিবর্তনগুলি API-কে সহজ করতে এবং আপনার Merchant Center অ্যাকাউন্টের ব্যবস্থাপনা উন্নত করার জন্য ডিজাইন করা হয়েছে।

মূল পার্থক্য

v1beta থেকে v1 তে স্থানান্তরিত করার সময় এখানে সবচেয়ে গুরুত্বপূর্ণ পরিবর্তনগুলি সম্পর্কে সচেতন হতে হবে:

• মার্চেন্ট এপিআই ব্যবহার করার জন্য কমপক্ষে একজন এপিআই ডেভেলপারের এককালীন নিবন্ধন: আপনার যোগাযোগের বিশদ বিবরণ প্রদান করতে আপনাকে registerGcp পদ্ধতিতে কল করতে হবে (প্রতিটি Google ক্লাউড প্রকল্পের জন্য শুধুমাত্র একবার) আপনার যোগাযোগের বিশদ প্রদান করতে, যা আপনাকে API ব্যবহার করতে এবং মার্চেন্ট API সম্পর্কিত আপডেট এবং ঘোষণা পেতে দেয়। এই ধাপটি সম্পূর্ণ না হওয়া পর্যন্ত আপনি কোনো v1 বা v1alpha API ব্যবহার করতে পারবেন না। দিকনির্দেশের জন্য, বিকাশকারী হিসাবে নিবন্ধন দেখুন
• Product.attributes নাম পরিবর্তন করা হয়েছে : Product.attributes ফিল্ডটির নাম পরিবর্তন করে Product.productAttributes করা হয়েছে।
• পণ্য-স্তরের ট্যাক্স তথ্য অপসারণ: taxes এবং taxCategory ক্ষেত্রগুলি Product.productAttributes অবজেক্ট থেকে সরানো হয়েছে। আরও তথ্যের জন্য ট্যাক্স সম্পর্কিত Google Merchant Center সহায়তা নিবন্ধটি দেখুন
• GTIN ক্ষেত্রের পরিবর্তন: Product.productAttributes অবজেক্টের gtin ক্ষেত্রটির নাম পরিবর্তন করে gtins করা হয়েছে যাতে এটি একাধিক মান ধরে রাখতে পারে। OrderTrackingSignals.lineItemDetails অবজেক্টের gtin ক্ষেত্রটি এখন একটি array এবং এর নাম পরিবর্তন করে gtins করা হয়েছে।
• চ্যানেল ক্ষেত্র অপসারণ: channel ক্ষেত্রটি পণ্য, পণ্য ইনপুট এবং ডেটা উত্স থেকে সরানো হয়েছে। একটি নতুন বুলিয়ান ক্ষেত্র, legacyLocal , প্রবর্তন করা হয়েছে স্পষ্টভাবে ফিজিক্যাল স্টোরগুলিতে বিক্রি হওয়া পণ্যগুলিকে নির্দিষ্ট করার জন্য। দ্রষ্টব্য: legacyLocal ক্ষেত্রটি মাইগ্রেশনে সহায়তা করার জন্য একটি সহায়ক ক্ষেত্র এবং শেষ পর্যন্ত একক পণ্য উত্সের মাধ্যমে অনলাইন এবং স্থানীয় বিপণন পদ্ধতিগুলিকে সম্পূর্ণরূপে লক্ষ্য করা গেলে শেষ পর্যন্ত তা অবমূল্যায়ন করা হবে৷ আরও তথ্যের জন্য নিম্নলিখিত বিভাগে টেবিল চেক করুন.
• আঞ্চলিক এবং স্থানীয় ইনভেন্টরি বৈশিষ্ট্যের জন্য নতুন ক্ষেত্র :
  • name , account এবং region ব্যতীত সমস্ত RegionalInventory ক্ষেত্রগুলি এখন regionalInventoryAttributes অ্যাট্রিবিউটস নামে একটি নতুন বস্তুর অধীনে মোড়ানো হয়েছে। উদাহরণস্বরূপ, RegionalInventory.price বৈশিষ্ট্যটি এখন RegionalInventory.regionalInventoryAttributes.price এর অধীনে রয়েছে।
  • name , account এবং storeCode ব্যতীত সমস্ত LocalInventory ক্ষেত্রগুলি এখন localInventoryAttributes অ্যাট্রিবিউটস নামে একটি নতুন বস্তুর অধীনে মোড়ানো হয়েছে। উদাহরণস্বরূপ, LocalInventory.price বৈশিষ্ট্যটি এখন LocalInventory.localInventoryAttributes.price এর অধীনে রয়েছে।
• আঞ্চলিক এবং স্থানীয় ইনভেন্টরি থেকে customAttributes অপসারণ: customAttributes ক্ষেত্রটি RegionalInventory এবং LocalInventory উভয় সংস্থান থেকে সরানো হয়েছে।
• পরিমার্জিত অ্যাকাউন্ট তৈরি: অপ্রয়োজনীয় users ক্ষেত্রটি CreateAndConfigureAccountRequest থেকে সরানো হয়েছে। একটি নতুন অ্যাকাউন্টের সাথে একটি প্রাথমিক ব্যবহারকারীকে সংযুক্ত করতে একক user ক্ষেত্রটি ব্যবহার করুন৷
• নির্দিষ্ট বৈশিষ্ট্যের ধরন স্ট্রিং থেকে enums এ পরিবর্তিত হয়েছে: Product এবং Inventory রিসোর্সের মধ্যে কিছু ক্ষেত্র যেখানে মানগুলির সংক্ষিপ্ত তালিকা সহ string টাইপ থেকে enum টাইপ এ পরিবর্তিত হয়েছে (উদাহরণস্বরূপ, Product.ProductAttributes.condition ক্ষেত্রটি এখন একটি enum )।
• অনলাইন রিটার্ন পলিসি আপডেট পদ্ধতি অপসারণ: onlineReturnPolicy.update পদ্ধতি v1 এ সরানো হয়েছে। পরিবর্তে onlineReturnPolicy.create পদ্ধতি ব্যবহার করে একটি অনলাইন রিটার্ন নীতি তৈরি করুন।

কিভাবে মাইগ্রেট করা যায়

মার্চেন্ট API-এর v1beta সংস্করণটি 28 ফেব্রুয়ারি, 2026-এ সূর্যাস্তের জন্য নির্ধারিত হয়েছে। অবক্ষয় সময়সূচী সম্পর্কে আরও তথ্যের জন্য, মার্চেন্ট API সংস্করণ নির্দেশিকা দেখুন।

• মাইগ্রেট করার ক্ষেত্রে আপনার প্রথম ধাপ হল এককালীন বিকাশকারী নিবন্ধন করা ( একজন বিকাশকারী হিসাবে নিবন্ধন দেখুন)। যেকোনো v1 পদ্ধতি কাজ করার আগে আপনাকে প্রমাণীকরণের জন্য ব্যবহার করা প্রতিটি Google ক্লাউড প্রকল্পের জন্য registerGcp পদ্ধতিতে কল করতে হবে।

• আপনি API-কে যেভাবে কল করেন তা নির্বিশেষে (REST, gRPC সহ বা ক্লায়েন্ট লাইব্রেরি ব্যবহার করে), আপনি ধাপে ধাপে স্থানান্তর করতে পারেন। এর মানে হল যে আপনি একবারে আপনার সম্পূর্ণ ইন্টিগ্রেশন আপডেট না করেই আপনার কোড একটি এপিআই আপডেট এবং স্থানান্তর করতে পারেন (উদাহরণস্বরূপ, v1beta এ Accounts এপিআই রাখার সময় Products APIকে v1 তে সরানো)।

বিস্তারিত ক্ষেত্রের পরিবর্তন

এই টেবিলটি v1beta এবং v1 সংস্করণগুলির মধ্যে পরিবর্তিত ক্ষেত্রগুলির একটি বিশদ তুলনা প্রদান করে৷

v1beta	v1	বর্ণনা
Product.gtin	Product.gtins	GTIN-এর ক্ষেত্রের নাম পরিবর্তন করা হয়েছে।
Product.taxes	সরানো হয়েছে	taxes ফিল্ড মুছে ফেলা হয়েছে
Product.taxCategory	সরানো হয়েছে	taxCategory ক্ষেত্রটি সরানো হয়েছে
Product.channel	সরানো হয়েছে	channel ক্ষেত্র সরানো হয়েছে. স্থানীয় ব্যবহারের ক্ষেত্রে legacyLocal ক্ষেত্র ব্যবহার করুন।
Product.attributes	Product.productAttributes	attributes ক্ষেত্রের নাম পরিবর্তন করে productAttributes করা হয়েছে।
availability , condition , gender , includedDestinations এবং Product ক্ষেত্রে excludedDestinations strings (বা strings array ) হিসাবে উপস্থাপন করা হয়	এই ক্ষেত্রগুলি এখন enums (বা enums এর array )	সংজ্ঞায়িত মানের সংক্ষিপ্ত তালিকা সহ ক্ষেত্রগুলি string টাইপ থেকে enum এ পরিবর্তিত হয়েছে।
price , salePrice , salePriceEffectiveDate এবং RegionalInventory ইনভেন্টরিতে availability	RegionalInventory.regionalInventoryAttributes এ সরানো হয়েছে	এই ক্ষেত্রগুলিকে regionalInventoryAttributes অধীনে সরানো হয়েছে।
RegionalInventory.availability ক্ষেত্র হল একটি string	RegionalInventory.regionalInventoryAttributes.availability এখন একটি enums	প্রাপ্যতা string থেকে enum টাইপ পরিবর্তিত হয়েছে।
price , salePrice , salePriceEffectiveDate , availability , quantity , pickupMethod , pickupSla এবং LocalInventory ইনভেন্টরিতে instoreProductLocation	LocalInventory.localInventoryAttributes এ সরানো হয়েছে	এই ক্ষেত্রগুলিকে localInventoryAttributes অধীনে সরানো হয়েছে।
LocalInventory.availability ক্ষেত্র হল একটি string	LocalInventory.localInventoryAttributes.availability এখন একটি enums	প্রাপ্যতা string থেকে enum টাইপ পরিবর্তিত হয়েছে।
LocalInventory.customAttributes	সরানো হয়েছে	স্থানীয় ইনভেন্টরির জন্য কাস্টম অ্যাট্রিবিউট আর সমর্থিত নয়।
RegionalInventory.customAttributes	সরানো হয়েছে	আঞ্চলিক ইনভেনটরির জন্য কাস্টম অ্যাট্রিবিউট আর সমর্থিত নয়।
ProductInput.channel	সরানো হয়েছে	channel ক্ষেত্র সরানো হয়েছে. স্থানীয় ব্যবহারের ক্ষেত্রে legacyLocal ক্ষেত্র ব্যবহার করুন।
DataSource.channel	সরানো হয়েছে	channel ক্ষেত্র সরানো হয়েছে. স্থানীয় ব্যবহারের ক্ষেত্রে legacyLocal ক্ষেত্র ব্যবহার করুন।
পাওয়া যায় না	ProductInput.legacyLocal	একটি নতুন বুলিয়ান ক্ষেত্র নির্দেশ করে যে একটি পণ্য শুধুমাত্র স্থানীয় বিপণন পদ্ধতি লক্ষ্য করতে পারে। পণ্য সম্পদ আইডিতে "স্থানীয়~" উপসর্গ থাকবে।
পাওয়া যায় না	Product.legacyLocal	একটি নতুন বুলিয়ান ক্ষেত্র নির্দেশ করে যে একটি পণ্য শুধুমাত্র স্থানীয় দোকানে বিক্রি হয় এবং অনলাইন ক্রয়ের জন্য উপলব্ধ নয়।
পাওয়া যায় না	DataSource.legacyLocal	একটি নতুন বুলিয়ান ক্ষেত্র নির্দেশ করে যে একটি ডেটা উৎসে শুধুমাত্র স্থানীয় দোকানে বিক্রি হওয়া পণ্য রয়েছে।
OrderTrackingSignals.LineItemDetails.gtin	OrderTrackingSignals.LineItemDetails.gtins	gtin ক্ষেত্রের নাম পরিবর্তন করে gtins করা হয়েছে এবং এটি এখন স্ট্রিংগুলির একটি অ্যারে (একটি স্ট্রিংয়ের পরিবর্তে)।
CreateAndConfigureAccountRequest.users	সরানো হয়েছে	users ক্ষেত্র সরানো হয়েছে. অ্যাকাউন্টে প্রাথমিক প্রশাসক যোগ করতে user ক্ষেত্রটি ব্যবহার করুন।