বণিক পণ্য API এর ওভারভিউ

এই পৃষ্ঠাটি ব্যাখ্যা করে যে আপনি কীভাবে আপনার পণ্যগুলি প্রোগ্রামগতভাবে আপলোড এবং পরিচালনা করতে পারেন। বণিক পণ্য API ব্যবহার করে, আপনি একটি ডেটা উত্সে একটি পণ্য সন্নিবেশ বা আপডেট করতে পারেন, আপনার অ্যাকাউন্ট থেকে একটি পণ্য পুনরুদ্ধার করতে পারেন এবং একটি ডেটা উত্স থেকে একটি পণ্য মুছতে পারেন৷

বণিক পণ্য API-এ দুটি সংস্থান রয়েছে।

  • productInputs আপনার পণ্যের ইনপুট অংশ প্রতিনিধিত্ব করে।
  • products আপনার ইনপুট অংশগুলি থেকে তৈরি করা প্রক্রিয়াজাত পণ্যগুলির প্রতিনিধিত্ব করে৷

productInputs প্রাথমিক এবং সম্পূরক হতে পারে, এটি নির্ভর করে যে এটি একটি প্রাথমিক ডেটা উত্সে আপলোড করা হয়েছে বা একটি পরিপূরক ডেটা উত্সে ৷ প্রতিটি product একটি একক প্রাথমিক productInput এবং যেকোন সংখ্যক সম্পূরক productInputs থেকে তৈরি করা হবে।

আপনি একটি অনলাইন বা স্থানীয় স্টোর ক্যাটালগ তৈরি করতে বণিক পণ্য API ব্যবহার করতে পারেন, এটি এমন পণ্য যা একাধিক শপিং গন্তব্যে প্রদর্শিত হতে পারে। একবার আপনি আপনার Merchant Center অ্যাকাউন্ট তৈরি করার পরে, আপনার প্রথম ডেটা উত্স সেট আপ করার এবং API-এর মাধ্যমে পণ্যগুলির একটি প্রাথমিক সেট আপলোড করার জন্য প্রস্তুত হয়ে গেলে আপনি productInputs সংস্থানটি ব্যবহার করতে পারেন৷

যদিও বণিকদের একটি PrimaryProductDataSource নামে একটি ফাইল ব্যবহার করে পণ্য আপলোড করার ক্ষমতা রয়েছে, তবে মার্চেন্ট API ব্যবহার করে পণ্য তৈরি এবং মুছে ফেলার বিভিন্ন সুবিধা রয়েছে। এই সুবিধাগুলির মধ্যে রয়েছে দ্রুত প্রতিক্রিয়ার সময় এবং বড় ফাইলগুলি পরিচালনা করার প্রয়োজন ছাড়াই রিয়েল টাইমে পণ্য আপডেট করার ক্ষমতা। এপিআই কলের মাধ্যমে করা পণ্যের পরিবর্তন শপিং ডাটাবেসে দেখাতে কয়েক ঘণ্টা পর্যন্ত সময় লাগতে পারে।

পূর্বশর্ত

আপনার যদি কোনো ডেটা উৎস না থাকে, তাহলে Merchant DataSources API বা Merchant Center ব্যবহার করে একটি ডেটা উৎস তৈরি করুন

আপনার যদি ইতিমধ্যেই একটি ডেটা উত্স থাকে যা আপনি বণিক কেন্দ্র UI ব্যবহার করে বা API ব্যবহার করে তৈরি করেছেন, তাহলে আপনি আপনার পণ্যগুলি যোগ করতে বণিক পণ্য API ব্যবহার করতে পারেন৷ আপনি যদি পণ্য যোগ করার জন্য কেনাকাটার জন্য সামগ্রী API ব্যবহার করেন, তাহলে কীভাবে মার্চেন্ট পণ্য API দিয়ে শুরু করবেন তা বোঝার জন্য মাইগ্রেশন গাইড পড়ুন।

আপনি শপিং বিজ্ঞাপন এবং বিনামূল্যে তালিকা নীতি মেনে চলার জন্য দায়ী। শপিং বিজ্ঞাপনগুলি এই নীতিগুলি প্রয়োগ করার অধিকার সংরক্ষণ করে এবং যদি আমরা এই নীতিগুলি লঙ্ঘন করে এমন সামগ্রী বা আচরণ খুঁজে পাই তবে উপযুক্তভাবে প্রতিক্রিয়া জানাতে৷

সম্পদ

products সম্পদ আপনাকে শপিং ডাটাবেস থেকে পণ্য তথ্য পুনরুদ্ধার করতে দেয়।

productInput রিসোর্সটি কোনও পণ্যের জন্য আপনার জমা দেওয়া ইনপুট ডেটাকে উপস্থাপন করে। এটি এমন পদ্ধতিগুলিও প্রদান করে যা আপনাকে আপডেট করতে দেয়, বা পণ্যের তথ্য মুছে ফেলতে এক সময়ে, বা একাধিকবার ব্যাচ মোডে । একটি productInput রিসোর্সে অবশ্যই নিম্নলিখিত ক্ষেত্র থাকতে হবে:

  • channel : পণ্যের চ্যানেল
  • offerId : পণ্যের অনন্য শনাক্তকারী।
  • contentLanguage : পণ্যের জন্য দুই-অক্ষরের ISO 639-1 ভাষার কোড।
  • feedLabel : পণ্যের জন্য ফিড লেবেল।

আপনার অ্যাকাউন্টে একটি পণ্য ইনপুট আপলোড করুন

আপনার অ্যাকাউন্টে একটি পণ্য ইনপুট আপলোড করতে, accounts.productInputs.insert পদ্ধতি ব্যবহার করুন। আপনাকে প্রাথমিক বা সম্পূরক ডেটা উৎসের অনন্য শনাক্তকারী পাস করতে হবে।

আপনার অ্যাকাউন্ট থেকে একটি প্রক্রিয়াজাত পণ্য পুনরুদ্ধার করুন

আপনার অ্যাকাউন্ট থেকে একটি প্রক্রিয়াজাত পণ্য পুনরুদ্ধার করতে, accounts.products.get পদ্ধতি ব্যবহার করুন। প্রক্রিয়াজাত পণ্য সন্নিবেশের পরে প্রদর্শিত হতে কয়েক মিনিট সময় লাগতে পারে।

আপনি accounts.productInputs.insert এর প্রতিক্রিয়ায় product ক্ষেত্র থেকে প্রক্রিয়াকৃত পণ্যের সম্পদের নাম পেতে পারেন

আপনার অ্যাকাউন্ট থেকে একটি পণ্য ইনপুট মুছুন

আপনার অ্যাকাউন্ট থেকে একটি পণ্য ইনপুট মুছে ফেলতে, accounts.productInputs.delete পদ্ধতি ব্যবহার করুন। বণিক পণ্য API ব্যবহার করে একটি পণ্য মুছে ফেলার জন্য আপনাকে পণ্যটি যে প্রাথমিক বা পরিপূরক ডেটা উৎসের অনন্য শনাক্তকারীকে পাস করতে হবে।

আপনার অ্যাকাউন্ট থেকে পণ্য তালিকা

আপনার অ্যাকাউন্টে প্রক্রিয়াজাত পণ্য তালিকাভুক্ত করতে, accounts.products.list পদ্ধতি ব্যবহার করুন।