বণিক API আপনার পণ্য ডেটা পরিচালনা করার জন্য আরও শক্তিশালী এবং স্বজ্ঞাত উপায় প্রবর্তন করে। প্রধান পরিবর্তন হল দুটি স্বতন্ত্র সম্পদে পণ্যের ডেটা আলাদা করা: আপনার ডেটা জমা দেওয়ার জন্য ProductInput এবং প্রোডাক্ট স্ট্যাটাস এবং সমস্যা সহ চূড়ান্ত, প্রক্রিয়াকৃত সংস্করণ দেখার জন্য Product । এই নতুন কাঠামো আরও অনুমানযোগ্য এবং স্বচ্ছ অভিজ্ঞতা প্রদান করে।
কেনাকাটার জন্য সামগ্রী API থেকে আপনার ইন্টিগ্রেশন স্থানান্তর করতে সহায়তা করার জন্য এই নির্দেশিকা আপনাকে মূল পার্থক্যগুলির মধ্যে দিয়ে চলে। নতুন বৈশিষ্ট্যগুলি ব্যবহার করার জন্য একটি বিস্তারিত নির্দেশিকা দেখতে, আপনার পণ্যগুলি পরিচালনা করুন দেখুন৷
মূল পার্থক্য
কেনাকাটার জন্য সামগ্রী API-এর তুলনায় আপনি কীভাবে মার্চেন্ট API-এ পণ্যগুলি পরিচালনা করেন তার সবচেয়ে উল্লেখযোগ্য পরিবর্তনগুলি এখানে রয়েছে:
ইনপুট এবং প্রক্রিয়াকৃত ডেটার জন্য উত্সর্গীকৃত সংস্থান : মার্চেন্ট এপিআই পণ্য পরিচালনাকে দুটি সংস্থানে বিভক্ত করে। আপনি আপনার পণ্য ডেটা সন্নিবেশ, আপডেট এবং মুছে ফেলার জন্য
ProductInputসম্পদ ব্যবহার করতে পারেন। Google আপনার ইনপুট প্রক্রিয়াকরণ, নিয়ম প্রয়োগ এবং সম্পূরক উত্স থেকে ডেটা একত্রিত করার পরে আপনি চূড়ান্ত পণ্যটি দেখার জন্য শুধুমাত্র-পঠনযোগ্যProductসংস্থান ব্যবহার করতে পারেন।ইন্টিগ্রেটেড পণ্যের অবস্থা :
productstatusesপরিষেবা সরানো হয়। পণ্যের বৈধতা সংক্রান্ত সমস্যা এবং গন্তব্যের স্থিতিগুলি এখন সরাসরি পণ্যেরproductStatusক্ষেত্রের মধ্যেProductসম্পদে অন্তর্ভুক্ত করা হয়েছে, ডেটা পুনরুদ্ধারকে সহজ করে।অনুমানযোগ্য পণ্য আপডেট : নতুন
productInputs.patchপদ্ধতি একটি নির্দিষ্ট পণ্য ইনপুট সরাসরি পরিবর্তন করে। কেনাকাটার জন্য বিষয়বস্তু API-এর তুলনায় এটি একটি উল্লেখযোগ্য উন্নতি, যেখানে আপডেটগুলি অপ্রত্যাশিতভাবে অন্যান্য ফিড আপলোড দ্বারা ওভাররাইট হতে পারে৷ মার্চেন্ট এপিআই-এ, নির্দিষ্ট পণ্যের ইনপুটটি আবার আপডেট করা বা মুছে ফেলা না হওয়া পর্যন্ত একটি আপডেট থাকে। প্রোডাক্ট আপডেটProductInputরিসোর্সে প্রসেসডProductরিসোর্সের পরিবর্তে প্রয়োগ করা হয়।ক্লিনার ডাটা ম্যানেজমেন্টের জন্য আপনার ডেটা সোর্স বেছে নিন : সমস্ত
productInputsলেখার ক্রিয়াকলাপের জন্য এখন একটিdataSourceক্যোয়ারী প্যারামিটার প্রয়োজন, এটি স্পষ্ট করে যে আপনি কোন ডেটা সোর্স পরিবর্তন করছেন। এটি বিশেষভাবে উপযোগী যদি আপনার কাছে একাধিক উৎস ডেটা প্রদান করে থাকে।নতুন রিসোর্স আইডেন্টিফায়ার :
idফিল্ডের পরিবর্তে পণ্যগুলিকে এখন একটি RESTful রিসোর্সnameদ্বারা চিহ্নিত করা হয়৷ বিন্যাস হলaccounts/{account}/products/{product}।কাস্টম ব্যাচ নেই :
custombatchপদ্ধতি আর উপলব্ধ নেই। আপনি একটি একক HTTP কলে একাধিক অনুরোধ পাঠাতে অ্যাসিঙ্ক্রোনাস অনুরোধ বা HTTP ব্যাচিং ব্যবহার করতে পারেন।যেকোন ফিড লেবেল এবং ভাষার জন্য ডেটা সোর্স : মার্চেন্ট এপিআই ফিড লেবেল এবং ভাষা নির্দিষ্ট না করেই ডেটা সোর্স তৈরি করা সম্ভব করে এবং তাই যেকোন ফিড লেবেল এবং ভাষার সাথে প্রোডাক্ট ঢোকানোর অনুমতি দেয়।
অনুরোধ
এই বিভাগটি শপিং এবং মার্চেন্ট API-এর জন্য সামগ্রী API-এর অনুরোধের ফর্ম্যাটগুলির তুলনা করে।
| বিবরণ অনুরোধ করুন | কেনাকাটার জন্য সামগ্রী API | বণিক API |
|---|---|---|
| একটি পণ্য পান | GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId} | GET https://merchantapi.googleapis.com/products/v1/accounts/{account}/products/{product} |
| পণ্য তালিকা | GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products | GET https://merchantapi.googleapis.com/products/v1/accounts/{account}/products |
| একটি পণ্য সন্নিবেশ | POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products | POST https://merchantapi.googleapis.com/products/v1/accounts/{account}/productInputs:insert |
| একটি পণ্য আপডেট করুন | PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId} | PATCH https://merchantapi.googleapis.com/products/v1/accounts/{account}/productInputs/{productinput} |
| একটি পণ্য মুছুন | DELETE https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId} | DELETE https://merchantapi.googleapis.com/products/v1/accounts/{account}/productInputs/{productinput} |
| পণ্যের অবস্থা পান | GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/productstatuses/{productId} | GET https://merchantapi.googleapis.com/products/v1/accounts/{account}/products/{product} |
| পণ্য স্থিতি তালিকা | GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/productstatuses | GET https://merchantapi.googleapis.com/products/v1/accounts/{account}/products |
| ব্যাচ একাধিক অনুরোধ | POST https://shoppingcontent.googleapis.com/content/v2.1/products/custombatch | অ্যাসিঙ্ক্রোনাস অনুরোধ, HTTP ব্যাচিং |
শনাক্তকারী
পণ্য শনাক্তকারীর ফর্ম্যাটটি মার্চেন্ট API-এ একটি আদর্শ REST রিসোর্স নামে পরিবর্তিত হয়েছে।
| শনাক্তকারীর বিবরণ | কেনাকাটার জন্য সামগ্রী API | বণিক API |
|---|---|---|
| পণ্য আইডি | একটি স্ট্রিং একটি কোলন ( : ) দ্বারা বিভক্ত অংশগুলির সমন্বয়ে গঠিত।বিন্যাস: channel:contentLanguage:targetCountry:offerId বা channel:contentLanguage:feedLabel:offerId ।উদাহরণ: online:en:US:sku123 | একটি REST সম্পদ name স্ট্রিং।বিন্যাস: accounts/{account}/products/{product} যেখানে {product} হল contentLanguage~feedLabel~offerIdউদাহরণ: accounts/12345/products/en~US~sku123 |
পদ্ধতি
এই টেবিলটি ব্যবসায়িক API-এ কেনাকাটার পদ্ধতি এবং তাদের সমতুল্যগুলির জন্য সামগ্রী API দেখায়।
| শপিং পদ্ধতির জন্য সামগ্রী API | মার্চেন্ট API পদ্ধতি | প্রাপ্যতা এবং নোট |
|---|---|---|
products.get | products.get | চূড়ান্ত, প্রক্রিয়াজাত পণ্য পুনরুদ্ধার করে। |
products.list | products.list | চূড়ান্ত, প্রক্রিয়াজাত পণ্য তালিকা. |
products.insert | productInputs.insert | একটি পণ্য ইনপুট সন্নিবেশ করান। একটি dataSource প্রয়োজন। |
products.update | productInputs.update | আচরণ উল্লেখযোগ্যভাবে ভিন্ন। এটি একটি নির্দিষ্ট পণ্য ইনপুট আপডেট করে এবং স্থায়ী হয়। |
products.delete | productInputs.delete | একটি নির্দিষ্ট পণ্য ইনপুট মুছে দেয়। একটি dataSource প্রয়োজন। |
products.custombatch | পাওয়া যায় না | অ্যাসিঙ্ক্রোনাস অনুরোধ বা HTTP ব্যাচিং ব্যবহার করুন। |
productstatuses.get | products.get | productstatuses পরিষেবা সরানো হয়. স্থিতি তথ্য এখন Product সম্পদের অংশ. |
productstatuses.list | products.list | productstatuses পরিষেবা সরানো হয়. স্থিতি তথ্য এখন Product সম্পদের অংশ. |
productstatuses.custombatch | পাওয়া যায় না | [অসিঙ্ক্রোনাস ব্যবহার করুন |
অনুরোধ](/merchant/api/samples/insert-product-input-async) বা HTTP ব্যাচিং । |
বিস্তারিত ক্ষেত্রের পরিবর্তন
এই সারণীটি গুরুত্বপূর্ণ ক্ষেত্রগুলিকে হাইলাইট করে যা মার্চেন্ট এপিআই-তে পরিবর্তিত, যোগ করা বা সরানো হয়েছে।
| কেনাকাটার জন্য সামগ্রী API | বণিক API | বর্ণনা |
|---|---|---|
id | name | একটি পণ্যের প্রাথমিক শনাক্তকারী এখন REST সম্পদের name । |
শীর্ষ-স্তরের পণ্য ডেটা স্পেসিফিকেশন বৈশিষ্ট্য (যেমন, title , price , link ) | productAttributes বস্তু | title , price এবং link মতো পণ্যের বৈশিষ্ট্যগুলি আর শীর্ষ-স্তরের ক্ষেত্র নয়৷ সেগুলি এখন productAttributes অবজেক্টের মধ্যে Product এবং ProductInput রিসোর্স উভয়ের মধ্যেই গোষ্ঠীবদ্ধ। এটি একটি পরিষ্কার এবং আরও সংগঠিত সংস্থান কাঠামো সরবরাহ করে। |
targetCountry | feedLabel | বণিক কেন্দ্র কার্যকারিতার সাথে সারিবদ্ধ করতে সংস্থান নামটি এখন targetCountry এর পরিবর্তে feedLabel ব্যবহার করে। |
feedId | dataSource (কোয়েরি প্যারামিটার) | একটি dataSource নাম এখন সমস্ত productInputs লেখার পদ্ধতির জন্য একটি প্রয়োজনীয় ক্যোয়ারী প্যারামিটার ( insert , update , delete )। |
channel | পাওয়া যায় না। শুধুমাত্র স্থানীয় পণ্যের জন্য legacy_local ব্যবহার করুন। | channel ক্ষেত্রটি মার্চেন্ট API-এ আর উপস্থিত নেই। কেনাকাটার জন্য সামগ্রী API-তে LOCAL চ্যানেল সহ পণ্যগুলির পরিবর্তে legacy_local ক্ষেত্র সত্যে সেট করা উচিত৷ |
| পাওয়া যায় না | versionNumber | ProductInput একটি নতুন ঐচ্ছিক ক্ষেত্র যা প্রাথমিক ডেটা উত্সগুলিতে অর্ডার বহির্ভূত সন্নিবেশ রোধ করতে ব্যবহার করা যেতে পারে। |
সংজ্ঞায়িত মান সেট সহ string ধরনের ক্ষেত্র | মানগুলির সংজ্ঞায়িত সেট সহ enum টাইপ ক্ষেত্র | মানগুলির সংজ্ঞায়িত সেট সহ পণ্য বৈশিষ্ট্যগুলির মধ্যে ক্ষেত্রগুলি (উদাহরণস্বরূপ excluded_destinations , availability ) এখন enum প্রকার। |