এগ্রিগেট প্রোডাক্ট স্ট্যাটাসে অ্যাকাউন্ট স্ট্যাটাস মাইগ্রেট করুন

পণ্যের সামগ্রিক পরিসংখ্যান এবং সমস্যাসমূহ পাওয়ার পদ্ধতি পরিবর্তিত হয়েছে। শপিং-এর জন্য কন্টেন্ট এপিআই-এর accountstatuses রিসোর্সে পূর্বে উপলব্ধ কার্যকারিতাটি এখন মার্চেন্ট এপিআই-এর ডেডিকেটেড রিসোর্সে বিভক্ত করা হয়েছে। এই নির্দেশিকাটি ব্যাখ্যা করে যে কীভাবে আপনার ইন্টিগ্রেশনকে নতুন aggregateProductStatuses রিসোর্স ব্যবহার করার জন্য মাইগ্রেট করবেন।

দ্রষ্টব্য : মার্চেন্ট এপিআই-তে, অ্যাকাউন্ট-স্তরের সমস্যা এবং সামগ্রিক পণ্যের স্ট্যাটাস আলাদা করা আছে। এছাড়াও, accountstatuses থেকে account issues- এ মাইগ্রেট করার জন্য আমাদের নির্দেশিকাটি পর্যালোচনা করুন।

মূল পার্থক্য

Content API for Shopping এবং Merchant API-এর প্রোডাক্ট স্ট্যাটাস ফিচারগুলোর মধ্যে প্রধান পার্থক্যগুলো নিচে দেওয়া হলো:

• নির্দিষ্ট রিসোর্স : শপিং-এর জন্য কন্টেন্ট এপিআই (Content API for Shopping)-এর accountstatuses রিসোর্সটি এখন বিভক্ত করা হয়েছে। মার্চেন্ট এপিআই (Merchant API)-তে, অ্যাকাউন্ট-স্তরের সমস্যাগুলো accountissues রিসোর্সের মাধ্যমে পাওয়া যাবে, অন্যদিকে একত্রিত পণ্যের পরিসংখ্যান এবং আইটেম-স্তরের সমস্যাগুলো নতুন aggregateProductStatuses রিসোর্সের মাধ্যমে পাওয়া যাবে।
• নতুন রিসোর্স কাঠামো : AggregateProductStatus হলো একটি নতুন রিসোর্স যা একটি রিপোর্টিং কনটেক্সট এবং একটি দেশের নির্দিষ্ট সমন্বয়ের পরিসংখ্যান ও সমস্যাগুলো উপস্থাপন করে।
• ফিল্টারিং পদ্ধতি : ডেটা নির্বাচনের জন্য destinations মতো কোয়েরি প্যারামিটার ব্যবহার করার পরিবর্তে, মার্চেন্ট এপিআই নির্দিষ্ট রিপোর্টিং কনটেক্সট এবং দেশগুলোর জন্য কোয়েরি করতে একটি filter স্ট্রিং সহ একটি list মেথড ব্যবহার করে।
• চ্যানেল ফিল্ড অপসারণ : channel ফিল্ডটি আর ব্যবহৃত হয় না। এই তথ্যটি এখন অন্তর্নিহিতভাবে reportingContext এর অংশ।

অনুরোধ

মার্চেন্ট এপিআই একত্রিত পণ্যের স্ট্যাটাসগুলো পুনরুদ্ধার করতে একটি filter প্যারামিটারসহ GET রিকোয়েস্ট ব্যবহার করে।

GET https://merchantapi.googleapis.com/issueresolution/v1/{parent=accounts/*}/aggregateProductStatuses

অনুরোধ URL ফরম্যাট

অনুরোধের বিবরণ	কেনাকাটার জন্য কন্টেন্ট এপিআই	মার্চেন্ট এপিআই
পণ্যের পরিসংখ্যান এবং সমস্যাগুলি জানুন	GET /content/v2.1/{merchantId}/accountstatuses/{accountId}	GET /issueresolution/v1/accounts/{accountId}/aggregateProductStatuses

শনাক্তকারী

নতুন কাঠামোকে সমর্থন করার জন্য সম্পদ চিহ্নিত করার পদ্ধতি পরিবর্তন করা হয়েছে।

শনাক্তকারী বিন্যাস

শনাক্তকারী বিবরণ	কেনাকাটার জন্য কন্টেন্ট এপিআই	মার্চেন্ট এপিআই
সম্পদ শনাক্তকারী	রিসোর্সটি accountId দ্বারা শনাক্ত করা হয়েছিল। কোয়েরি প্যারামিটার ব্যবহার করে নির্দিষ্ট ডেটা স্লাইস নির্বাচন করা হয়েছিল।	রিসোর্স নামটি একটি নির্দিষ্ট রিপোর্টিং প্রেক্ষাপট এবং দেশের জন্য ডেটাকে অনন্যভাবে শনাক্ত করে: accounts/{account}/aggregateProductStatuses/{reportingContext}~{country} ।

পদ্ধতি

পণ্যের স্ট্যাটাস পুনরুদ্ধার করার পদ্ধতিটিকে ফিল্টারিং সমর্থনসহ একটি list পদ্ধতিতে আপডেট করা হয়েছে।

শপিং পদ্ধতির জন্য কন্টেন্ট এপিআই	মার্চেন্ট এপিআই পদ্ধতি	প্রাপ্যতা ও নোট
accountstatuses.get	aggregateProductStatuses.list	accountstatuses.get মেথডটি সমস্ত পণ্যের পরিসংখ্যান সম্বলিত একটি একক রিসোর্স ফেরত দিত। নতুন aggregateProductStatuses.list মেথডটি রিসোর্সের একটি তালিকা ফেরত দেয়, যেখানে প্রতিটি রিপোর্টিং কনটেক্সট এবং দেশের সমন্বয়ের জন্য একটি করে রিসোর্স থাকে। নির্দিষ্ট ডেটা পেতে filter প্যারামিটারটি ব্যবহার করুন। অ্যাকাউন্ট-স্তরের সমস্যার জন্য accountissues.list ব্যবহার করুন।

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

নতুন AggregateProductStatus রিসোর্সে পণ্যের পরিসংখ্যান এবং সমস্যা সম্পর্কিত ফিল্ডগুলো হালনাগাদ ও পুনর্গঠন করা হয়েছে।

কেনাকাটার জন্য কন্টেন্ট এপিআই	মার্চেন্ট এপিআই	বর্ণনা
products	aggregate_product_statuses	তালিকা প্রতিক্রিয়ায় products অ্যারেটি aggregate_product_statuses পুনরাবৃত্ত ফিল্ড দ্বারা প্রতিস্থাপিত হয়।
destination	reporting_context	destination ফিল্ডটি reporting_context দ্বারা প্রতিস্থাপিত হয়, যা stats-এর জন্য প্রোগ্রাম কনটেক্সট নির্দিষ্ট করে।
channel	(সমতুল্য ক্ষেত্র নেই)	channel ফিল্ডটি সরিয়ে ফেলা হয়েছে। এই তথ্যটি এখন reporting_context এর অংশ।
statistics	stats	statistics অবজেক্টটির নাম পরিবর্তন করে stats রাখা হয়েছে। এর ভেতরের ফিল্ডের নামগুলো snake_case-এ রূপান্তরিত করা হয়েছে, উদাহরণস্বরূপ, activeCount এখন active_count হয়েছে।
itemLevelIssues.servability	item_level_issues.severity	কোনো সমস্যার প্রভাব বর্ণনা করার জন্য servability enum-কে severity enum দ্বারা প্রতিস্থাপন করা হয়।
itemLevelIssues.attributeName	item_level_issues.attribute	attributeName ফিল্ডটির নাম পরিবর্তন করে attribute রাখা হয়েছে।
itemLevelIssues.documentation	item_level_issues.documentation_uri	` documentation ফিল্ডটির নাম পরিবর্তন করে ` documentation_uri রাখা হয়েছে।
itemLevelIssues.numItems	item_level_issues.product_count	numItems ফিল্ডটির নাম পরিবর্তন করে product_count রাখা হয়েছে।