মার্চেন্ট ডেটা সোর্স API এর ওভারভিউ

এই পৃষ্ঠাটি দেখায় কিভাবে প্রোগ্রাম্যাটিকভাবে আপনার ডেটা উত্স তৈরি এবং আপডেট করতে হয় যা আপনাকে পণ্যগুলি সন্নিবেশ করতে দেয়। স্বয়ংক্রিয় ডেটা উত্সগুলি Google-এ আপনার পণ্য ডেটা পাঠানো সহজ করে তোলে৷ স্বয়ংক্রিয় ডেটা উত্সগুলি নিশ্চিত করে যে আপনার ওয়েবসাইট থেকে প্রাসঙ্গিক পণ্যগুলির সম্পর্কে সর্বাধিক আপ-টু-ডেট তথ্য Google-এর কাছে পৌঁছেছে৷

কেনাকাটার জন্য সামগ্রী API শুধুমাত্র আপনাকে প্রাথমিক ডেটা উত্স তৈরি করতে দেয়। মার্চেন্ট ডেটা সোর্স API-এর সাহায্যে আপনি নিম্নলিখিত ধরনের ডেটা সোর্স তৈরি করতে পারেন:

কেনাকাটার জন্য সামগ্রী API শুধুমাত্র আপনাকে ফাইল ইনপুট সহ ডেটা উত্স পরিচালনা করতে দেয়৷ মার্চেন্ট API আপনাকে ফাইল এবং API ইনপুট উভয়ের মাধ্যমে ডেটা উত্সগুলি পরিচালনা করতে দেয়৷

বণিক ডেটা উত্স API ব্যবহার করে, আপনি নিম্নলিখিতগুলি করতে পারেন:

  • একটি নির্দিষ্ট feedLabel এবং contentLanguage সহ একটি নতুন প্রাথমিক ডেটা উৎস তৈরি করুন।
  • feedLabel এবং contentLanguage ক্ষেত্রগুলি সেট করা নেই এমন একটি ডেটা উত্স তৈরি করুন৷ এই ধরনের ডেটা উত্স ব্যবহার করে আপনি আপনার পণ্যগুলির জন্য একাধিক দেশকে লক্ষ্য করতে পারেন, কারণ আপনি একটি একক ডেটা উত্সে feedLabel এবং contentLanguage এর বিভিন্ন সংমিশ্রণ সহ পণ্যগুলি সন্নিবেশ করতে পারেন৷
  • একটি বিদ্যমান প্রাথমিক ডেটা উত্সের সাথে লিঙ্ক করতে একটি সম্পূরক ডেটা উত্স তৈরি করুন৷
  • একটি ফাইল ডেটা উৎসের জন্য একটি সময়সূচী সেট আপ করুন।
  • ডেটা উত্সগুলির স্বয়ংক্রিয় পরিচালনার জন্য আপনার অ্যাকাউন্ট নথিভুক্ত করুন৷
  • API ডেটা উত্স পরিচালনা করুন।
  • প্রাথমিক পণ্য ডেটা উত্স ব্যবহার করে ডেটা উত্সগুলির ডিফল্ট নিয়ম পরিচালনা করুন৷
  • প্রচারের মত অন্যান্য ধরনের ডেটা উৎস ব্যবহার করুন।

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

পূর্বশর্ত

  • আপনার অ্যাকাউন্ট অবশ্যই একক লোকেল ফিডে স্থানান্তরিত হয়েছে।

  • অ্যাকাউন্টটি ইতিমধ্যে ডেটা টার্গেট স্প্লিটে স্থানান্তরিত হয়েছে তা যাচাই করতে, ডেটা উত্স তালিকা ব্যবহার করুন বা পদ্ধতিগুলি পান৷ যদি আপনি যোগ্য না হন, আপনি নিম্নলিখিত ব্যতিক্রম বার্তা পাবেন এবং আপনার সমর্থনে যোগাযোগ করা উচিত।

    This account is in the data sources migration process and can't be used with
this API yet. Contact support for more info on when this account will be able
to use the data sources endpoint.

একটি নতুন ডেটা উৎস তৈরি করুন

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

একটি নির্দিষ্ট feedLabel এবং contentLanguage সহ একটি নতুন প্রাথমিক ডেটা উৎস তৈরি করতে, টাইপ-নির্দিষ্ট কনফিগারেশনে feedLabel এবং contentLanguage ক্ষেত্রগুলি সেট করুন। এই ক্ষেত্রগুলি সম্পর্কে আরও তথ্যের জন্য, PrimaryProductDataSource দেখুন।

একটি ডেটা উৎস তৈরি সম্পর্কে আরও তথ্যের জন্য, accounts.dataSources.create পদ্ধতি দেখুন।

আপনার নতুন তৈরি করা ডেটা উৎস দেখতে, accounts.dataSources.get বা accounts.dataSources.list পদ্ধতি ব্যবহার করুন।

একটি নতুন প্রাথমিক ডেটা উত্স তৈরি করুন যা একাধিক দেশকে লক্ষ্য করতে সহায়তা করে৷

একটি নতুন প্রাথমিক ফিড তৈরি করতে যা আপনাকে একাধিক দেশকে টার্গেট করতে সহায়তা করে, PrimaryProductDataSource ব্যবহার করে আপনার ডেটা উত্স কনফিগার করুন এবং feedLabel এবং contentLanguage ক্ষেত্রগুলি সেট করবেন না৷

কেনাকাটার জন্য সামগ্রী API ব্যবহার করে, আপনার জন্য শুধুমাত্র একটি API ডেটা উৎস তৈরি করা হয়েছে। মার্চেন্ট ডেটা সোর্স API ব্যবহার করে, আপনার একাধিক API ডেটা উত্স থাকতে পারে, যার মধ্যে কিছু feedLabel এবং contentLanguage ফিল্ড সেট ছাড়াই হতে পারে।

শুধুমাত্র API ইনপুট সহ ডেটা উত্সগুলি feedLabel এবং contentLanguage ফিল্ড সেট ছাড়াই থাকতে পারে৷ এই ধরনের ডেটা উত্স ফাইল ইনপুটগুলির জন্য সমর্থিত নয়৷

একটি সম্পূরক তথ্য উৎস তৈরি করুন এবং প্রাথমিক তথ্য উৎসের সাথে লিঙ্ক করুন

পরিপূরক ডেটা উত্সগুলি শুধুমাত্র এমন পণ্য ডেটা আপডেট করতে ব্যবহার করা হয় যা ইতিমধ্যে এক বা একাধিক প্রাথমিক ডেটা উত্সে বিদ্যমান। আপনার একাধিক পরিপূরক ডেটা উত্স থাকতে পারে এবং প্রতিটি একটি প্রাথমিক ডেটা উত্সের যেকোনো সংখ্যক ডেটার পরিপূরক করতে পারে।

আপনি accounts.productInputs.insert এবং accounts.productInputs.delete পদ্ধতিতে কল করার সময় একটি ক্যোয়ারী প্যারামিটার হিসাবে ডেটা উৎসের অনন্য শনাক্তকারী যোগ করে পণ্য ডেটাতে আংশিক আপডেট করতে সম্পূরক ডেটা উত্স ব্যবহার করতে পারেন৷ আপনি বিদ্যমান পণ্য আপডেট করার জন্য শুধুমাত্র সম্পূরক ডেটা উৎস ব্যবহার করতে পারেন।

একটি পরিপূরক ডেটা উৎস তৈরি করতে, SupplementalProductDataSource ব্যবহার করে আপনার ডেটা সোর্স কনফিগার করুন এবং তারপর আপনার প্রাথমিক ডেটা সোর্সের defaultRule ফিল্ড আপডেট করে লিঙ্ক করুন।

পরিপূরক ফাইল ডেটা উত্সগুলিতে অবশ্যই feedLabel এবং contentLanguage ক্ষেত্র সেট থাকতে হবে। পরিপূরক API ডেটা উত্সগুলিতে সর্বদা feedLabel এবং contentLanguage ক্ষেত্রগুলি আনসেট থাকতে হবে৷

আপনার ফাইল ডেটা উৎসের জন্য একটি সময়সূচী সেট আপ করুন

আপনার ফাইল ফিডের জন্য একটি সময়সূচী সেট আপ করতে, FileInput ক্ষেত্রটি ব্যবহার করে আপনার ডেটা উত্সটিকে একটি ফাইল ডেটা উত্স হিসাবে কনফিগার করুন এবং তারপর FileInput.FetchSettings ক্ষেত্র ব্যবহার করে fetchsettings সেট আপ করুন৷

একটি ডেটা উৎস মুছুন

আপনার অ্যাকাউন্ট থেকে একটি বিদ্যমান ডেটা উৎস মুছে ফেলতে, accounts.dataSources.delete পদ্ধতি ব্যবহার করুন।

তথ্য উৎস আনুন

ডেটা উৎসে কনফিগার করা একটি ফাইল আনতে, accounts.dataSources.fetch পদ্ধতি ব্যবহার করুন। এই পদ্ধতিটি আপনার অ্যাকাউন্ট থেকে ডেটা উৎসে অবিলম্বে ডেটা আনয়ন সম্পাদন করে। এই পদ্ধতিটি শুধুমাত্র একটি ফাইল ইনপুট সেট সহ ডেটা উত্সগুলিতে কাজ করে।

ডাটা সোর্স পান

আপনার অ্যাকাউন্টের জন্য ডেটা উৎস কনফিগারেশন পুনরুদ্ধার করতে, accounts.dataSources.get পদ্ধতি ব্যবহার করুন।

তথ্য উৎস তালিকা

আপনার অ্যাকাউন্টের জন্য ডেটা উত্সগুলির জন্য কনফিগারেশনগুলি তালিকাভুক্ত করতে, accounts.dataSources.list পদ্ধতি ব্যবহার করুন৷

প্যাচ ডেটা উৎস

একটি বিদ্যমান ডেটা উৎসের কনফিগারেশন আপডেট করতে, accounts.dataSources.patch পদ্ধতি ব্যবহার করুন।

প্রাথমিক পণ্য ডেটা উত্সগুলি আপনাকে ডেটা উত্সগুলির ডিফল্ট নিয়ম পরিচালনা করতে দেয়৷ ডিফল্ট নিয়ম হল সেই নিয়ম যা আপনার ডেটা উৎসের সমস্ত বৈশিষ্ট্যের ক্ষেত্রে প্রযোজ্য। ডেটা উত্স তৈরি করার সময় বা ডিফল্ট নিয়ম ক্ষেত্রের মাধ্যমে একটি বিদ্যমান ডেটা উত্স আপডেট করার সময় ডিফল্ট নিয়ম সেট করা যেতে পারে।

নিয়ম সেট আপ সম্পর্কে আরও তথ্যের জন্য, আপনার পণ্য ডেটা উত্সগুলির জন্য নিয়ম সেট আপ দেখুন৷

নিম্নলিখিত নমুনা কনফিগারেশন নিশ্চিত করে যে সমস্ত বৈশিষ্ট্যগুলি প্রথমে অনন্য শনাক্তকারী 1001 সহ ডেটা উত্স থেকে নেওয়া হয়েছে৷ তারপরে অনুপস্থিত বৈশিষ্ট্যগুলি প্রাথমিক ডেটা উত্স থেকে যোগ করা হয়। অবশেষে, অবশিষ্ট বৈশিষ্ট্যগুলি সম্পূরক ডেটা উত্স থেকে অনন্য শনাক্তকারী 1002 সহ নেওয়া হবে যদি ইতিমধ্যে অন্য কোনও ডেটা উত্সে সরবরাহ করা না থাকে৷ একই বৈশিষ্ট্য একাধিক ডেটা উৎসে প্রদান করা হলে, তালিকার উচ্চতর মান নির্বাচন করা হয়।

defaultRule {
 takeFromDataSources: [
   '1001', // Supplemental product data source
   'self', //  Self reference to the primary data source
   '1002' // Supplemental product data source
 ]
}

ফিডের স্বয়ংক্রিয় ব্যবস্থাপনা

ডেটা উত্সগুলির স্বয়ংক্রিয় পরিচালনার জন্য আপনার অ্যাকাউন্ট নথিভুক্ত করতে, আপনাকে অবশ্যই নিম্নলিখিতগুলি করতে হবে:

আপনার অ্যাকাউন্ট তালিকাভুক্তির জন্য যোগ্য হওয়ার পরে, আপনি ডেটা উত্সগুলির স্বয়ংক্রিয় ব্যবস্থাপনা সক্ষম করতে accounts.autofeedSettings.updateAutofeedSettings পদ্ধতি ব্যবহার করতে পারেন৷ ডেটা উত্সগুলির স্বয়ংক্রিয় ব্যবস্থাপনা সক্ষম করা Google কে স্বয়ংক্রিয়ভাবে আপনার অনলাইন স্টোর থেকে আপনার পণ্যগুলিকে যুক্ত করতে দেয় এবং নিশ্চিত করে যে সেগুলি সর্বদা Google এর প্ল্যাটফর্মে আপ টু ডেট থাকে৷

ফাইল আপলোড স্থিতি পুনরুদ্ধার করুন

ফাইল, আনয়ন বা স্প্রেডশীট সহ একটি ডেটা উত্সের স্থিতি পেতে, আপনি accounts.dataSources.fileUploads পরিষেবার GET পদ্ধতিতে কল করতে পারেন৷ ডেটা উত্স প্রক্রিয়াকরণ শেষ হলে অ্যাসিঙ্ক্রোনাসভাবে গণনা করা ডেটা উত্সের শেষ পুনরুদ্ধারের ফলাফল পেতে, নাম শনাক্তকারী latest ব্যবহার করুন৷

GET https://merchantapi.googleapis.com/accounts/v1beta/{accountId}/datasources/{datasourceId}/fileUploads/latest

ফাইল আপলোড স্থিতিতে আপনার পণ্যগুলির একটি বিশদ দৃশ্য থাকতে পারে, যেকোন সম্ভাব্য সমস্যা সহ।

মনে রাখবেন যে ফাইলটি আপলোড না হলে ফাইল আপলোডের স্থিতি নাও থাকতে পারে। ফাইল আপলোড করার শীঘ্রই অনুরোধ করা হলে ফাইল আপলোডের স্থিতি প্রক্রিয়াকরণ অবস্থায় থাকতে পারে।