মার্চ 2019-এ, আমরা কেনাকাটার জন্য সামগ্রী API-এর 2.1 সংস্করণ প্রকাশ করেছি এবং এপ্রিল 2021-এ, আমরা ঘোষণা করেছি যে v2 30 সেপ্টেম্বর, 2021-এ সূর্যাস্ত হবে। সংস্করণ v2 সূর্যাস্ত হয়েছে। অনুগ্রহ করে অবিলম্বে v2.1 এ স্থানান্তর করুন৷
আপনার আবেদন স্থানান্তর করুন
v2 থেকে v2.1 তে স্থানান্তরিত করার জন্য নতুন v2.1 সংস্করণগুলিকে কল করার জন্য আপনার এন্ডপয়েন্ট URL গুলি আপডেট করা এবং v2.1-এ প্রবর্তিত পরিবর্তনগুলি ভাঙার জন্য অ্যাকাউন্টে আপনার অ্যাপ্লিকেশনগুলিকে সংশোধন করা জড়িত৷
v2.1 এন্ডপয়েন্ট ব্যবহার করতে আপনার API কল আপডেট করুন
v2.1 এ কল করতে, নতুন v2.1 এন্ডপয়েন্ট ব্যবহার করার জন্য আপনার অনুরোধ আপডেট করুন।
উদাহরণস্বরূপ, v2 দিয়ে products.get
পদ্ধতিতে কল করতে, আপনি ব্যবহার করবেন:
GET https://shoppingcontent.googleapis.com/content/v2/merchantId/products/productId
v2.1-এর জন্য, এতে URL আপডেট করুন:
GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products/productId
v2.1 পরিষেবা এবং শেষ পয়েন্টগুলির সম্পূর্ণ তথ্যের জন্য, API রেফারেন্স দেখুন।
প্রয়োজনীয় পরিবর্তন করুন
আপনার API কলগুলির URL আপডেট করার পাশাপাশি, v2.1-এ প্রবর্তিত বেশ কয়েকটি ব্রেকিং পরিবর্তনের জন্য আপনাকে অ্যাকাউন্টে আপনার অ্যাপ্লিকেশন আপডেট করতে হবে। নিম্নলিখিত বিভাগগুলি পর্যালোচনা করুন এবং প্রয়োজন অনুযায়ী আপনার আবেদন আপডেট করুন।
1. inventory
সার্ভিসের সাথে ইন্টিগ্রেশন আপডেট করুন
v2 inventory
পরিষেবা সরানো হয়েছে, এবং নিম্নলিখিত v2.1 বৈশিষ্ট্যগুলির সাথে সমতুল্য কার্যকারিতা উপলব্ধ:
আংশিক পণ্য আপডেটের জন্য নতুন সম্পূরক ফিড বা
products.update
ব্যবহার করুন।inventory.set
এর সাথে পূর্বে আপডেট করা সমস্ত ক্ষেত্র সহ (localinventory
একচেটিয়া ব্যতীত) সমস্ত পরিবর্তনযোগ্য পণ্য ক্ষেত্রের আপডেটগুলি সম্ভব। আরও বিশদ বিবরণের জন্য পরিপূরক ফিডে স্থানান্তর করুন দেখুন।স্থানীয় পণ্য আপডেটের জন্য নতুন
localinventory
পরিষেবা ব্যবহার করুন।
2. accounts
পরিষেবায় কলগুলি আপডেট করুন৷
v2.1-এ
accounts.update
পদ্ধতিতে করা কলগুলি শুধুমাত্র অনুরোধে অন্তর্ভুক্ত ক্ষেত্রগুলিকে আপডেট করার পরিবর্তেaccounts
সংস্থানকে সম্পূর্ণরূপে ওভাররাইট করে।accounts
রিসোর্সে ক্ষেত্রগুলি মুছে ফেলা এড়াতে, সমস্ত ক্ষেত্র অন্তর্ভুক্ত করার জন্য আপনার কল অনুরোধগুলি আপডেট করুন৷reviewsUrl
সরানো হয়েছে।adsLinks
,googleMyBusinessLink
, এবংyoutubeChannelLinks
এর জন্যinactive
লিঙ্কের স্থিতি সরানো হয়েছে।
3. products
পরিষেবায় কল আপডেট করুন
কাস্টম অ্যাট্রিবিউটে আর টাইপ এবং ইউনিট থাকে না। পরিবর্তে, মানগুলির সাথে ইউনিটগুলি যুক্ত করতে হবে এবং প্রকারগুলি স্বয়ংক্রিয়ভাবে সনাক্ত করা উচিত।
পুনরাবৃত্ত ক্ষেত্র
productTypes
productType
এবংadditionalProductTypes
উভয়ই প্রতিস্থাপন করেছে।পুনরাবৃত্ত ক্ষেত্রগুলি
includedDestinations
এবংexcludedDestinations
পুনরাবৃত্ত ক্ষেত্রdestinations
প্রতিস্থাপন করেছে৷নিম্নলিখিত AdWords-সম্পর্কিত ক্ষেত্রগুলির নাম পরিবর্তন করা হয়েছে:
-
adwordsGrouping
->adsGrouping
-
adwordsLabels
->adsLabels
-
adwordsRedirect
->adsRedirect
-
নিম্নলিখিত ক্ষেত্রগুলি সরানো হয়েছে:
-
aspects
-
destinations
-
onlineOnly
-
validatedDestinations
-
warnings
-
includeInvalidInsertedItems
প্যারামিটারটি সরানো হয়েছে। v2.1-এ, সমস্ত পণ্য ডিফল্টরূপে ফেরত দেওয়া হয়।একটি সন্নিবেশিত পণ্য
products.get
বাproducts.list
এর মাধ্যমে পুনরুদ্ধার করার আগে এখন কয়েক মিনিটের বিলম্ব রয়েছে।ফেরত দেওয়া
offerId
আর ইনপুটofferId
এর মতো হওয়ার নিশ্চয়তা নেই৷ v2.1offerId
এ অগ্রণী এবং পিছনের হোয়াইটস্পেস ছাঁটাই করে এবং একাধিক হোয়াইটস্পেস অক্ষরকে একটিতে মার্জ করে। প্রস্তাবিতofferId
সিনট্যাক্সের সাথে সামঞ্জস্যপূর্ণofferId
মানগুলিকে এই পরিবর্তনটি প্রভাবিত করে না।দাম এখন পণ্য সন্নিবেশ আগে যাচাই করা হয়. মান স্ট্রিংটিতে শুধুমাত্র নিম্নলিখিত অক্ষরগুলি অনুমোদিত:
+
,-
,.
, এবং সংখ্যা (অর্থাৎ,0
-9
)। কমা আর গ্রহণ করা হয় না.একটি
products.insert
বাproducts.update
কলের প্রতিক্রিয়াগুলিতে শুধুমাত্র নিম্নলিখিত বৈশিষ্ট্যগুলি থাকে:-
channel
-
contentLanguage
-
id
-
offerId
-
feedLabel
-
v2 বিকল্প
includeAttributes
অবচিত করা হয়েছে। পরিবর্তে, পণ্যের সম্পূর্ণ তথ্য দেখতেProductId
এর সাথেproducts.get
ব্যবহার করুন।
4. productstatuses
পরিষেবাতে কলগুলি আপডেট করুন৷
includeAttributes
প্যারামিটার সহproduct
অ্যাট্রিবিউট সরিয়ে দেওয়া হয়েছে। একটি স্থিতির সাথে সম্পর্কিত পণ্যের বৈশিষ্ট্যগুলি পুনরুদ্ধার করতে,products
পরিষেবা ব্যবহার করুন এবং নতুনproductId
ক্ষেত্রের মান পাস করুন৷includeInvalidInsertedItems
প্যারামিটারটি সরানো হয়েছে। পণ্যটি বৈধ কিনা তা নির্বিশেষে প্রতিটি পণ্যেরproductId
এখন ফেরত দেওয়া হয়।intention
,approvalStatus
, এবংapprovalPending
destinationStatuses
status
দ্বারা প্রতিস্থাপিত করা হয়েছে , যা একটি স্ট্রিং যাapproved
,disapproved
, বাpending
হতে পারে৷dataQualityIssues
itemLevelIssues
দ্বারা প্রতিস্থাপিত হয়েছে।
5. datafeeds
পরিষেবাতে কলগুলি আপডেট করুন৷
নিম্নলিখিত লক্ষ্য ক্ষেত্রগুলি প্রতিস্থাপন করা হয়েছে:
-
contentLanguage
->language
-
targetCountry
->country
-
intendedDestinations
->includedDestinations
, এবংexcludedDestinations
-
contentType = "product inventory update"
সহ ডেটা ফিডগুলি সরানো হয়েছে৷
6. orders
এবং TestOrders
পরিষেবাগুলিতে কলগুলি আপডেট করুন৷
v2.1-এ, কলগুলিতে ট্যাক্স ডেটা অন্তর্ভুক্ত করা উচিত নয় কারণ ট্যাক্স ডেটা স্বয়ংক্রিয়ভাবে গণনা করা হয়। মার্কেটপ্লেস ফেয়ারনেস অ্যাক্ট (MFA) বা অনুরূপ একটি রাজ্যে অর্ডারটি পূরণ করা হলে, ট্যাক্স ডেটা অন্তর্ভুক্ত কলগুলি ব্যর্থ হয়। যদি একটি নন-MFA অবস্থায় অর্ডারটি পূরণ করা হয়, তাহলে Merchant Center-এ কনফিগার করা সেটিংসের ভিত্তিতে ট্যাক্স গণনা করা হয়। কনফিগার করা না থাকলে, গণনা করা ট্যাক্স হল 0।
InStoreRefundLineItem
এবংReturnRefundLineItem
ক্ষেত্রগুলি যথাক্রমেamountPretax
এবংamountTax
priceAmount
প্রতিস্থাপিত হয়েছেtaxAmount
অর্ডারের অবস্থানের উপর নির্ভর করেpriceAmount
প্রি-ট্যাক্স বা ট্যাক্স-পরবর্তী হতে পারে।অনুরোধে
ShipLineItem
ফিল্ডcarrier
,shipmentId
এবংtrackingId
shipmentInfos
সরানো হয়েছে।billingAddress
এবংpredefinedBillingAddress
এখন যথাক্রমেorders
এবংTestOrder
এ শীর্ষ-স্তরের ক্ষেত্র।customer.explicitMarketingPreference
customer.marketingRightsInfo
দ্বারা প্রতিস্থাপিত করা হয়েছে।netAmount
ক্ষেত্রটিকেnetPriceAmount
এবংnetTaxAmount
এ বিভক্ত করা হয়েছে।shippingOption
lineItems[].shippingDetails
দ্বারা প্রতিস্থাপিত হয়েছে।CancelLineItem
ক্ষেত্রগুলিরamount
,amountPretax
, এবংamountTax
অনুরোধে সরিয়ে দেওয়া হয়েছে৷ ফেরত দেওয়া পরিমাণ এখন স্বয়ংক্রিয়ভাবে গণনা করা হয়।CustomBatch
সরানো হয়েছে।Refund
সরানো হয়েছে. পরিবর্তেrefundOrder
বাrefundItem
ব্যবহার করুন।paymentMethod
ক্ষেত্রটি সরানো হয়েছে।v2 পদ্ধতি
orders.returnlineitem
এবংorders.refund
পরিবর্তেorderreturns.creatOrderReturn
এবংorderreturns.process
।customer.email
,channelType
, এবংlineItem.product.channel
ক্ষেত্রগুলি সরানো হয়েছে৷promotions
ক্ষেত্রটিTestOrder
পরিষেবা থেকে সরানো হয়েছে এবং এর বিন্যাসটিOrder
পরিবর্তিত হয়েছে।
7. orderinvoice
পরিষেবাতে কলগুলি আপডেট করুন৷
amountPretax
এবংamountTax
ক্ষেত্রগুলি যথাক্রমেpriceAmount
এবংtaxAmount
দ্বারা প্রতিস্থাপিত হয়েছে৷ অর্ডারের অবস্থানের উপর নির্ভর করেpriceAmount
ক্ষেত্রটি প্রি-ট্যাক্স বা ট্যাক্স-পরবর্তী হতে পারে।invoiceSummary
এবং প্রচার চার্জ সম্পর্কিত ক্ষেত্রগুলিতে ব্যালেন্স (বণিক, গ্রাহক, Google) সরানো হয়েছে।
8. v2.1-এ অন্তর্ভুক্ত নয় এমন কার্যকারিতা সরান
v2.1-এ Content API থেকে আরও বেশ কিছু বৈশিষ্ট্য মুছে ফেলা হয়েছে। নিম্নলিখিত তালিকা পর্যালোচনা করুন এবং প্রয়োজন অনুযায়ী আপনার আবেদন আপডেট করুন:
XML আর সমর্থিত নয়। JSON-এ স্যুইচ করার বিষয়ে আরও তথ্যের জন্য, কেনাকাটার জন্য সামগ্রী API-তে XML সমর্থনের সানসেট দেখুন।
dryRun
প্যারামিটার সরানো হয়েছে। এই পরিবর্তনটি সমস্ত API কলের ক্ষেত্রে প্রযোজ্য।সমস্ত
HTTP BATCH
পদ্ধতি সরানো হয়েছে। পরিবর্তেcustomBatch
ব্যবহার করুন।patch
পদ্ধতিটি নিম্নলিখিত পরিষেবাগুলি থেকে সরানো হয়েছে:-
accounts
-
accounttax
-
datafeeds
-
liasettings
-
shippingsettings
-
orderpayments
পরিষেবা সরানো হয়েছে.
আপনার মাইগ্রেশন পরীক্ষা করুন
v2.1-এ স্থানান্তরিত করার পরে আপনার অ্যাপ্লিকেশনগুলির পরিবর্তনগুলি পরীক্ষা করার বিষয়ে আরও তথ্যের জন্য, কেনাকাটার জন্য সামগ্রী API-এর পরীক্ষামূলক ব্যবহারগুলি দেখুন৷ আপনার আপডেটগুলি পরীক্ষা করার সময় আপনি যদি সমস্যার সম্মুখীন হন, আপনি বিষয়বস্তু API ফোরামে আপনার সমস্যা পোস্ট করতে পারেন।
v2.1-এ অতিরিক্ত পরিবর্তন
এছাড়াও পরিবর্তনগুলির জন্য আপডেটের প্রয়োজন, v2.1 এছাড়াও বেশ কয়েকটি নতুন বৈশিষ্ট্য এবং অ-ব্রেকিং পরিবর্তনগুলি প্রবর্তন করে:
নতুন পরিষেবা:
নতুন
localinventory
পরিষেবা আপনাকে স্থানীয় পণ্য আপডেট করতে দেয় (v2 তেinventory
পরিষেবার জায়গায়)।নতুন
orderreturns
পরিষেবা আপনাকেorders
পরিষেবা ব্যবহার না করেই ফেরত প্রসেস করার অনুমতি দিয়ে Buy on Google (পূর্বে শপিং অ্যাকশন নামে পরিচিত) পরিচালনা করা সহজ করে তোলে।
সম্পূরক ফিড আপনাকে আংশিক পণ্য আপডেট করতে দেয়।
products
পরিষেবায় অতিরিক্ত পরিবর্তন:products.insert
অনুরোধগুলি আর অ-মারাত্মক সতর্কতা বা ত্রুটির প্রতিবেদন করে না। এটি আপনাকে পণ্যগুলিকে সন্নিবেশ করতে এবং বণিক কেন্দ্রে ফিড নিয়মের মাধ্যমে সমস্যাগুলি সমাধান করার জন্য পরবর্তী আপডেটগুলি করতে দেয়, ঠিক যেমন আপনি সামগ্রী API এর বাইরে পরিচালিত ফিডগুলির সাথে করেন৷পণ্য ক্ষেত্রের একটি নির্বাচিত সেটে আপনাকে আপডেট করতে দিতে
products.update
যোগ করা হয়েছে। সম্ভাব্য ব্যবহার সম্পর্কে আরও তথ্যের জন্য গাইডটি দেখুন।নিম্নলিখিত বৈশিষ্ট্যগুলির জন্য অবৈধ মানগুলি আর সন্নিবেশ ত্রুটিগুলিকে ট্রিগার করে না এবং
productstatus
পরিষেবা দ্বারাitemLevelIssues
অংশ হিসাবে ফিরে আসে:-
ageGroup
-
availability
-
condition
-
energyEfficiencyClass
-
gender
-
maxEnergyEfficiencyClass
-
minEnergyEfficiencyClass
-
sizeSystem
-
sizeType
-
কাস্টম বৈশিষ্ট্যগুলি এখন পুনরাবৃত্ত, যা কাস্টম গ্রুপের প্রয়োজনীয়তাকে সরিয়ে দেয়।
কাস্টম বৈশিষ্ট্যগুলিতে এখন মূল
value
ক্ষেত্র ছাড়াও একটিgroupValues
ক্ষেত্র রয়েছে। ঠিক একটি ক্ষেত্র সেট করা আবশ্যক.