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

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

মূল পার্থক্য

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

  • Merchant API ব্যবহার করার জন্য কমপক্ষে একজন API ডেভেলপারের এককালীন নিবন্ধন: আপনার যোগাযোগের বিবরণ প্রদানের জন্য আপনাকে registerGcp পদ্ধতিতে কল করতে হবে (প্রমাণীকরণের জন্য ব্যবহৃত প্রতিটি Google ক্লাউড প্রকল্পের জন্য শুধুমাত্র একবার), যা আপনাকে API ব্যবহার করতে এবং Merchant API সম্পর্কিত আপডেট এবং ঘোষণা পেতে দেয়। এই ধাপটি সম্পন্ন না হওয়া পর্যন্ত আপনি কোনও v1 বা v1alpha API ব্যবহার করতে পারবেন না। নির্দেশাবলীর জন্য, একজন ডেভেলপার হিসেবে নিবন্ধন করুন দেখুন।

  • পণ্যের নাম এনকোডিং : ProductInput.name এবং Product.name ক্ষেত্রগুলি আনপ্যাডেড base64url (RFC 4648 বিভাগ 5) এনকোডিং সমর্থন করে। এই নির্দেশিকাগুলি অনুসরণ করুন:

    • এনকোডিং করার আগে, স্ট্রিংটিকে অবশ্যই contentLanguage~feedLabel~offerId ফর্ম্যাট মেনে চলতে হবে।

    • যদি আপনার পণ্যের নামে Merchant API দ্বারা ব্যবহৃত অক্ষর অথবা URL-সংরক্ষিত অক্ষর থাকে, যেমন: এনকোডিং বাধ্যতামূলক ।

      % . + / : ~ , ( * ! ) & ? = @ # $

    • যদি আপনার পণ্যের নাম contentLanguage~feedLabel~offerId ফর্ম্যাট মেনে চলে এবং Merchant API দ্বারা ব্যবহৃত কোনও অক্ষর বা URL-সংরক্ষিত অক্ষর না থাকে, তাহলে আপনি এনকোডিং ছাড়াই প্লেইন ফর্ম্যাট ব্যবহার করতে পারেন।

    • সামঞ্জস্যপূর্ণ এবং সঠিক পার্সিং নিশ্চিত করার জন্য, আমরা সমস্ত পণ্যের নামের জন্য আনপ্যাডেড base64url এনকোডিং ব্যবহার করার পরামর্শ দিচ্ছি।

  • পণ্য-স্তরের কর তথ্য অপসারণ: taxes এবং taxCategory ।

  • Product.attributes নাম পরিবর্তন করা হয়েছে : Product.attributes ফিল্ডটির নাম পরিবর্তন করে Product.productAttributes করা হয়েছে।

  • পণ্য-স্তরের কর তথ্য অপসারণ: Product.productAttributes অবজেক্ট থেকে taxes এবং taxCategory ক্ষেত্রগুলি সরানো হয়েছে। আরও তথ্যের জন্য কর সম্পর্কিত 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 অপসারণ: RegionalInventory এবং LocalInventory উভয় রিসোর্স থেকে customAttributes ক্ষেত্রটি সরানো হয়েছে।

  • পরিমার্জিত অ্যাকাউন্ট তৈরি: CreateAndConfigureAccountRequest থেকে অপ্রয়োজনীয় users ক্ষেত্রটি সরানো হয়েছে। একটি নতুন অ্যাকাউন্টের সাথে প্রাথমিক ব্যবহারকারীকে সংযুক্ত করতে একক user ক্ষেত্রটি ব্যবহার করুন।

  • কিছু অ্যাট্রিবিউট টাইপ স্ট্রিং থেকে এনামে পরিবর্তন করা হয়েছে: Product এবং Inventory রিসোর্সের মধ্যে কিছু ফিল্ড, যেখানে মানগুলির একটি সংক্ষিপ্ত তালিকা সংজ্ঞায়িত করা হয়েছে, আরও ভালো ডেটা যাচাইকরণের জন্য string টাইপ থেকে enum টাইপে পরিবর্তন করা হয়েছে (উদাহরণস্বরূপ, Product.ProductAttributes.condition ফিল্ডটি এখন একটি enum )।

  • অনলাইন রিটার্ন পলিসি আপডেট পদ্ধতি অপসারণ: v1 এ onlineReturnPolicy.update পদ্ধতিটি সরানো হয়েছে। পরিবর্তে onlineReturnPolicy.create পদ্ধতি ব্যবহার করে একটি অনলাইন রিটার্ন পলিসি তৈরি করুন।

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

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

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

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

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

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

v1beta সম্পর্কে v1 সম্পর্কে বিবরণ
ProductInput.name ProductInput.name Merchant API বা URL-সংরক্ষিত অক্ষর দ্বারা ব্যবহৃত অক্ষর ধারণকারী পণ্যের নামের জন্য Unpadded base64url encoding সমর্থিত এবং বাধ্যতামূলক।
Product.name Product.name Merchant API বা URL-সংরক্ষিত অক্ষর দ্বারা ব্যবহৃত অক্ষর ধারণকারী পণ্যের নামের জন্য Unpadded base64url encoding সমর্থিত এবং বাধ্যতামূলক।
Product.gtin Product.gtins GTIN-এর ক্ষেত্রের নাম পরিবর্তন করা হয়েছে।
Product.taxes সরানো হয়েছে taxes ক্ষেত্রটি সরানো হয়েছে।
Product.taxCategory সরানো হয়েছে taxCategory ক্ষেত্রটি সরানো হয়েছে।
Product.channel সরানো হয়েছে channel ফিল্ডটি সরানো হয়েছে। স্থানীয় ব্যবহারের ক্ষেত্রে legacyLocal ফিল্ডটি ব্যবহার করুন।
Product.attributes Product.productAttributes attributes ফিল্ডটির নাম পরিবর্তন করে productAttributes রাখা হয়েছে।
Product ক্ষেত্রে availability , condition , gender , includedDestinations এবং 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 ক্ষেত্রটি ব্যবহার করুন।

পূর্ববর্তী
Refactor code for concurrent requests
পরবর্তী
Overview