প্রোডাক্ট মাইগ্রেট করুন

Merchant API আপনার প্রোডাক্ট ডেটা ম্যানেজ করার জন্য আরও শক্তিশালী এবং সহজ উপায় নিয়ে এসেছে। প্রধান পরিবর্তন হল প্রোডাক্ট ডেটাকে দুটি আলাদা রিসোর্সে ভাগ করা: আপনার ডেটা জমা দেওয়ার জন্য ProductInput এবং প্রোডাক্ট স্ট্যাটাস ও সমস্যা সহ চূড়ান্ত, প্রসেস করা ভার্সন দেখার জন্য Product। এই নতুন স্ট্রাকচার আরও অনুমানযোগ্য এবং স্বচ্ছ অভিজ্ঞতা প্রদান করে।

এই নির্দেশিকা আপনাকে মূল পার্থক্যগুলি বুঝতে সাহায্য করে যাতে আপনি শপিংয়ের জন্য কন্টেন্ট API থেকে আপনার ইন্টিগ্রেশন মাইগ্রেট করতে পারেন। নতুন ফিচার ব্যবহার করার ব্যাপারে বিস্তারিত নির্দেশিকা পেতে, আপনার প্রোডাক্ট ম্যানেজ করুন দেখুন।

প্রধান পার্থক্য

Content API for Shopping-এর তুলনায় Merchant API-তে প্রোডাক্ট ম্যানেজ করার পদ্ধতিতে সবচেয়ে গুরুত্বপূর্ণ পরিবর্তনগুলি এখানে দেওয়া হল:

  • ইনপুট ও প্রসেস করা ডেটার জন্য ডেডিকেটেড রিসোর্স: Merchant API প্রোডাক্ট ম্যানেজমেন্টকে দুটি রিসোর্সে ভাগ করে। আপনার প্রোডাক্ট ডেটা যোগ, আপডেট ও মুছে দিতে, আপনি ProductInput রিসোর্স ব্যবহার করতে পারবেন। Google আপনার ইনপুট প্রসেস করার পরে, নিয়ম প্রয়োগ করে এবং অতিরিক্ত সোর্স থেকে ডেটা একত্রিত করে, আপনি শুধুমাত্র-পড়ার-জন্য Product রিসোর্স ব্যবহার করে চূড়ান্ত প্রোডাক্ট দেখতে পারবেন।

  • প্রোডাক্টের নামের জন্য এনকোডিং: আপনি ProductInput.name এবং Product.name উভয় ফিল্ডের জন্য আনপ্যাডেড base64url (RFC 4648 বিভাগ 5) এনকোডিং ব্যবহার করতে পারেন। প্রোডাক্টের নামে Merchant API বা URL-এর জন্য সংরক্ষিত অক্ষর থাকলে, এনকোডিং করা বাধ্যতামূলক। যেমন, প্রোডাক্টের নামে নিম্নলিখিত অক্ষরগুলির মধ্যে কোনও একটি থাকলে, আপনাকে অবশ্যই প্রোডাক্টের নাম এনকোড করতে হবে:

    % . + / : ~ , ( * ! ) & ? = @ # $
    
  • ইন্টিগ্রেটেড প্রোডাক্ট স্ট্যাটাস: productstatuses পরিষেবা সরিয়ে দেওয়া হয়েছে। প্রোডাক্ট যাচাইকরণ সংক্রান্ত সমস্যা এবং ডেস্টিনেশন স্ট্যাটাস এখন সরাসরি Product রিসোর্সের productStatus ফিল্ডে অন্তর্ভুক্ত করা হয়েছে, যা ডেটা খুঁজে পাওয়ার প্রসেসকে সহজ করে তোলে।

  • প্রোডাক্টের অনুমানযোগ্য আপডেট: নতুন productInputs.patch পদ্ধতিটি সরাসরি একটি নির্দিষ্ট প্রোডাক্ট ইনপুট পরিবর্তন করে। এটি Content API for Shopping-এর তুলনায় অনেক উন্নত, যেখানে অন্যান্য ফিড আপলোডের মাধ্যমে আপডেটগুলি অপ্রত্যাশিতভাবে ওভাররাইট করা হতে পারে। Merchant API-তে, কোনও আপডেট সেই নির্দিষ্ট প্রোডাক্ট ইনপুট আবার আপডেট বা মুছে না ফেলা পর্যন্ত থেকে যায়। প্রোডাক্ট আপডেট ProductInput রিসোর্সে প্রয়োগ করা হয়েছে, প্রসেস করা Product রিসোর্সে নয়।

  • আরও ভালোভাবে ডেটা ম্যানেজ করার জন্য আপনার ডেটা সোর্স বেছে নিন: সব productInputs রাইট অপারেশনের জন্য এখন একটি dataSource কোয়েরি প্যারামিটার প্রয়োজন, যার ফলে আপনি কোন ডেটা সোর্স পরিবর্তন করছেন তা স্পষ্টভাবে বোঝা যায়। আপনার কাছে ডেটা প্রদানকারী একাধিক সোর্স থাকলে, এটি বিশেষভাবে উপযোগী।

  • নতুন রিসোর্স শনাক্তকারী: প্রোডাক্ট এখন id ফিল্ডের পরিবর্তে RESTful রিসোর্স name দ্বারা শনাক্ত করা হয়। ফর্ম্যাট হল accounts/{account}/products/{product}।

  • কোনও কাস্টম ব্যাচ নেই: custombatch পদ্ধতি আর উপলভ্য নেই। একটি HTTP কলে একাধিক অনুরোধ পাঠাতে আপনি অ্যাসিঙ্ক্রোনাস অনুরোধ বা HTTP ব্যাচিং ব্যবহার করতে পারেন।

দেখুন

মাইগ্রেশনের সময় ডেটা সোর্স সংক্রান্ত নির্দেশিকা

আপনার ডেটা সোর্স মাইগ্রেট করার আগে, আমরা আপনাকে ডেটা সোর্স স্ট্র্যাটেজি বেছে নিতে জোরালো সাজেশন দিই।

সহজে মাইগ্রেশন নিশ্চিত করতে এবং অফার চুরি হওয়ার মতো সমস্যা প্রতিরোধ করতে, এইসব সাজেশন অনুসরণ করুন:

  • আপনার ডেটাবেস ব্যাকফিল করুন: প্রতিটি প্রোডাক্ট অপারেশনের আগে dataSources.list কল করার পরিবর্তে, আমরা আপনাকে আপনার লোকাল ডেটাবেসের এককালীন ব্যাকফিল করার জন্য জোরালো সাজেশন দিচ্ছি। প্রতিটি প্রোডাক্ট রেকর্ডে একটি dataSource নামের ফিল্ড যোগ করুন যাতে আপনি সরাসরি আপনার অনুরোধে সঠিক শনাক্তকারী প্রদান করতে পারেন।

  • যেকোনও লেবেল ও ভাষার জন্য ডেটা সোর্স একত্রিত ও ব্যবহার করা: মার্চেন্ট API-এর মাধ্যমে লেবেল ও ভাষা উল্লেখ না করেই ডেটা সোর্স তৈরি করা সম্ভব এবং তাই যেকোনও ডেটা সোর্স লেবেল ও ভাষার সাথে প্রোডাক্ট যোগ করার অনুমতি দেয়। যেকোনও লেবেল ও ভাষার জন্য একটি ডেটা সোর্স ব্যবহার করার কথা বিবেচনা করুন।

  • আপনার প্রোডাক্ট সুরক্ষিত রাখুন: আপনি ডেটা সোর্স সংক্রান্ত নিয়ম ব্যবহার করলে, products.get কল করুন যাতে কোনও প্রোডাক্ট আপডেট বা মুছে দেওয়ার আগে তার সাথে যুক্ত সঠিক dataSource খুঁজে পেতে পারেন। এটি নিশ্চিত করে যে আপনি সঠিক সোর্স পরিবর্তন করছেন এবং অফার চুরি হওয়া আটকায়।

অনুরোধ

এই বিভাগে Content API for Shopping এবং Merchant API-এর জন্য অনুরোধের ফর্ম্যাট তুলনা করা হয়েছে।

অনুরোধের বিবরণ Content API for Shopping Merchant API
প্রোডাক্ট পান GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId} GET https://merchantapi.googleapis.com/products/v1/accounts/{account}/products/{product}
প্রোডাক্টের তালিকা তৈরি করো GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products GET https://merchantapi.googleapis.com/products/v1/accounts/{account}/products
প্রোডাক্ট যোগ করুন POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products POST https://merchantapi.googleapis.com/products/v1/accounts/{account}/productInputs:insert
প্রোডাক্ট আপডেট করুন PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId} PATCH https://merchantapi.googleapis.com/products/v1/accounts/{account}/productInputs/{productinput}
প্রোডাক্ট মুছে দেওয়া DELETE https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId} DELETE https://merchantapi.googleapis.com/products/v1/accounts/{account}/productInputs/{productinput}
প্রোডাক্টের স্ট্যাটাস পান GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/productstatuses/{productId} GET https://merchantapi.googleapis.com/products/v1/accounts/{account}/products/{product}
প্রোডাক্টের স্ট্যাটাসের তালিকা তৈরি করো GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/productstatuses GET https://merchantapi.googleapis.com/products/v1/accounts/{account}/products
একাধিক অনুরোধ ব্যাচ করা POST https://shoppingcontent.googleapis.com/content/v2.1/products/custombatch অ্যাসিঙ্ক্রোনাস অনুরোধ বা HTTP ব্যাচিং ব্যবহার করুন

আইডেন্টিফায়ার

Merchant API-তে প্রোডাক্ট শনাক্তকারীর ফর্ম্যাট পরিবর্তন করে স্ট্যান্ডার্ড REST রিসোর্স নাম করা হয়েছে।

শনাক্তকারীর বিবরণ Content API for Shopping Merchant API
পন্যের ID কোলন (:) দিয়ে আলাদা করা সেগমেন্ট নিয়ে তৈরি স্ট্রিং।
ফর্ম্যাট: channel:contentLanguage:targetCountry:offerId অথবা channel:contentLanguage:feedLabel:offerId।
উদাহরণ: online:en:US:sku123
একটি REST রিসোর্স name স্ট্রিং।
ফর্ম্যাট: accounts/{account}/products/{product} যেখানে {product} হল contentLanguage~feedLabel~offerId।
উদাহরণ: accounts/12345/products/en~US~sku123।
এনকোডিং: আনপ্যাডেড base64url এনকোডিং সাজেস্ট করা হয় এবং মার্চেন্ট API বা URL-রিজার্ভড অক্ষর ব্যবহার করে এমন প্রোডাক্ট আইডির ক্ষেত্রে বাধ্যতামূলক।

পদ্ধতি

এই সারণীতে Content API for Shopping পদ্ধতি এবং Merchant API-তে তার সমতুল্য পদ্ধতি দেখানো হয়েছে।

Content API for Shopping পদ্ধতি Merchant API পদ্ধতি উপলভ্যতা ও নোট
products.get products.get চূড়ান্ত, প্রসেস করা প্রোডাক্ট ফিরিয়ে আনে।
products.list products.list চূড়ান্ত, প্রসেস করা প্রোডাক্টের তালিকা।
products.insert productInputs.insert প্রোডাক্ট ইনপুট যোগ করে। dataSource থাকতে হবে।
products.update productInputs.patch আচরণ উল্লেখযোগ্যভাবে আলাদা। এটি নির্দিষ্ট প্রোডাক্ট ইনপুট আপডেট করে এবং এটি স্থায়ী।
products.delete productInputs.delete নির্দিষ্ট প্রোডাক্ট ইনপুট মুছে দেয়। dataSource থাকতে হবে।
products.custombatch উপলভ্য নয় অ্যাসিঙ্ক্রোনাস অনুরোধ বা HTTP ব্যাচিং ব্যবহার করুন।
productstatuses.get products.get productstatuses পরিষেবা সরানো হয়েছে। স্ট্যাটাস সংক্রান্ত তথ্য এখন Product রিসোর্সের অংশ।
productstatuses.list products.list productstatuses পরিষেবা সরানো হয়েছে। স্ট্যাটাস সংক্রান্ত তথ্য এখন Product রিসোর্সের অংশ।
productstatuses.custombatch উপলভ্য নয় অ্যাসিঙ্ক্রোনাস অনুরোধ বা HTTP ব্যাচিং ব্যবহার করুন।

বিস্তারিত ফিল্ড পরিবর্তন

এই সারণীতে Merchant API-তে পরিবর্তন করা, যোগ করা বা সরিয়ে দেওয়া গুরুত্বপূর্ণ ফিল্ড হাইলাইট করা হয়েছে।

Content API for Shopping Merchant API বিবরণ
id name প্রোডাক্টের প্রাথমিক শনাক্তকারী এখন REST রিসোর্স name। প্রোডাক্টের নামে Merchant API বা URL-রিজার্ভড অক্ষর থাকলে আনপ্যাডেড base64url এনকোডিং সাজেস্ট করা হয় এবং এটি বাধ্যতামূলক।
টপ-লেভেল প্রোডাক্ট ডেটা স্পেসিফিকেশন অ্যাট্রিবিউট (যেমন, title, price, link) productAttributes অবজেক্ট title, price ও link-এর মতো প্রোডাক্ট অ্যাট্রিবিউট আর টপ-লেভেল ফিল্ড হিসেবে নেই। এগুলি এখন Product এবং ProductInput রিসোর্স দুটিতেই productAttributes অবজেক্টের মধ্যে গ্রুপ করা হয়েছে। এটি আরও পরিচ্ছন্ন ও সুবিন্যস্ত রিসোর্স স্ট্রাকচার প্রদান করে।
targetCountry feedLabel Merchant Center-এর কার্যকারিতার সাথে সামঞ্জস্য রাখতে রিসোর্সের নাম এখন targetCountry-এর পরিবর্তে feedLabel ব্যবহার করে।
feedId dataSource (কোয়েরি প্যারামিটার) dataSource-এর নাম এখন সব productInputs রাইট মেথডের (insert, update, delete) জন্য একটি প্রয়োজনীয় কোয়েরি প্যারামিটার।
channel উপলভ্য নেই। শুধুমাত্র স্থানীয় প্রোডাক্টের জন্য legacy_local ব্যবহার করুন। Merchant API-তে channel ফিল্ডটি আর নেই। Content API for Shopping-এ LOCAL চ্যানেল সহ প্রোডাক্টের পরিবর্তে legacy_local ফিল্ডকে 'সত্য' হিসেবে সেট করতে হবে।
উপলভ্য নয় versionNumber ProductInput-এ একটি নতুন ঐচ্ছিক ফিল্ড যা প্রাথমিক ডেটা সোর্সে আউট-অফ-অর্ডার ইনসার্শন প্রতিরোধ করতে ব্যবহার করা যেতে পারে।
string ধরনের ফিল্ডে নির্দিষ্ট সেট করা ভ্যালু আছে enum ধরনের ফিল্ডে নির্দিষ্ট সেট করা ভ্যালু আছে প্রোডাক্ট অ্যাট্রিবিউটের মধ্যে থাকা ফিল্ডে নির্দিষ্ট সেট করা ভ্যালু (যেমন excluded_destinations, availability) এখন enum ধরনের।
gtin productAttributes.gtins সিঙ্গুলার স্ট্রিং (gtin) থেকে রিপিটেড স্ট্রিংয়ে (gtins) পরিবর্তন করা হয়েছে।
sizes productAttributes.size পুনরাবৃত্ত স্ট্রিং (sizes) থেকে একবচন স্ট্রিংয়ে (size) পরিবর্তন করা হয়েছে।
sizeType, additionalSizeType productAttributes.sizeTypes sizeType এবং additionalSizeType-এর পরিবর্তে রিপিট করা SizeType enum (sizeTypes) ব্যবহার করা হয়েছে যা সর্বাধিক দুটি ভ্যালু গ্রহণ করে (যেমন, ["PETITE", "MATERNITY"])।