মার্চেন্ট ডেটা সোর্স 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 দেখুন।

নিম্নলিখিত নমুনা অনুরোধটি দেখায় কিভাবে আপনি একটি প্রাথমিক পণ্য ডেটা উৎস তৈরি করতে পারেন:

POST https://merchantapi.googleapis.com/datasources/v1beta/accounts/{ACCOUNT_ID}/dataSources

{
  "displayName": "{DISPLAY_NAME}",
  "primaryProductDataSource": {
    "contentLanguage": "{CONTENT_LANGUAGE}",
    "feedLabel": "{FEED_LABEL}",
    "countries": [
      "{COUNTRY}"
    ],
    "channel": "ONLINE_PRODUCTS"
  }
}

নিম্নলিখিতগুলি প্রতিস্থাপন করুন:

• {ACCOUNT_ID} : আপনার Merchant Center অ্যাকাউন্টের অনন্য শনাক্তকারী।
• {DISPLAY_NAME} : ডেটা উৎসের প্রদর্শন নাম।
• {CONTENT_LANGUAGE} : ডেটা উৎসে পণ্যগুলির দুই-অক্ষরের ISO 639-1 ভাষার কোড।
• {FEED_LABEL} : ডেটা উৎসের ফিড লেবেল।
• {COUNTRY} : ডেটা উত্স ব্যবহার করে আপলোড করা পণ্যগুলির লক্ষ্য দেশের CLDR অঞ্চল কোড৷

অনুরোধ সফলভাবে চালানোর পরে, আপনি নিম্নলিখিত প্রতিক্রিয়া দেখতে পাবেন:

{
  "name": "accounts/{ACCOUNT_ID}/dataSources/{DATA_SOURCE_ID}",
  "dataSourceId": "{DATA_SOURCE_ID}",
  "displayName": "{DISPLAY_NAME}",
  "primaryProductDataSource": {
    "channel": "ONLINE_PRODUCTS",
    "feedLabel": "{FEED_LABEL}",
    "contentLanguage": "{CONTENT_LANGUAGE}",
    "countries": [
      "{COUNTRY}"
    ],
    "defaultRule": {
      "takeFromDataSources": [
        {
          "self": true
        }
      ]
    }
  },
  "input": "API"
}

একটি ডেটা উৎস তৈরি সম্পর্কে আরও তথ্যের জন্য, 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 ক্ষেত্রগুলি সেট করা উচিত। পরিপূরক এপিআই ডেটা উত্সগুলিতে সর্বদা feedLabel এবং contentLanguage ক্ষেত্রগুলি আনসেট থাকতে হবে।

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

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

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

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

তথ্য উৎস আনুন

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

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

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

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

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

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

বিদ্যমান ডেটা উত্সের কনফিগারেশন আপডেট করতে, অ্যাকাউন্টগুলি ব্যবহার করুন 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.getAutofeedSettings পদ্ধতিতে কল করে আপনার অ্যাকাউন্ট নথিভুক্তির জন্য যোগ্য কিনা তা পরীক্ষা করুন।
• নিশ্চিত করুন যে আপনার অ্যাকাউন্টটি একটি মার্কেটপ্লেস অ্যাকাউন্ট নয়৷

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

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

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

GET https://merchantapi.googleapis.com/accounts/v1beta/{ACCOUNT_ID}/datasources/{DATASOURCE_ID}/fileUploads/latest

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

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