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

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

মূল পার্থক্য

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

Request URL format

Request description Content API for Shopping Merchant API
Get product statistics and issues GET /content/v2.1/{merchantId}/accountstatuses/{accountId} GET /issueresolution/v1/accounts/{accountId}/aggregateProductStatuses

Identifiers

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

Identifier format

Identifier description Content API for Shopping Merchant API
Resource Identifier রিসোর্সটি accountId দ্বারা শনাক্ত করা হয়েছিল। কোয়েরি প্যারামিটার ব্যবহার করে নির্দিষ্ট ডেটা স্লাইস নির্বাচন করা হয়েছিল। রিসোর্স নামটি একটি নির্দিষ্ট রিপোর্টিং প্রেক্ষাপট এবং দেশের জন্য ডেটাকে অনন্যভাবে শনাক্ত করে: accounts/{account}/aggregateProductStatuses/{reportingContext}~{country}

পদ্ধতি

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

Content API for Shopping method Merchant API method Availability & notes
accountstatuses.get aggregateProductStatuses.list accountstatuses.get মেথডটি সমস্ত পণ্যের পরিসংখ্যান সম্বলিত একটি একক রিসোর্স ফেরত দিত। নতুন aggregateProductStatuses.list মেথডটি রিসোর্সের একটি তালিকা ফেরত দেয়, যেখানে প্রতিটি রিপোর্টিং কনটেক্সট এবং দেশের সমন্বয়ের জন্য একটি করে রিসোর্স থাকে। নির্দিষ্ট ডেটা পেতে filter প্যারামিটারটি ব্যবহার করুন। অ্যাকাউন্ট-স্তরের সমস্যার জন্য accountissues.list ব্যবহার করুন।

Detailed field changes

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

Content API for Shopping Merchant API বর্ণনা
products aggregate_product_statuses তালিকা প্রতিক্রিয়ায় products অ্যারেটি aggregate_product_statuses পুনরাবৃত্ত ফিল্ড দ্বারা প্রতিস্থাপিত হয়।
destination reporting_context destination ফিল্ডটি reporting_context দ্বারা প্রতিস্থাপিত হয়, যা stats-এর জন্য প্রোগ্রাম কনটেক্সট নির্দিষ্ট করে।
channel (no equivalent field) 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 The field numItems is renamed to product_count .