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

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

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

• প্রাথমিক পণ্য তথ্য উৎস
• সম্পূরক পণ্য তথ্য উৎস
• স্থানীয় জায় তথ্য উৎস
• আঞ্চলিক জায় তথ্য উৎস
• প্রচার তথ্য উৎস

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

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

• একটি নির্দিষ্ট feedLabel এবং contentLanguage সহ একটি নতুন প্রাথমিক ডেটা উৎস তৈরি করুন।
• একটি ওয়াইল্ডকার্ড ডেটা উৎস তৈরি করুন। একটি ওয়াইল্ডকার্ড ডেটা উৎসে feedLabel এবং contentLanguage ক্ষেত্র সেট করা নেই। ওয়াইল্ডকার্ড ডেটা উত্সগুলি আপনাকে একটি ডেটা উত্সে feedLabel এবং contentLanguage এর বিভিন্ন সমন্বয় সহ পণ্যগুলি সন্নিবেশ করতে দেয়৷
• একটি বিদ্যমান প্রাথমিক ডেটা উত্সের সাথে লিঙ্ক করতে একটি সম্পূরক ডেটা উত্স তৈরি করুন৷
• একটি ফাইল ডেটা উৎসের জন্য একটি সময়সূচী সেট আপ করুন।
• ডেটা উত্সগুলির স্বয়ংক্রিয় পরিচালনার জন্য আপনার অ্যাকাউন্ট নথিভুক্ত করুন৷
• 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.
  

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

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

আপনার নতুন তৈরি ডেটা উৎস দেখতে, একটি GET বা একটি LIST অনুরোধ তৈরি করুন৷

একটি নতুন ওয়াইল্ডকার্ড প্রাথমিক ডেটা উৎস তৈরি করুন

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

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

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

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

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

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

সম্পূরক ফাইল ডেটা উত্সগুলি ওয়াইল্ডকার্ড ডেটা উত্স হতে পারে না৷ পরিপূরক API ডেটা উত্সগুলি সর্বদা ওয়াইল্ডকার্ড ডেটা উত্স হতে হবে৷

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

আপনার ফাইল ফিডের জন্য একটি সময়সূচী সেট আপ করতে, 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
 ]
}

দ্রষ্টব্য: API এর মাধ্যমে কাস্টম নিয়ম সংশোধন করা যাবে না।

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

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

• Accounts.AutofeedSettings.Get পদ্ধতিতে কল করে আপনার অ্যাকাউন্ট তালিকাভুক্তির জন্য যোগ্য কিনা তা পরীক্ষা করুন।
• নিশ্চিত করুন যে আপনার অ্যাকাউন্টটি একটি মার্কেটপ্লেস অ্যাকাউন্ট নয়৷

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

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

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

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

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

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