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

২০১৯ সালের মার্চ মাসে আমরা শপিং-এর জন্য কন্টেন্ট এপিআই-এর সংস্করণ ২.১ প্রকাশ করেছিলাম এবং ২০২১ সালের এপ্রিল মাসে আমরা ঘোষণা করেছিলাম যে, ২০২১ সালের ৩০শে সেপ্টেম্বর সংস্করণ ২-এর কার্যক্রম বন্ধ হয়ে যাবে। সংস্করণ v2-এর কার্যক্রম বন্ধ হয়ে গেছে। অনুগ্রহ করে অবিলম্বে v2.1-এ স্থানান্তরিত হন।

আপনার অ্যাপ্লিকেশনটি স্থানান্তর করুন

v2 থেকে v2.1-এ স্থানান্তরিত হওয়ার জন্য আপনার এন্ডপয়েন্ট URL-গুলো নতুন v2.1 সংস্করণ কল করার জন্য আপডেট করতে হবে এবং 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 পরিষেবা এবং এন্ডপয়েন্ট সম্পর্কে সম্পূর্ণ তথ্যের জন্য, এপিআই রেফারেন্স দেখুন।

প্রয়োজনীয় পরিবর্তন করুন

আপনার এপিআই কলগুলির ইউআরএল আপডেট করার পাশাপাশি, v2.1-এ প্রবর্তিত বেশ কিছু বড় ধরনের পরিবর্তনের জন্য আপনার অ্যাপ্লিকেশনটিও আপডেট করতে হবে। নিম্নলিখিত বিভাগগুলি পর্যালোচনা করুন এবং প্রয়োজন অনুযায়ী আপনার অ্যাপ্লিকেশনটি আপডেট করুন।

১. inventory পরিষেবার সাথে ইন্টিগ্রেশন আপডেট করুন

v2 inventory পরিষেবাটি সরিয়ে ফেলা হয়েছে এবং এর সমতুল্য কার্যকারিতা নিম্নলিখিত v2.1 বৈশিষ্ট্যগুলির সাথে উপলব্ধ:

  • পণ্যের আংশিক আপডেটের জন্য নতুন সাপ্লিমেন্টাল ফিড অথবা products.update ব্যবহার করুন। পণ্যের সমস্ত পরিবর্তনযোগ্য ফিল্ড আপডেট করা সম্ভব, যার মধ্যে inventory.set দিয়ে পূর্বে আপডেট করা সমস্ত ফিল্ডও অন্তর্ভুক্ত ( localinventory এর জন্য নির্দিষ্ট ফিল্ডগুলো ছাড়া)। আরও বিস্তারিত জানতে ‘সাপ্লিমেন্টাল ফিডে মাইগ্রেট করুন’ দেখুন।

  • স্থানীয় পণ্যের আপডেটের জন্য নতুন localinventory পরিষেবাটি ব্যবহার করুন।

২. accounts সার্ভিসে কল আপডেট করুন

  • v2.1-এ accounts.update মেথড কল করলে, অনুরোধে অন্তর্ভুক্ত ফিল্ডগুলো আপডেট করার পরিবর্তে, accounts রিসোর্সটি সম্পূর্ণরূপে ওভাররাইট হয়ে যায়। accounts রিসোর্সের ফিল্ড মুছে যাওয়া এড়াতে, আপনার কল অনুরোধগুলো আপডেট করে সমস্ত ফিল্ড অন্তর্ভুক্ত করুন।

  • reviewsUrl টি সরিয়ে ফেলা হয়েছে।

  • adsLinks , googleMyBusinessLink এবং youtubeChannelLinks এর জন্য 'লিঙ্ক স্ট্যাটাস inactive সরিয়ে ফেলা হয়েছে।

৩. products পরিষেবাতে কল আপডেট করুন

  • কাস্টম অ্যাট্রিবিউটে এখন থেকে আর টাইপ এবং ইউনিট থাকবে না। এর পরিবর্তে, ইউনিটগুলো ভ্যালুর সাথে যুক্ত করা হবে এবং টাইপগুলো স্বয়ংক্রিয়ভাবে শনাক্ত করা হবে।

  • পুনরাবৃত্ত ফিল্ড productTypes productType এবং additionalProductTypes উভয়কেই প্রতিস্থাপন করেছে।

  • পুনরাবৃত্ত ফিল্ড includedDestinations এবং excludedDestinations এখন পুনরাবৃত্ত ফিল্ড destinations প্রতিস্থাপন করেছে।

  • নিম্নলিখিত অ্যাডওয়ার্ডস-সম্পর্কিত ফিল্ডগুলোর নাম পরিবর্তন করা হয়েছে:

    • adwordsGrouping -> adsGrouping
    • adwordsLabels -> adsLabels
    • adwordsRedirect -> adsRedirect

  • নিম্নলিখিত ক্ষেত্রগুলি সরিয়ে দেওয়া হয়েছে:

    • aspects
    • destinations
    • onlineOnly
    • validatedDestinations
    • warnings

  • includeInvalidInsertedItems প্যারামিটারটি সরিয়ে দেওয়া হয়েছে। v2.1-এ, ডিফল্টরূপে সমস্ত পণ্য ফেরত দেওয়া হয়।

  • এখন products.get বা products.list এর মাধ্যমে কোনো পণ্য খুঁজে পেতে কয়েক মিনিটের বিলম্ব হয়।

  • ফেরত আসা offerId যে ইনপুট offerId সমান হবে, তার আর কোনো নিশ্চয়তা নেই। v2.1 সংস্করণে offerId শুরুতে ও শেষে থাকা অতিরিক্ত স্পেস (whitespace) বাদ দেওয়া হয়েছে এবং একাধিক স্পেস অক্ষরকে একটিতে একীভূত করা হয়েছে। এই পরিবর্তনটি প্রস্তাবিত offerId সিনট্যাক্স মেনে চলা offerId ভ্যালুগুলোর উপর কোনো প্রভাব ফেলবে না।

  • এখন পণ্য যোগ করার আগে মূল্য যাচাই করা হয়। ভ্যালু স্ট্রিং-এ শুধুমাত্র নিম্নলিখিত অক্ষরগুলো ব্যবহার করা যাবে: + , - , . , এবং সংখ্যা (যেমন, 0 - 9 )। কমা আর ব্যবহার করা যাবে না।

  • products.insert বা products.update কল থেকে প্রাপ্ত প্রতিক্রিয়াগুলিতে শুধুমাত্র নিম্নলিখিত অ্যাট্রিবিউটগুলি থাকে:

    • channel
    • contentLanguage
    • id
    • offerId
    • feedLabel

  • v2 অপশন includeAttributes এখন আর ব্যবহৃত হয় না। এর পরিবর্তে, পণ্যের সম্পূর্ণ তথ্য দেখতে ProductId সহ products.get ব্যবহার করুন।

৪. productstatuses সার্ভিসে কল আপডেট করুন

  • includeAttributes প্যারামিটারসহ product অ্যাট্রিবিউটটি সরিয়ে ফেলা হয়েছে। কোনো স্ট্যাটাসের সাথে সম্পর্কিত প্রোডাক্টের অ্যাট্রিবিউটগুলো পেতে, products সার্ভিসটি ব্যবহার করুন এবং নতুন productId ফিল্ডের ভ্যালুটি পাস করুন।

  • includeInvalidInsertedItems প্যারামিটারটি সরিয়ে দেওয়া হয়েছে। এখন থেকে পণ্যটি বৈধ কি না, তা নির্বিশেষে প্রতিটি পণ্যের productId ফেরত দেওয়া হয়।

  • destinationStatuses intention , approvalStatus এবং approvalPending ফিল্ডগুলিকে status দ্বারা প্রতিস্থাপন করা হয়েছে, যা একটি স্ট্রিং এবং এর মান approved , disapproved বা pending মধ্যে যেকোনো একটি হতে পারে।

  • dataQualityIssues itemLevelIssues দ্বারা প্রতিস্থাপন করা হয়েছে।

৫. datafeeds পরিষেবাতে কল আপডেট করুন

  • নিম্নলিখিত লক্ষ্য ক্ষেত্রগুলি প্রতিস্থাপন করা হয়েছে:

    • contentLanguage -> language
    • targetCountry -> country
    • intendedDestinations -> includedDestinations এবং excludedDestinations

  • যেসব ডেটা ফিডের contentType = "product inventory update" ছিল, সেগুলো সরিয়ে ফেলা হয়েছে।

৬. orders এবং TestOrders পরিষেবাগুলিতে কল আপডেট করুন

  • v2.1-এ, কলগুলিতে ট্যাক্স ডেটা অন্তর্ভুক্ত করা উচিত নয়, কারণ ট্যাক্স ডেটা স্বয়ংক্রিয়ভাবে গণনা করা হয়। যদি অর্ডারটি মার্কেটপ্লেস ফেয়ারনেস অ্যাক্ট (MFA) বা অনুরূপ আইনযুক্ত কোনো রাজ্যে পূরণ করা হয়, তাহলে ট্যাক্স ডেটা সহ কলগুলি ব্যর্থ হবে। যদি অর্ডারটি MFA-বিহীন কোনো রাজ্যে পূরণ করা হয়, তাহলে মার্চেন্ট সেন্টারে কনফিগার করা সেটিংসের উপর ভিত্তি করে ট্যাক্স গণনা করা হয়। যদি কনফিগার করা না থাকে, তাহলে গণনা করা ট্যাক্সের পরিমাণ ০ হবে।

  • 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 ফিল্ডগুলো সরিয়ে ফেলা হয়েছে।

  • TestOrder পরিষেবা থেকে promotions ফিল্ডটি সরিয়ে দেওয়া হয়েছে এবং Order এর ফরম্যাট পরিবর্তন করা হয়েছে।

৭. orderinvoice পরিষেবাতে কল আপডেট করুন

  • amountPretax এবং amountTax ফিল্ড দুটিকে যথাক্রমে priceAmount এবং taxAmount দ্বারা প্রতিস্থাপন করা হয়েছে। অর্ডারের অবস্থানের উপর নির্ভর করে priceAmount ফিল্ডটি প্রি-ট্যাক্স বা পোস্ট-ট্যাক্স হতে পারে।

  • invoiceSummary এবং প্রমোশন চার্জ সম্পর্কিত ফিল্ডগুলো থেকে ব্যালেন্স (মার্চেন্ট, কাস্টমার, গুগল) মুছে ফেলা হয়েছে।

৮. v2.1-এ অন্তর্ভুক্ত নয় এমন কার্যকারিতা অপসারণ করুন।

v2.1-এ কন্টেন্ট এপিআই থেকে আরও বেশ কিছু ফিচার সরিয়ে দেওয়া হয়েছে। নিচের তালিকাটি পর্যালোচনা করুন এবং প্রয়োজন অনুযায়ী আপনার অ্যাপ্লিকেশনটি আপডেট করুন:

  • XML আর সমর্থিত নয়। JSON-এ পরিবর্তন করার বিষয়ে আরও তথ্যের জন্য, ‘Content API for Shopping’-এ XML সমর্থনের সমাপ্তি দেখুন।

  • dryRun প্যারামিটারটি সরিয়ে দেওয়া হয়েছে। এই পরিবর্তনটি সকল API কলের ক্ষেত্রে প্রযোজ্য।

  • সমস্ত HTTP BATCH মেথড সরিয়ে ফেলা হয়েছে। এর পরিবর্তে customBatch ব্যবহার করুন।

  • নিম্নলিখিত পরিষেবাগুলি থেকে patch পদ্ধতিটি সরিয়ে ফেলা হয়েছে:

    • accounts
    • accounttax
    • datafeeds
    • liasettings
    • shippingsettings

  • orderpayments পরিষেবাটি সরিয়ে দেওয়া হয়েছে।

আপনার মাইগ্রেশন পরীক্ষা করুন

v2.1-এ মাইগ্রেট করার পর আপনার অ্যাপ্লিকেশনগুলিতে করা পরিবর্তনগুলি পরীক্ষা করার বিষয়ে আরও তথ্যের জন্য, “Testing Uses of the Content API for Shopping” দেখুন। আপনার আপডেটগুলি পরীক্ষা করার সময় যদি কোনো সমস্যার সম্মুখীন হন, তাহলে আপনি আমাদের সাথে যোগাযোগ করতে পারেন।

v2.1-এ অতিরিক্ত পরিবর্তনসমূহ

আপডেট-প্রয়োজনীয় পরিবর্তনগুলো ছাড়াও, v2.1 বেশ কিছু নতুন ফিচার এবং নন-ব্রেকিং পরিবর্তনও নিয়ে এসেছে:

  • নতুন পরিষেবা:

    • নতুন localinventory সার্ভিসটি আপনাকে স্থানীয়ভাবে পণ্য আপডেট করার সুযোগ দেয় (v2-এর inventory সার্ভিসের পরিবর্তে)।

    • নতুন orderreturns সার্ভিসটি আপনাকে orders সার্ভিস ব্যবহার না করেই রিটার্ন প্রক্রিয়া করার সুযোগ দিয়ে ‘বাই অন গুগল’ (পূর্বে ‘শপিং অ্যাকশনস’ নামে পরিচিত) পরিচালনা করা আরও সহজ করে তোলে।

  • সাপ্লিমেন্টাল ফিড আপনাকে পণ্যের আংশিক আপডেট করার সুযোগ দেয়।

  • products পরিষেবাতে অতিরিক্ত পরিবর্তন:

    • products.insert অনুরোধগুলি এখন আর মারাত্মক নয় এমন সতর্কতা বা ত্রুটি দেখায় না। এর ফলে, আপনি এখন মার্চেন্ট সেন্টারের ফিড রুল ব্যবহার করে পণ্য যোগ করতে এবং সমস্যা সমাধানের জন্য পরবর্তী আপডেট করতে পারবেন, ঠিক যেমনটি আপনি কন্টেন্ট এপিআই-এর বাইরে পরিচালিত ফিডগুলির ক্ষেত্রে করে থাকেন।

    • পণ্যের নির্বাচিত কিছু ফিল্ড আপডেট করার জন্য products.update যুক্ত করা হয়েছে। এর সম্ভাব্য ব্যবহার সম্পর্কে আরও তথ্যের জন্য গাইডটি দেখুন।

    • নিম্নলিখিত অ্যাট্রিবিউটগুলির অবৈধ মান এখন আর ইনসারশন এরর তৈরি করে না, এবং productstatus সার্ভিস দ্বারা itemLevelIssues এর অংশ হিসাবে ফেরত দেওয়া হয়:

      • ageGroup
      • availability
      • condition
      • energyEfficiencyClass
      • gender
      • maxEnergyEfficiencyClass
      • minEnergyEfficiencyClass
      • sizeSystem
      • sizeType

    • কাস্টম অ্যাট্রিবিউটগুলো এখন রিকার্সিভ, ফলে কাস্টম গ্রুপের আর প্রয়োজন নেই।

    • কাস্টম অ্যাট্রিবিউটগুলিতে এখন মূল value ফিল্ডের পাশাপাশি একটি groupValues ​​ফিল্ডও রয়েছে। এই ফিল্ডগুলোর মধ্যে ঠিক যেকোনো একটি অবশ্যই সেট করতে হবে।