ডেটা উৎস স্থানান্তর করুন

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

নতুন বৈশিষ্ট্যগুলি সম্পর্কে আরও তথ্যের জন্য, আপনার ডেটা সোর্স পরিচালনা করুন নির্দেশিকাটি দেখুন।

মূল পার্থক্য

শপিংয়ের জন্য কন্টেন্ট এপিআইয়ের তুলনায়, মার্চেন্ট এপিআই বেশ কিছু সুবিধা প্রদান করে।

  • স্পষ্ট ডেটা সোর্স তৈরি। আপনার প্রথম পণ্য সন্নিবেশের সময় API আর স্বয়ংক্রিয়ভাবে "Content API" ডেটা সোর্স তৈরি করে না। Merchant API-তে, আপনি পণ্য আপলোড করার আগে স্পষ্টভাবে ডেটা সোর্স তৈরি করেন। এটি আপনাকে শুরু থেকেই আপনার পণ্য ডেটা পাইপলাইনগুলির সংগঠন এবং পরিচালনার উপর আরও নিয়ন্ত্রণ দেয়।

  • একাধিক API ডেটা উৎসের জন্য সমর্থন। শপিংয়ের জন্য Content API-তে, আপনি একটি একক, স্বয়ংক্রিয়ভাবে তৈরি "Content API" ডেটা উৎসের মধ্যে সীমাবদ্ধ ছিলেন। Merchant API-এর সাহায্যে আপনি API ইনপুট ধরণের একাধিক ডেটা উৎস তৈরি এবং পরিচালনা করতে পারেন।

  • লেবেল এবং ভাষা ছাড়াই ডেটা সোর্স। Merchant API আপনাকে feedLabel এবং contentLanguage নির্দিষ্ট না করেই একটি প্রাথমিক ডেটা সোর্স তৈরি করতে দেয়। এই ধরণের ডেটা সোর্স feedLabel এবং contentLanguage এর যেকোনো সংমিশ্রণে পণ্য গ্রহণ করে, যা বিভিন্ন অঞ্চলের জন্য পৃথক ডেটা সোর্সের প্রয়োজন হয় না এমন ইন্টিগ্রেশনের জন্য পণ্য আপলোড সহজ করে।

  • সরলীকৃত ডেটা টার্গেট। প্রতিটি ডেটা সোর্স এখন একটি একক টার্গেটের সাথে সঙ্গতিপূর্ণ, যা feedLabel এবং contentLanguage এর একটি অনন্য সমন্বয় দ্বারা সংজ্ঞায়িত করা হয়েছে। Merchant API-তে মাল্টি-ডেটা টার্গেট ফিডগুলি অবচিত করা হয়েছে।

  • ডেডিকেটেড ফাইল আপলোড স্ট্যাটাস। মার্চেন্ট API একটি পৃথক, পঠনযোগ্য fileUploads রিসোর্স ব্যবহার করে ফাইল-ভিত্তিক ডেটা সোর্সের স্ট্যাটাস উপস্থাপন করে। ফাইল আপলোডের স্ট্যাটাস পুনরুদ্ধার করতে, latest উপনাম সহ fileUploads.get পদ্ধতি ব্যবহার করুন।

  • নতুন ডেটা সোর্সের ধরণ। DataSource রিসোর্সটি প্রচার, স্থানীয় ইনভেন্টরি এবং আঞ্চলিক ইনভেন্টরি সহ আরও উল্লম্ব সমর্থন করে, যা আপনার সমস্ত ডেটা পাইপলাইন পরিচালনা করার জন্য একটি সমন্বিত উপায় প্রদান করে।

  • স্বয়ংক্রিয় ডেটা উৎস। Merchant API এর সাহায্যে, আপনি এখন অ্যাকাউন্ট সাব-API-তে autofeedSettings.updateAutofeedSettings পদ্ধতি ব্যবহার করে আপনার অ্যাকাউন্টের জন্য স্বয়ংক্রিয় ডেটা উৎস বৈশিষ্ট্যটি সক্ষম বা অক্ষম করতে পারেন। আরও তথ্যের জন্য, অটোফিড সেটিংস কনফিগার করুন দেখুন।

অনুরোধ

নিম্নলিখিত টেবিলটি শপিংয়ের জন্য কন্টেন্ট এপিআই এবং মার্চেন্ট এপিআইয়ের মধ্যে অনুরোধের URL ফর্ম্যাটগুলির তুলনা করে।

অনুরোধের বিবরণ কেনাকাটার জন্য কন্টেন্ট API মার্চেন্ট এপিআই
একটি ডেটা সোর্স তৈরি করুন POST https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID} /datafeeds POST https://merchantapi.googleapis.com/v1/accounts/ {ACCOUNT_ID} /dataSources
একটি ডেটা সোর্স পান GET https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID} /datafeeds/ {DATAFEED_ID} GET https://merchantapi.googleapis.com/v1/accounts/ {ACCOUNT_ID} /dataSources/ {DATASOURCE_ID}
তথ্য উৎসের তালিকা তৈরি করুন GET https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID} /datafeeds GET https://merchantapi.googleapis.com/v1/accounts/ {ACCOUNT_ID} /dataSources
একটি ডেটা উৎস আপডেট করুন PUT https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID} /datafeeds/ {DATAFEED_ID} PATCH https://merchantapi.googleapis.com/v1/accounts/ {ACCOUNT_ID} /dataSources/ {DATASOURCE_ID}
একটি ডেটা উৎস মুছে ফেলুন DELETE https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID} /datafeeds/ {DATAFEED_ID} DELETE https://merchantapi.googleapis.com/v1/accounts/ {ACCOUNT_ID} /dataSources/ {DATASOURCE_ID}
একটি ডেটা উৎস আনুন POST https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID} /datafeeds/ {DATAFEED_ID} /fetchNow POST https://merchantapi.googleapis.com/v1/accounts/ {ACCOUNT_ID} /dataSources/ {DATASOURCE_ID} :fetch
ডেটা সোর্স স্ট্যাটাস পান GET https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID} /datafeedstatuses/ {DATAFEED_ID} GET https://merchantapi.googleapis.com/v1/accounts/ {ACCOUNT_ID} /dataSources/ {DATASOURCE_ID} /fileUploads/latest
ডেটা সোর্স স্ট্যাটাস তালিকাভুক্ত করুন GET https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID} /datafeedstatuses উপলব্ধ নেই। প্রতিটি ফাইল-ভিত্তিক ডেটা উৎসের জন্য dataSources.list এবং fileUploads.get ব্যবহার করুন।

শনাক্তকারী

মার্চেন্ট এপিআই শনাক্তকারী হিসেবে একটি স্ট্রিং-ভিত্তিক রিসোর্স নাম ব্যবহার করে।

শনাক্তকারীর বর্ণনা কেনাকাটার জন্য কন্টেন্ট API মার্চেন্ট এপিআই
ডেটা সোর্স শনাক্তকারী datafeedId (সাংখ্যিক) name (স্ট্রিং, ফর্ম্যাট: accounts/{account}/dataSources/{datasource} )

পদ্ধতি

এই টেবিলটি শপিং datafeeds এবং datafeedstatuses পরিষেবার জন্য কন্টেন্ট API থেকে মার্চেন্ট API-তে তাদের সমতুল্য পদ্ধতিগুলির সাথে তুলনা করে।

কেনাকাটা পদ্ধতির জন্য কন্টেন্ট API মার্চেন্ট এপিআই পদ্ধতি প্রাপ্যতা এবং নোট
datafeeds.custombatch পাওয়া যায় না পরিবর্তে পৃথক API কল ব্যবহার করুন।
datafeeds.delete dataSources.delete পাওয়া যায়।
datafeeds.fetchnow dataSources.fetch উপলব্ধ। এই পদ্ধতিটি এখন শুধুমাত্র ফাইল ইনপুট সহ ডেটা উৎসের জন্য কাজ করে।
datafeeds.get dataSources.get পাওয়া যায়।
datafeeds.insert dataSources.create পাওয়া যায়।
datafeeds.list dataSources.list পাওয়া যায়।
datafeeds.update dataSources.update উপলব্ধ। PUT এর পরিবর্তে PATCH শব্দার্থবিদ্যা ব্যবহার করে।
datafeedstatuses.custombatch পাওয়া যায় না পরিবর্তে পৃথক API কল ব্যবহার করুন। আরও বিস্তারিত জানার জন্য একসাথে একাধিক অনুরোধ পাঠান দেখুন।
datafeedstatuses.get fileUploads.get ফাইল-ভিত্তিক ডেটা সোর্সের জন্য উপলব্ধ। সাম্প্রতিক আপলোডের স্ট্যাটাস পেতে latest উপনাম ব্যবহার করুন। অন্যান্য ডেটা সোর্সের ধরণের জন্য, স্ট্যাটাস তথ্য DataSource রিসোর্সের অংশ।
datafeedstatuses.list পাওয়া যায় না একাধিক ডেটা সোর্সের অবস্থা জানতে, প্রথমে dataSources.list দিয়ে সমস্ত ডেটা সোর্স তালিকাভুক্ত করুন। তারপর প্রতিটি ফাইল-ভিত্তিক ডেটা সোর্সের জন্য latest উপনাম সহ fileUploads.get কল করুন।

বিস্তারিত ক্ষেত্রের পরিবর্তন

এই টেবিলটি শপিংয়ের জন্য Content API-তে Datafeed এবং DatafeedStatus রিসোর্স এবং Merchant API-তে DataSource এবং FileUpload রিসোর্সের মধ্যে ফিল্ড-লেভেল পরিবর্তনগুলি দেখায়।

কেনাকাটার জন্য কন্টেন্ট API মার্চেন্ট এপিআই বিবরণ
Datafeed DataSource ডেটা সোর্স কনফিগারেশনের প্রধান উৎস।
id name রিসোর্স আইডেন্টিফায়ার। একটি সাংখ্যিক আইডি থেকে একটি স্ট্রিং রিসোর্স নামে পরিবর্তন করা হয়েছে।
name displayName ডেটা উৎসের ব্যবহারকারী-মুখী নাম।
attributeLanguage primaryProductDataSource.contentLanguage ডেটা উৎসের আইটেমগুলির দুই অক্ষরের ISO 639-1 ভাষা কোড।
fileName fileInput.fileName আপলোড করা ফাইলের নাম। এই ক্ষেত্রটি এখন fileInput এর অধীনে নেস্টেড।
fetchSchedule fileInput.fetchSettings ফাইল-ভিত্তিক ডেটা উৎস আনার সময়সূচী। এটি এখন fileInput অধীনে নেস্টেড।
fetchSchedule.paused fileInput.fetchSettings.enabled লজিকটি উল্টানো। paused: true হল enabled: false এর সমতুল্য।
format পাওয়া যায় না fileEncoding , columnDelimiter , এবং quotingMode ক্ষেত্রগুলি সরানো হয়েছে। এগুলি এখন স্বয়ংক্রিয়ভাবে সনাক্ত করা হয়েছে।
targets primaryProductDataSource.feedLabel , primaryProductDataSource.contentLanguage , primaryProductDataSource.countries পুনরাবৃত্তিমূলক targets ক্ষেত্রটি সরানো হয়েছে। প্রতিটি ডেটা উৎসের এখন এই ক্ষেত্রগুলি দ্বারা সংজ্ঞায়িত একটি একক লক্ষ্য রয়েছে, যা মাল্টি-ডেটা-টার্গেট ফিডের অবচয়কে প্রতিফলিত করে।
DatafeedStatus FileUpload ফাইল আপলোডের অবস্থা এখন একটি পৃথক, কেবল পঠনযোগ্য সম্পদ।
datafeedId name ফাইল আপলোডের শনাক্তকারী, যা এর মূল ডেটা উৎসকে উল্লেখ করে।
processingStatus processingState আপলোডের প্রক্রিয়াকরণ অবস্থা। স্ট্রিং মান ( success , failure , in progress ) একটি enum ( SUCCEEDED , FAILED , IN_PROGRESS ) দ্বারা প্রতিস্থাপিত হয়।
errors , warnings issues ত্রুটি এবং সতর্কতাগুলি একটি একক issues তালিকায় একত্রিত করা হয়। প্রতিটি সমস্যার একটি severity ক্ষেত্র ( ERROR অথবা WARNING ) থাকে।
lastUploadDate uploadTime শেষ আপলোডের টাইমস্ট্যাম্প। ফর্ম্যাটটি একটি স্ট্রিং থেকে একটি Timestamp অবজেক্টে পরিবর্তিত হয়েছে।
country , language , feedLabel প্রযোজ্য নয় এই ক্ষেত্রগুলি আর স্ট্যাটাস রিসোর্সে নেই। এগুলি DataSource রিসোর্সের অংশ।
targets[].included_destinations , targets[].excluded_destinations primaryProductDataSource.destinations অন্তর্ভুক্ত এবং বাদ দেওয়া গন্তব্যের জন্য দুটি পৃথক তালিকা একটি একক destinations তালিকা দ্বারা প্রতিস্থাপিত হয়। নতুন তালিকার প্রতিটি আইটেম হল একটি বস্তু যা গন্তব্য এবং তার অবস্থা ( ENABLED বা DISABLED ) নির্দিষ্ট করে, যা আরও স্পষ্ট কনফিগারেশন প্রদান করে।