আপনি ফাইল-ভিত্তিক ফিড, Merchant API বা দুটিরই কম্বিনেশন ব্যবহার করে Merchant Center-এ প্রোডাক্ট ডেটা আপলোড করতে পারেন:
- ফাইল-ভিত্তিক প্রোডাক্ট ফিড: SFTP, Google Cloud Storage, Google Sheets বা শিডিউল করা ফেচ ব্যবহার করে CSV, TSV বা XML ফাইল আপলোড করুন।
- Merchant API: প্রোডাক্ট ডেটা পরিবর্তন হওয়ার সাথে সাথে ইনক্রিমেন্টাল আপডেটের জন্য আপনার ব্যাকএন্ড থেকে সরাসরি প্রোগ্রাম্যাটিক অনুরোধ পাঠান, এর পাশাপাশি পর্যায়ক্রমিক সম্পূর্ণ ক্যাটালগ সিঙ্ক করুন।
এই নির্দেশিকা দুটি পদ্ধতিই তুলনা করে, কখন একটির পরিবর্তে অন্যটি (বা দুটি একসাথে) ব্যবহার করতে হবে তা ব্যাখ্যা করে এবং আপনি যদি আপনার কিছু বা সমস্ত প্রোডাক্ট ফাইল ফিড থেকে API-তে সরানোর সিদ্ধান্ত নেন, তাহলে একটি ধাপে ধাপে মাইগ্রেশন প্লেবুক প্রদান করে।
আপনার ডেটা সোর্স অ্যাপ্রোচ বেছে নিন
মার্চেন্ট API, ফাইল ফিড বা হাইব্রিড সেট-আপ ব্যবহার করবেন কিনা তা সিদ্ধান্ত নিতে আপনার ক্যাটালগের পরিবর্তনশীলতা, ব্যাকএন্ড আর্কিটেকচার এবং অপারেশনাল ওয়ার্কফ্লো মূল্যায়ন করুন।
Merchant API কখন ব্যবহার করতে হয়
API প্রাইমারি ডেটা সোর্স ব্যবহার করুন যদি:
- সরাসরি প্রোগ্র্যামাটিক ইন্টিগ্রেশন: আপনি ফাইল তৈরি করা এবং ফাইল ট্রান্সফার পাইপলাইন (যেমন SFTP বা Google Cloud Storage) ম্যানেজ করার পরিবর্তে আপনার ব্যাকএন্ড থেকে সরাসরি API কল করতে পছন্দ করেন।
- দাম ও ইনভেনটরির ঘন ঘন পরিবর্তন: আপনার প্রোডাক্টের দাম বা স্টক লেভেল সারাদিন ধরে ঘন ঘন পরিবর্তিত হয়।
- ডেটা পরিবর্তন হলে সাথে সাথে আপডেট করা: আপনি চান যে আপনার ব্যাকএন্ডে প্রোডাক্টের ডেটা পরিবর্তন হওয়ার সাথে সাথেই Google-এর কাছে সেই তথ্য পৌঁছে যাক, যাতে পরবর্তী শিডিউল করা ফাইল জেনারেশন ও আপলোডের জন্য অপেক্ষা করতে না হয়।
- ইনক্রিমেন্টাল ক্যাটালগ আপডেট: আপনি প্রতিবার সম্পূর্ণ ক্যাটালগ আবার আপলোড না করে, পরিবর্তন হওয়ার সাথে সাথে আলাদা আলাদা প্রোডাক্ট যোগ, আপডেট বা মুছে ফেলতে চান।
- আংশিক অ্যাট্রিবিউট আপডেট: আপনি সম্পূর্ণ প্রোডাক্ট পেলোড আবার না পাঠিয়েই
প্রোডাক্টের নির্দিষ্ট ফিল্ড (যেমন
productInputs.patchব্যবহার করেpriceবাavailability) আপডেট করতে চান।
ফাইল ফিড কখন ব্যবহার করতে হয়
ফাইল-ভিত্তিক প্রাথমিক ডেটা সোর্স ব্যবহার করুন যদি:
- স্ট্যাটিক ক্যাটালগ: আপনার প্রোডাক্ট ডেটা ঘন ঘন পরিবর্তন হয় না (যেমন, দিনে একবার বা তার কম)।
- ডেল্টা ট্র্যাকিং ছাড়া শুধুমাত্র স্ন্যাপশট ব্যাকএন্ড: আপনার ব্যাকএন্ড শুধুমাত্র সম্পূর্ণ ক্যাটালগ স্ন্যাপশট এক্সপোর্ট করে এবং আইটেম-লেভেল পরিবর্তন বা নির্দিষ্ট প্রোডাক্ট মুছে ফেলা ট্র্যাক করতে পারে না।
- স্প্রেডশিট-ভিত্তিক ওয়ার্কফ্লো: নন-ইঞ্জিনিয়ারিং টিম সরাসরি Google Sheets বা CSV ফাইলে প্রোডাক্ট ডেটা কিউরেট বা ওভাররাইড করে।
- কম-রক্ষণাবেক্ষণ অপারেশন: আপনি শিডিউল করা ফাইল এক্সপোর্ট পছন্দ করেন যেখানে Merchant Center ফেচিং এবং স্ন্যাপশট প্রসেসিং ম্যানেজ করে, অনুরোধ পেসিং, আবার চেষ্টা করা ম্যানেজ করা এবং পর্যায়ক্রমিক সম্পূর্ণ-ক্যাটালগ সিঙ্ক সহ API ইন্টিগ্রেশন অপারেট করার পরিবর্তে।
দুটিই কখন ব্যবহার করবেন
আপনি নিম্নলিখিত পরিস্থিতিতে একই Merchant Center অ্যাকাউন্টে ফাইল ফিড এবং Merchant API একত্রিত করতে পারেন:
- বিভক্ত প্রোডাক্ট ক্যাটালগ: আপনি দ্রুত পরিবর্তনশীল প্রোডাক্টের (যেমন, ফ্ল্যাশ সেল বা হাই-টার্নওভার ইনভেনটরি) জন্য Merchant API এবং স্ট্যাটিক ক্যাটালগ সেগমেন্ট বা আলাদা প্রোডাক্ট লাইনের জন্য ফাইল ফিড ব্যবহার করেন। নিশ্চিত করুন যে প্রতিটি প্রোডাক্ট শুধুমাত্র একটি প্রাথমিক ডেটা সোর্স দ্বারা আপলোড করা হয়েছে (সমান্তরাল ব্যবহার এবং প্রাথমিক ডেটা সোর্সের মালিকানা দেখুন)।
- ফাইল-ভিত্তিক সাপ্লিমেন্টাল ফিড সহ API প্রাইমারি ডেটা: আপনি API প্রাইমারি ডেটা সোর্সের মাধ্যমে মূল প্রোডাক্ট ডেটা ম্যানেজ করেন, যেখানে নন-ইঞ্জিনিয়ারিং টিম বা থার্ড-পার্টি পার্টনাররা অ্যাট্রিবিউট নিয়মের সাথে যুক্ত ফাইল-ভিত্তিক সাপ্লিমেন্টাল ফিডের (যেমন Google Sheets বা CSV ফাইল) মাধ্যমে অতিরিক্ত অ্যাট্রিবিউট প্রদান করে অথবা এর উল্টোটা করে।
- আংশিক বা পর্যায়ক্রমে মাইগ্রেশন: আপনি নির্দিষ্ট মার্কেট, বিভাগ বা সাব-অ্যাকাউন্ট API-তে ট্রান্সফার করেন এবং আপনার ক্যাটালগের বাকি অংশ ফাইল ফিডে রাখেন।
আপনি যদি ফাইল ফিড থেকে কিছু বা সব প্রোডাক্ট Merchant API-তে সরানোর সিদ্ধান্ত নেন, তাহলে ধাপে ধাপে মাইগ্রেশন প্লেবুক অনুসরণ করুন।
স্থাপত্যশৈলীর প্রধান পার্থক্য
ফাইল ফিড এবং পুশ-ভিত্তিক Merchant API-এর মধ্যে পার্থক্য হল, Google কীভাবে প্রোডাক্ট ডেটা প্রসেস এবং ম্যানেজ করে:
| ধারণা | ফাইল ফিড | Merchant API |
|---|---|---|
| ইন্টিগ্রেশন মডেল | অফলাইন ফাইল ডাম্প: আপনি নিজের ক্যাটালগ একটি ফাইলে এক্সপোর্ট করেন এবং SFTP, Google Cloud Storage, Google Sheets বা শিডিউল করা ফেচ ব্যবহার করে এটি ট্রান্সফার করেন। | সরাসরি প্রোগ্রাম্যাটিক ইন্টিগ্রেশন: আপনার ব্যাকএন্ড সরাসরি API এন্ডপয়েন্টে অনুরোধ পাঠায়। |
| মিউটেশন গ্রানুলারিটি | বাল্ক প্রসেসিং: একটি আইটেম পরিবর্তন করতে সাধারণত পুরো ফাইলটি আবার প্রসেস করতে হয়। | গ্র্যানুলার ট্রানজ্যাকশন: আপনি শুধুমাত্র পরিবর্তিত প্রোডাক্ট যোগ, প্যাচ বা মুছে ফেলতে পারবেন। |
| সিঙ্ক্রোনাইজেশনের সময় | ব্যাচ সিঙ্ক করা: পরবর্তী শিডিউল করা ফাইল এক্সপোর্ট ও ট্রান্সফার সাইকেল না হওয়া পর্যন্ত পরিবর্তনগুলি আপনার ব্যাকএন্ডে অপেক্ষা করে। | অবিলম্বে বা শিডিউল করা কল: আপনি ইনক্রিমেন্টাল পরিবর্তন হওয়ার সাথে সাথে তা পাঠাতে পারেন, এর পাশাপাশি নির্দিষ্ট সময় অন্তর সম্পূর্ণ সিঙ্ক করতে পারেন। |
| মুছে দেওয়ার আচরণ | ইমপ্লিসিট (স্ন্যাপশট): প্রতিটি ফাইল হল একটি সম্পূর্ণ স্ন্যাপশট; আপনার প্রাথমিক ফাইল থেকে একটি সারি সরিয়ে দিলে প্রোডাক্টটি মুছে যায়। | এক্সপ্লিসিট: স্ন্যাপশটের কোনও ধারণা নেই; বন্ধ হয়ে যাওয়া প্রোডাক্ট সরাতে productInputs.delete কল করুন। |
| রিসোর্স রিপ্রেজেন্টেশন | সিঙ্গেল স্টেট: আপনার ফাইলের সারিগুলি কাঁচা ইনপুটকে উপস্থাপন করে। | 'র' ও প্রসেস করা ডেটা আলাদা করা: API ডেটাকে ProductInput (আপনার 'র' ইনপুট) ও Product (চূড়ান্ত প্রসেস করা অবস্থা) হিসেবে ভাগ করে। |
| অ্যাট্রিবিউট (ফিড) সংক্রান্ত নিয়ম | Merchant Center UI-তে র ফাইল কলামে প্রয়োগ করা হয়েছে। | Merchant Center UI-তে কাজ করে। API ডেটা 3P সাপ্লিমেন্টাল ফাইলের সাথে মার্জ করার সময় প্রয়োজন; আপনার ব্যাকএন্ডে ম্যানেজ করা হলে, সিঙ্গেল-সোর্স ট্রান্সফর্মেশনের জন্য ঐচ্ছিক। |
সমান্তরাল ব্যবহার এবং প্রাথমিক ডেটা সোর্সের মালিকানা ("শেষ আপডেটটিই কার্যকর হবে")
আপনি একই Merchant Center অ্যাকাউন্টে ফাইল ফিড এবং API দুটিই ব্যবহার করতে পারলেও, আমরা কোনও নির্দিষ্ট প্রোডাক্ট যোগ করার জন্য শুধুমাত্র একটি পদ্ধতি ব্যবহার করার জন্য জোরালোভাবে সাজেস্ট করি।
Merchant Center "শেষ আপডেটই কার্যকর হয়" মডেলে কাজ করে। যে প্রাইমারি ডেটা সোর্স (API বা ফাইল ফিড) সবচেয়ে সাম্প্রতিক প্রোডাক্ট ইনসার্ট পুশ করেছে, সেটি সেই প্রোডাক্টের ডেটার প্রাইমারি মালিকানা পায়:
- ফাইল ডেটা সোর্স প্রোডাক্টের মালিক হলে: পরবর্তী ফাইল আপলোড থেকে প্রোডাক্ট বাদ দিলে তা অন্তর্নিহিত মুছে ফেলার ট্রিগার করে, যার ফলে Merchant Center থেকে প্রোডাক্ট মুছে যায়।
- API ডেটা সোর্স প্রোডাক্টের মালিক হলে: ফাইল আপলোড থেকে প্রোডাক্ট বাদ দিলে কোনও প্রভাব পড়ে না, কারণ ফাইল ফিড আর প্রোডাক্টের মালিক থাকে না।
এটি সরাতে আপনাকে অবশ্যই
accounts.productInputs.delete-এ কল করতে হবে। - অনিচ্ছাকৃতভাবে মালিকানা ফিরে পাওয়ার ঝুঁকি: API পুশের পরে যদি কোনও আপডেট করা ফাইল ফিড রান করে এবং তাতে প্রোডাক্ট থাকে, তাহলে ফাইল ডেটা সোর্স মালিকানা ফিরে পায়। ফাইল থেকে পরবর্তী বাদ দেওয়ার ফলে প্রোডাক্টটি অপ্রত্যাশিতভাবে মুছে যাবে।
অপ্রত্যাশিতভাবে মুছে যাওয়া বা API আপডেট হারিয়ে যাওয়া এড়াতে, API এবং ফাইল প্রাইমারি ডেটা সোর্স, উভয় ব্যবহার করে একই প্রোডাক্টে একসাথে আপডেট করবেন না।
API সংক্রান্ত গুরুত্বপূর্ণ বিষয়
আপনার ইমপ্লিমেন্টেশন শুরু করার আগে Merchant API-এর এই গুরুত্বপূর্ণ আচরণগুলি বুঝে নিন:
ফ্লেক্সিবল ডেটা সোর্স (ভাষা বা লেবেল ছাড়া)
ফাইল ফিডের ক্ষেত্রে আপনাকে আগে থেকেই নির্দিষ্ট টার্গেট ফিড লেবেল ও ভাষা উল্লেখ করতে হয়, কিন্তু মার্চেন্ট API-এর ক্ষেত্রে feedLabel বা contentLanguage উল্লেখ না করেই আপনি প্রাথমিক ডেটা সোর্স তৈরি করতে পারবেন।
- ফ্লেক্সিবল আপলোড: এর মাধ্যমে আপনি যেকোনও ভাষা বা ফিড লেবেল কম্বিনেশন সহ প্রোডাক্ট একটি ডেটা সোর্সে আপলোড করতে পারবেন।
- সহজ ম্যানেজমেন্ট: প্রতিটি টার্গেট মার্কেটের জন্য আপনাকে আলাদা ডেটা সোর্স তৈরি ও ম্যানেজ করতে হবে না। মনে রাখবেন: ডেটা সোর্স স্ট্র্যাটেজি বেছে নেওয়ার ব্যাপারে আরও জানতে, ডেটা সোর্স স্ট্র্যাটেজি বেছে নিন বিকল্প দেখুন।
সিঙ্ক্রোনাইজেশন স্ট্র্যাটেজি ও কোটা
ফাইল ফিডের মতো নয় যেখানে আপনি একটি ব্যাচে আপনার সম্পূর্ণ ক্যাটালগ আপলোড করেন, ইনক্রিমেন্টাল আপডেট এবং পেসড সম্পূর্ণ সিঙ্ক, দুটিরই আশেপাশে আপনার Merchant API ইন্টিগ্রেশন ডিজাইন করুন:
- পর্যায়ক্রমিক সম্পূর্ণ সিঙ্কের সাথে ইনক্রিমেন্টাল আপডেট একত্রিত করুন: আপনার ব্যাকএন্ডে প্রোডাক্ট অ্যাট্রিবিউট পরিবর্তন হওয়ার সাথে সাথে
productInputs.insertবাproductInputs.patchঅনুরোধ পাঠান। কারণ, শুধুমাত্র ইনক্রিমেন্টাল আপডেটের উপর নির্ভর করলে, সময়ের সাথে সাথে আপনার ডেটা সিঙ্ক থেকে সরে যেতে পারে। তাই, আপনার সোর্স অফ ট্রুথের সাথে ক্যাটালগ রিকনসাইল করতে, পর্যায়ক্রমিক সম্পূর্ণ সিঙ্কও চালান (এটি ৩০ দিনের প্রোডাক্টের মেয়াদ শেষ হওয়ার তারিখও রিফ্রেশ করে)। আপনি কত ঘনঘন সম্পূর্ণ সিঙ্ক করবেন তা আপনার ক্যাটালগের সাইজ এবং উপলভ্য API কোটার উপর নির্ভর করে। - API কোটা মেনে চলার জন্য অনুরোধের গতি নিয়ন্ত্রণ করুন: আপনার সব প্রোডাক্টের জন্য একসাথে API কল করবেন না। ইনক্রিমেন্টাল পরিবর্তনগুলি হওয়ার সাথে সাথে পাঠানো যেতে পারে, আপনার প্রতি-মিনিট এবং দৈনিক মেথড কল কোটার মধ্যে থাকার জন্য সারাদিন ধরে সম্পূর্ণ সিঙ্ক অনুরোধগুলি সমানভাবে ছড়িয়ে দিন। বিস্তারিত জানতে, কোটা ও সীমা এবং আপনার প্রোডাক্টে ঘনঘন আপডেট করুন দেখুন।
আপনার ইন্টিগ্রেশন পরীক্ষা করা হচ্ছে
প্রোডাকশনে যাওয়ার আগে নিরাপদ পরিবেশে আপনার ইন্টিগ্রেশন লজিক যাচাই করুন।
টেস্ট অ্যাকাউন্ট ব্যবহার করা
প্রোডাকশনে পরিবর্তন করার আগে, আমরা মাইগ্রেশনের প্রাথমিক ধাপগুলি একটি স্যান্ডবক্সড টেস্ট অ্যাকাউন্টে সম্পাদন করার সাজেশন দিই:
- টেস্ট অ্যাকাউন্ট তৈরি করুন: লাইভ বিজ্ঞাপন বা ফ্রি লিস্টিংয়ে কোনও প্রভাব না ফেলে নিরাপদে পরীক্ষা করার জন্য একটি আলাদা টেস্ট অ্যাকাউন্ট সেট-আপ করুন।
- API ডেটা সোর্স তৈরি করুন: আপনার API প্রাইমারি ডেটা সোর্স তৈরি করার প্র্যাকটিস করুন।
- অ্যাট্রিবিউট সংক্রান্ত নিয়ম পরীক্ষা করা: ডেটা ট্রান্সফর্মেশন ও সাপ্লিমেন্টাল ফিড যাচাই করা।
- পে-লোড ও প্রোডাক্ট কী যাচাই করা: SKU কেসিং, এনকোডিং ও সমস্যা ম্যানেজ করার বিষয়টি যাচাই করতে স্যাম্পেল প্রোডাক্ট পুশ করুন।
বিস্তারিত জানতে, ধাপ ১: টেস্ট অ্যাকাউন্ট তৈরি করুন এবং টেস্ট অ্যাকাউন্ট গাইড দেখুন।
প্রোডাক্ট কী অ্যালাইনমেন্ট যাচাই করুন
আপনার প্রোগ্রাম্যাটিক পেলোড প্রোডাক্ট কী আপনার ফাইল ফিড SKU-এর সাথে হুবহু মিলছে কিনা তা নিশ্চিত করুন। Google এগুলি একত্রিত করে প্রোডাক্ট শনাক্ত করে:
offerId(ফাইল ফিডেidবলা হয়, ছোট ও বড় হাতের অক্ষরের মধ্যে পার্থক্য করা হয়)contentLanguage(যেমনen)feedLabel(যেমনUS)
বিশেষ অক্ষর এবং এনকোডিং
আপনার প্রোডাক্ট শনাক্তকারীতে /, % বা ~-এর মতো অক্ষর থাকলে, আপনার API কলে
এনকোড করা ফর্ম্যাট (আনপ্যাডেড base64url এনকোডিং) ব্যবহার করুন। আরও তথ্যের জন্য,
ProductInput.name
দেখুন
কনকারেন্সি কন্ট্রোল
রিয়েল-টাইম ইন্টিগ্রেশনে, নেটওয়ার্ক লেটেন্সির কারণে আপডেট
আউট অফ অর্ডার হিসেবে আসতে পারে। পুরনো আপডেট যাতে নতুন ডেটা ওভাররাইট না করে, তার জন্য ProductInput রিসোর্সে
versionNumber
ফিল্ড ব্যবহার করুন।
ধাপে-ধাপে মাইগ্রেশন প্লেবুক
আপনি যদি ফাইল ফিড থেকে আপনার কিছু বা সব প্রোডাক্ট Merchant API-তে সরানোর সিদ্ধান্ত নেন, তাহলে ইম্প্রেশন বা পরিষেবার ইতিহাস না হারিয়ে আপনার প্রোডাক্টগুলি ট্রানজিশন করতে এই প্লেবুক অনুসরণ করুন।
১. টেস্ট অ্যাকাউন্টে মাইগ্রেশনের রিহার্সাল করুন
প্রোডাকশনে পরিবর্তন করার আগে,
accounts.createTestAccount পদ্ধতি ব্যবহার করে একটি স্যান্ডবক্স করা টেস্ট অ্যাকাউন্ট তৈরি করুন (
টেস্ট অ্যাকাউন্ট নির্দেশিকা দেখুন)। টেস্ট
অ্যাকাউন্ট একটি আইসোলেটেড এনভায়রনমেন্ট প্রদান করে যেখানে অফার ডিফল্ট হিসেবে অনুমোদিত হয়,
ডোমেন যাচাইকরণের প্রয়োজন হয় না এবং ডেটা কখনও সর্বজনীনভাবে দেখানো হয় না।
আপনার প্রোডাকশন সেট-আপের মিরর করতে এবং মাইগ্রেশন এন্ড-টু-এন্ড রিহার্সাল করতে আপনার টেস্ট অ্যাকাউন্ট ব্যবহার করুন:
- আপনার ফাইল ফিড সেট-আপ মিরর করুন: টেস্ট অ্যাকাউন্টে একটি ফাইল প্রাইমারি ডেটা সোর্স (এবং যেকোনও অতিরিক্ত ডেটা সোর্স) তৈরি করুন এবং আপনার প্রোডাকশন ফিড ফাইলের একটি স্যাম্পেল আপলোড করুন।
- একটি টেস্ট API ডেটা সোর্স এবং নিয়ম তৈরি করুন: একটি API প্রাথমিক ডেটা সোর্স তৈরি করুন এবং যেকোনও প্রয়োজনীয় অ্যাট্রিবিউট নিয়ম বা সাপ্লিমেন্টাল ফিড যোগ কনফিগার করুন।
- মালিকানা টেকওভার ও কী অ্যালাইনমেন্ট পরীক্ষা করা: স্যাম্পেল প্রোডাক্টের জন্য
productInputs.insertটি অনুরোধ পাঠান এবং যাচাই করুন যে API ডেটা সোর্স ডুপ্লিকেট প্রোডাক্ট তৈরি না করেই আগে থেকে থাকা আইটেমের মালিকানা গ্রহণ করছে। - আপডেট ও মুছে ফেলা যাচাই করুন:
productInputs.patch-এর মাধ্যমে আংশিক আপডেট এবংproductInputs.delete-এর মাধ্যমে মুছে ফেলা পরীক্ষা করুন এবংproducts.get-এর মাধ্যমে ফলাফল হিসেবে পাওয়া রিসোর্সগুলি দেখুন।
২. প্রোডাকশন API ডেটা সোর্স তৈরি করুন
ডেটা পুশ করার আগে, আপনার অ্যাকাউন্টে API ধরনের প্রাইমারি ডেটা সোর্স তৈরি করুন।
আপনার API প্রাইমারি ডেটা সোর্স তৈরি করুন
API পুশ গ্রহণ করে এমন ডেটা সোর্স তৈরি করতে,
dataSources এন্ডপয়েন্টে POST অনুরোধ পাঠান। আরও জানতে,
প্রাইমারি প্রোডাক্ট ডেটা সোর্স তৈরি করুন।
৩. কাস্টম অ্যাট্রিবিউট সংক্রান্ত নিয়ম ট্রানজিশন করুন
কাস্টম অ্যাট্রিবিউট সংক্রান্ত নিয়ম নির্দিষ্ট ডেটা সোর্সের সাথে বাইন্ড করা থাকে এবং আপনার ফাইল ডেটা সোর্স থেকে নতুন API ডেটা সোর্সে অটোমেটিক ট্রান্সফার হয় না।
আপনি কীভাবে অ্যাট্রিবিউট সংক্রান্ত নিয়ম ট্রানজিশন করবেন তা সেগুলির উদ্দেশ্যের উপর নির্ভর করে:
- ক্রস-সোর্স মার্জিং এবং থার্ড-পার্টি সাপ্লিমেন্টাল ফিড: আপনি যদি এক্সটার্নাল সাপ্লিমেন্টাল ডেটা সোর্সের (যেমন থার্ড-পার্টি সাপ্লায়ার ফাইল, ইনভেনটরি স্প্রেডশিট বা প্রোমোশনাল ফিড) সাথে প্রাইমারি API ডেটা একত্রিত করেন, তাহলে আপনাকে Merchant Center UI-তে অ্যাট্রিবিউট সংক্রান্ত নিয়ম আবার তৈরি করতে হবে এবং নতুন API ডেটা সোর্সের সাথে সেগুলি অ্যাটাচ করতে হবে। ক্লায়েন্ট-সাইড প্রি-প্রসেসিং একাধিক স্বতন্ত্র সোর্স জুড়ে ডেটা যোগ করার নিয়মগুলি প্রতিস্থাপন করতে পারে না।
- সিঙ্গেল-সোর্স ডেটা ট্রান্সফর্মেশন: আপনার প্রাইমারি ক্যাটালগ ডেটায় সিঙ্গেল-সোর্স ক্লিনআপ, ডিফল্ট
ভ্যালু বা স্ট্রিং ফর্ম্যাটিংয়ের জন্য, এগুলির মধ্যে থেকে বেছে নিন:
- ব্যাকএন্ড ট্রান্সফর্মেশন (সাজেস্ট করা): API কল করার আগে আপনার নিজস্ব সিস্টেমে ট্রান্সফর্মেশন প্রয়োগ করুন। এটি আপনাকে আরও বেশি প্রোগ্রাম্যাটিক কন্ট্রোল, সহজ টেস্টিং এবং সরলীকৃত ডিবাগিংয়ের সুবিধা দেয়।
- Merchant Center অ্যাট্রিবিউট সংক্রান্ত নিয়ম: আপনি যদি চান যে Merchant Center অটোমেটিক আপনার ডেটা সোর্স ম্যানেজ করা চালিয়ে যাক, তাহলে Merchant Center UI-তে আপনার নতুন API ডেটা সোর্সের জন্য ট্রান্সফর্মেশন সংক্রান্ত নিয়ম আবার তৈরি করুন।
৪. API ইন্টিগ্রেশন চালু করুন
আপনার নতুন API প্রাইমারি ডেটা সোর্সে প্রোডাক্ট যোগ করা, আপডেট করা এবং মুছে ফেলা শুরু করতে, আপনার প্রোডাকশন API ইন্টিগ্রেশন চালু করুন:
প্রোডাক্ট যোগ ও আপডেট করা (মালিকানা গ্রহণ): আপনার ইন্টিগ্রেশন থেকে
productInputs.insertএবংproductInputs.patchঅনুরোধ পাঠান। আপনি যখন API ব্যবহার করে কোনও প্রোডাক্ট যোগ করেন এবং সেটির কী (offerId,contentLanguage,feedLabel) আগে থেকে থাকা ফাইল-ফিড প্রোডাক্টের সাথে মিলে যায়, তখন API ডেটা সোর্স সেই প্রোডাক্টের মালিকানা নিয়ে নেয় এবং সেটির দেখানোর ইতিহাস সংরক্ষণ করে। আরও নির্দেশিকার জন্য, প্রোডাক্ট যোগ করুন এবং প্রোডাক্ট যোগ ও ম্যানেজ করুন দেখুন।বন্ধ হয়ে যাওয়া প্রোডাক্ট মুছে দিন: আপনার ক্যাটালগ থেকে কোনও প্রোডাক্ট মুছে দেওয়া হলে,
productInputs.delete-এ স্পষ্টভাবে কল করার জন্য আপনার ইন্টিগ্রেশন কনফিগার করুন।ধাপে ধাপে ডেপ্লয় করুন: বড় ক্যাটালগের ক্ষেত্রে, একবারে একটি Merchant Center সাব-অ্যাকাউন্ট বা একটি ডেটা সোর্সের জন্য ইন্টিগ্রেশন চালু করুন।
কনকারেন্সি কনফিগার করুন: অনেক অনুরোধ পাঠালে, কনকারেন্ট অনুরোধ ম্যানেজ করতে ও একাধিক কানেকশন ম্যানেজ করতে আপনার ক্লায়েন্ট কনফিগার করুন। একসাথে একাধিক অনুরোধের জন্য কোড রিফ্যাক্টর করা গাইড দেখুন।
৫. ফাইল ডেটা সোর্স আপডেট পজ করুন
আপনার API ইন্টিগ্রেশন অ্যাক্টিভ হয়ে গেলে, পরবর্তী শিডিউল করা ফাইল রান হওয়ার আগে ফাইল আপডেট করা বন্ধ করুন যাতে ফাইল ডেটা সোর্স আপনার API আপডেট ওভাররাইট না করে:
- আপনার SFTP/FTP লোকেশন, Google ক্লাউড স্টোরেজ বা Google Sheets-এ নতুন ফাইল আপলোড করা বন্ধ করুন।
- Merchant Center UI-তে, আপনার ফাইল ডেটা সোর্সে নেভিগেট করুন এবং এটির শিডিউল করা ফেচ পজ করুন।
- ফাইল ডেটা সোর্সের মালিকানাধীন আগে থেকে থাকা প্রোডাক্টগুলি আপনার API ইন্টিগ্রেশন সেগুলি যোগ না করা পর্যন্ত ৩০ দিন পর্যন্ত লাইভ থাকে।
৬. মাইগ্রেশন সম্পূর্ণ হওয়া পর্যন্ত অপেক্ষা করুন এবং যাচাই করুন
সব অ্যাক্টিভ প্রোডাক্ট ফাইল ডেটা সোর্স থেকে API ডেটা সোর্সে মাইগ্রেট না হওয়া পর্যন্ত অপেক্ষা করুন। ইনক্রিমেন্টাল আপডেট প্রোডাক্ট পরিবর্তন হওয়ার সাথে সাথে সেগুলি মাইগ্রেট করে, আপনার রেগুলার ইন্টিগ্রেশনের মাধ্যমে পেসড সম্পূর্ণ ক্যাটালগ সিঙ্ক করলে, আপনার সম্পূর্ণ ক্যাটালগ মাইগ্রেট করার প্রসেস দ্রুত হয় ( সিঙ্ক করার স্ট্র্যাটেজি ও কোটা দেখুন)।
এই ফেজ চলাকালীন:
- Merchant Center UI-তে আইটেমের সংখ্যা মনিটর করুন। ফাইল ডেটা সোর্সের সংখ্যা কমে
0না হওয়া এবং API ডেটা সোর্সের সংখ্যা আপনার অ্যাক্টিভ ক্যাটালগের সাথে ম্যাচ না করা পর্যন্ত অপেক্ষা করুন। - অ্যাট্রিবিউট এবং কাস্টম অ্যাট্রিবিউট সংক্রান্ত নিয়ম প্রত্যাশা অনুযায়ী মার্জ হয়েছে কিনা তা যাচাই করতে
products.getব্যবহার করুন। - সমস্যার হার ও API পারফর্ম্যান্স ট্র্যাক করতে Merchant Center UI-তে API ডায়াগনস্টিক টুল মনিটর করুন।
৭. ফাইল ডেটা সোর্স ডিকমিশন করুন
ট্রানজিশন সম্পূর্ণ হওয়ার পরে এবং ফাইল ফিড আইটেমের সংখ্যা 0 হলে:
- আপডেট রিয়েল-টাইমে দেখা যাচ্ছে কিনা তা কনফার্ম করুন।
- Merchant Center UI-তে পুরনো ফাইল ডেটা সোর্স মুছে দিন যাতে ভুলবশত ফাইল-ভিত্তিক আপডেট আপনার API ডেটা ওভাররাইট না করে।