সমষ্টিগত পণ্য পরিসংখ্যান এবং সমস্যাগুলি পুনরুদ্ধার করার পদ্ধতি পরিবর্তিত হয়েছে। শপিংয়ের জন্য কন্টেন্ট API-তে accountstatuses রিসোর্সে পূর্বে উপলব্ধ কার্যকারিতা এখন Merchant API-তে ডেডিকেটেড রিসোর্সে বিভক্ত। এই নির্দেশিকাটি ব্যাখ্যা করে যে কীভাবে নতুন aggregateProductStatuses রিসোর্স ব্যবহার করার জন্য আপনার ইন্টিগ্রেশন স্থানান্তর করবেন।
দ্রষ্টব্য : মার্চেন্ট API-তে, অ্যাকাউন্ট-স্তরের সমস্যা এবং সামগ্রিক পণ্যের অবস্থা বিভক্ত করা হয়। accountstatuses থেকে অ্যাকাউন্ট সমস্যায় স্থানান্তর করার জন্য আমাদের নির্দেশিকাটিও পর্যালোচনা করুন।
মূল পার্থক্য
শপিংয়ের জন্য কন্টেন্ট এপিআই এবং মার্চেন্ট এপিআই-এর পণ্য স্থিতি বৈশিষ্ট্যগুলির মধ্যে মূল পার্থক্যগুলি এখানে দেওয়া হল:
- ডেডিকেটেড রিসোর্স : শপিংয়ের জন্য কন্টেন্ট এপিআই থেকে
accountstatusesরিসোর্স এখন বিভক্ত। মার্চেন্ট এপিআইতে, অ্যাকাউন্ট-স্তরের সমস্যাগুলিaccountissuesরিসোর্সের মাধ্যমে পাওয়া যায়, যেখানে সমষ্টিগত পণ্য পরিসংখ্যান এবং আইটেম-স্তরের সমস্যাগুলি নতুনaggregateProductStatusesরিসোর্সের মাধ্যমে পাওয়া যায়। - নতুন রিসোর্স কাঠামো :
AggregateProductStatusহল একটি নতুন রিসোর্স যা একটি রিপোর্টিং প্রেক্ষাপট এবং একটি দেশের নির্দিষ্ট সংমিশ্রণের জন্য পরিসংখ্যান এবং সমস্যাগুলি উপস্থাপন করে। - ফিল্টারিং মেকানিজম : ডেটা নির্বাচনের জন্য
destinationsমতো কোয়েরি প্যারামিটার ব্যবহার করার পরিবর্তে, মার্চেন্ট এপিআই নির্দিষ্ট রিপোর্টিং প্রসঙ্গ এবং দেশগুলির জন্য কোয়েরি করার জন্য একটিfilterস্ট্রিং সহ একটিlistপদ্ধতি ব্যবহার করে। - চ্যানেল ফিল্ড অপসারণ :
channelফিল্ডটি আর ব্যবহার করা হয় না। এই তথ্য এখন পরোক্ষভাবেreportingContextএর অংশ।
অনুরোধ
মার্চেন্ট API একত্রিত পণ্যের স্থিতি পুনরুদ্ধার করতে একটি filter প্যারামিটার সহ একটি GET অনুরোধ ব্যবহার করে।
GET https://merchantapi.googleapis.com/issueresolution/v1/{parent=accounts/*}/aggregateProductStatuses
URL ফর্ম্যাটের অনুরোধ করুন
| অনুরোধের বিবরণ | কেনাকাটার জন্য কন্টেন্ট API | মার্চেন্ট এপিআই |
|---|---|---|
| পণ্যের পরিসংখ্যান এবং সমস্যাগুলি পান | GET /content/v2.1/{merchantId}/accountstatuses/{accountId} | GET /issueresolution/v1/accounts/{accountId}/aggregateProductStatuses |
শনাক্তকারী
নতুন কাঠামোকে সমর্থন করার জন্য সম্পদ চিহ্নিত করার পদ্ধতি পরিবর্তন করা হয়েছে।
শনাক্তকারী বিন্যাস
| শনাক্তকারীর বর্ণনা | কেনাকাটার জন্য কন্টেন্ট API | মার্চেন্ট এপিআই |
|---|---|---|
| রিসোর্স আইডেন্টিফায়ার | রিসোর্সটি accountId দ্বারা শনাক্ত করা হয়েছিল। কোয়েরি প্যারামিটার সহ নির্দিষ্ট ডেটা স্লাইস নির্বাচন করা হয়েছিল। | রিসোর্সের নামটি একটি নির্দিষ্ট রিপোর্টিং প্রেক্ষাপট এবং দেশের জন্য ডেটা অনন্যভাবে সনাক্ত করে: accounts/{account}/aggregateProductStatuses/{reportingContext}~{country} । |
পদ্ধতি
পণ্যের স্থিতি পুনরুদ্ধারের পদ্ধতিটি একটি list পদ্ধতিতে আপডেট করা হয়েছে যা ফিল্টারিং সমর্থন করে।
| কেনাকাটা পদ্ধতির জন্য কন্টেন্ট API | মার্চেন্ট এপিআই পদ্ধতি | প্রাপ্যতা এবং নোট |
|---|---|---|
accountstatuses.get | aggregateProductStatuses.list | accountstatuses.get পদ্ধতিটি সমস্ত পণ্য পরিসংখ্যান সম্বলিত একটি একক রিসোর্স প্রদান করে। নতুন aggregateProductStatuses.list পদ্ধতিটি রিসোর্সের একটি তালিকা প্রদান করে, প্রতিটি রিপোর্টিং প্রসঙ্গ এবং দেশের সমন্বয়ের জন্য একটি করে। নির্দিষ্ট ডেটা পুনরুদ্ধার করতে filter প্যারামিটার ব্যবহার করুন। অ্যাকাউন্ট-স্তরের সমস্যার জন্য, accountissues.list ব্যবহার করুন। |
বিস্তারিত ক্ষেত্রের পরিবর্তন
নতুন AggregateProductStatus রিসোর্সে পণ্য পরিসংখ্যান এবং সমস্যাগুলির ক্ষেত্রগুলি আপডেট এবং পুনর্গঠন করা হয়েছে।
| কেনাকাটার জন্য কন্টেন্ট API | মার্চেন্ট এপিআই | বিবরণ |
|---|---|---|
products | aggregate_product_statuses | তালিকার প্রতিক্রিয়ায় products অ্যারেটি aggregate_product_statuses পুনরাবৃত্তি ক্ষেত্র দ্বারা প্রতিস্থাপিত হয়। |
destination | reporting_context | destination ক্ষেত্রটি reporting_context দ্বারা প্রতিস্থাপিত হয়, যা পরিসংখ্যানের জন্য প্রোগ্রামের প্রসঙ্গ নির্দিষ্ট করে। |
channel | (কোনও সমতুল্য ক্ষেত্র নেই) | channel ক্ষেত্রটি সরানো হয়েছে। এই তথ্যটি এখন reporting_context এর অংশ। |
statistics | stats | statistics অবজেক্টটির নাম পরিবর্তন করে stats করা হয়। এর মধ্যে থাকা ফিল্ডের নামগুলি snake_case তে রূপান্তরিত হয়, উদাহরণস্বরূপ, activeCount এখন active_count । |
itemLevelIssues.servability | item_level_issues.severity | কোনও সমস্যার প্রভাব বর্ণনা করার জন্য servability এনামকে severity এনাম দ্বারা প্রতিস্থাপিত করা হয়। |
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 রাখা হয়েছে। |