Content API v2 থেকে v2.1 এ স্থানান্তর করুন

মার্চ 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.1 offerId এ অগ্রণী এবং পিছনের হোয়াইটস্পেস ছাঁটাই করে এবং একাধিক হোয়াইটস্পেস অক্ষরকে একটিতে মার্জ করে। প্রস্তাবিত 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 ।

  দ্রষ্টব্য: v2.1 এর সাথে, আমরা রিটার্ন পরিচালনা করতে নতুন orderreturns পরিষেবা ব্যবহার করার পরামর্শ দিই।

• 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 ক্ষেত্র রয়েছে। ঠিক একটি ক্ষেত্র সেট করা আবশ্যক.

দ্রষ্টব্য: বিষয়বস্তু API-তে পরিবর্তনের সম্পূর্ণ তালিকার জন্য, রিলিজ নোট দেখুন।