এই নির্দেশিকাটি ব্যাখ্যা করে যে কীভাবে আপনার ইন্টিগ্রেশন datafeeds এবং datafeedstatuses পরিষেবাগুলি থেকে কেনাকাটার জন্য সামগ্রী API-এর পরিষেবাগুলি থেকে বণিক API-এর ডেটা উত্স উপ-এপিআই-এ স্থানান্তর করতে হয়৷ নতুন ডেটা সোর্স সাব-এপিআই আপনার ডেটা পাইপলাইনগুলির উপর আরও সরাসরি নিয়ন্ত্রণ প্রদান করে এবং ডেটা উত্স পরিচালনাকে সহজ করে।
নতুন বৈশিষ্ট্য সম্পর্কে আরও তথ্যের জন্য, আপনার ডেটা উত্স পরিচালনা করুন নির্দেশিকা দেখুন৷
মূল পার্থক্য
কেনাকাটার জন্য সামগ্রী API-এর তুলনায়, মার্চেন্ট এপিআই বিভিন্ন সুবিধা প্রদান করে।
সুস্পষ্ট তথ্য উৎস তৈরি. API আর স্বয়ংক্রিয়ভাবে আপনার প্রথম পণ্য সন্নিবেশে একটি "Content API" ডেটা উৎস তৈরি করে না। মার্চেন্ট এপিআই-এ, আপনি পণ্যগুলি আপলোড করার আগে স্পষ্টভাবে ডেটা উত্স তৈরি করেন। এটি আপনাকে শুরু থেকেই আপনার পণ্য ডেটা পাইপলাইনগুলির সংগঠন এবং পরিচালনার উপর আরও নিয়ন্ত্রণ দেয়।
একাধিক API ডেটা উত্সের জন্য সমর্থন। কেনাকাটার জন্য সামগ্রী API-তে, আপনি একটি একক, স্বয়ংক্রিয়ভাবে তৈরি "কন্টেন্ট API" ডেটা উত্সে সীমাবদ্ধ ছিলেন৷ মার্চেন্ট এপিআই দিয়ে আপনি
APIইনপুট টাইপের একাধিক ডেটা সোর্স তৈরি এবং পরিচালনা করতে পারেন।লেবেল এবং ভাষা ছাড়া ডেটা উত্স। Merchant API আপনাকে একটি
feedLabelএবংcontentLanguageউল্লেখ না করে একটি প্রাথমিক ডেটা উৎস তৈরি করতে দেয়। এই ধরনের ডেটা উৎসfeedLabelএবংcontentLanguageযেকোন সংমিশ্রণে পণ্যগুলিকে গ্রহণ করে, যা বিভিন্ন অঞ্চলের জন্য আলাদা ডেটা উত্সের প্রয়োজন হয় না এমন একীকরণের জন্য পণ্য আপলোডগুলিকে সহজ করে।সরলীকৃত ডেটা লক্ষ্যমাত্রা। প্রতিটি ডেটা উৎস এখন একটি একক লক্ষ্যের সাথে মিলে যায়, যা
feedLabelএবংcontentLanguageএর একটি অনন্য সমন্বয় দ্বারা সংজ্ঞায়িত হয়। মাল্টি-ডেটা টার্গেট ফিডগুলি মার্চেন্ট এপিআই-এ অবহেলিত।ডেডিকেটেড ফাইল আপলোড অবস্থা. মার্চেন্ট এপিআই একটি পৃথক, শুধুমাত্র-পঠনযোগ্য
fileUploadsসংস্থান ব্যবহার করে ফাইল-ভিত্তিক ডেটা উত্সের স্থিতি উপস্থাপন করে। একটি ফাইল আপলোডের স্থিতি পুনরুদ্ধার করতে,latestউপনাম সহfileUploads.getপদ্ধতিটি ব্যবহার করুন৷নতুন ডেটা সোর্স প্রকার।
DataSourceসংস্থান প্রচার, স্থানীয় ইনভেন্টরি এবং আঞ্চলিক ইনভেন্টরি সহ আরও উল্লম্ব সমর্থন করে, যা আপনার সমস্ত ডেটা পাইপলাইন পরিচালনা করার জন্য একীভূত উপায় প্রদান করে।স্বয়ংক্রিয় ডেটা উত্স। মার্চেন্ট এপিআই-এর মাধ্যমে, আপনি এখন অ্যাকাউন্ট সাব-এপিআই-এ
autofeedSettings.updateAutofeedSettingsপদ্ধতি ব্যবহার করে আপনার অ্যাকাউন্টের জন্য স্বয়ংক্রিয় ডেটা উত্স বৈশিষ্ট্য সক্রিয় বা নিষ্ক্রিয় করতে পারেন। আরও তথ্যের জন্য, Autofeed সেটিংস কনফিগার করুন দেখুন।
অনুরোধ
নিম্নলিখিত সারণীটি কেনাকাটার জন্য সামগ্রী API এবং মার্চেন্ট API-এর মধ্যে অনুরোধের URL ফর্ম্যাটগুলির তুলনা করে৷
| বিবরণ অনুরোধ করুন | কেনাকাটার জন্য সামগ্রী API | বণিক 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 ব্যবহার করুন। |
শনাক্তকারী
Merchant API শনাক্তকারী হিসাবে একটি স্ট্রিং-ভিত্তিক সম্পদের নাম ব্যবহার করে।
| শনাক্তকারীর বিবরণ | কেনাকাটার জন্য সামগ্রী API | বণিক API |
|---|---|---|
| ডেটা উৎস শনাক্তকারী | datafeedId (সংখ্যাসূচক) | name (স্ট্রিং, ফর্ম্যাট: accounts/{account}/dataSources/{datasource} ) |
পদ্ধতি
এই সারণীটি শপিং datafeeds এবং datafeedstatuses পরিষেবাগুলির জন্য সামগ্রী API-এর পদ্ধতিগুলিকে মার্চেন্ট 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 কল করুন৷ |
বিস্তারিত ক্ষেত্রের পরিবর্তন
এই সারণীটি কেনাকাটার জন্য সামগ্রী API-তে Datafeed এবং DatafeedStatus সংস্থান এবং মার্চেন্ট API-এ DataSource এবং FileUpload সংস্থানগুলির মধ্যে ফিল্ড-লেভেল পরিবর্তনগুলি দেখায়৷
| কেনাকাটার জন্য সামগ্রী API | বণিক 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 ) নির্দিষ্ট করে , আরও স্পষ্ট কনফিগারেশন প্রদান করে৷ |