এই নির্দেশিকাটি ব্যাখ্যা করে যে কীভাবে আপনার ইন্টিগ্রেশনকে শপিংয়ের জন্য কন্টেন্ট 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 ) নির্দিষ্ট করে, যা আরও স্পষ্ট কনফিগারেশন প্রদান করে। |