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