আপনি যেভাবে অ্যাকাউন্ট-স্তরের সমস্যাগুলি পুনরুদ্ধার করবেন যা আপনার পণ্য এবং অ্যাকাউন্টের স্বাস্থ্যকে প্রভাবিত করতে পারে তা পরিবর্তিত হয়েছে। কেনাকাটার জন্য সামগ্রী API-তে accountstatuses রিসোর্সের তুলনায়, Merchant API একটি ডেডিকেটেড AccountIssue রিসোর্স প্রবর্তন করে যা আরও কাঠামোগত এবং বিশদ তথ্য প্রদান করে।
নতুন বৈশিষ্ট্যটি কীভাবে ব্যবহার করবেন সে সম্পর্কে আরও তথ্যের জন্য, দেখুন অ্যাকাউন্ট সমস্যা নির্দেশিকা দেখুন।
দ্রষ্টব্য : মার্চেন্ট এপিআই-এ, অ্যাকাউন্ট-স্তরের সমস্যা এবং মোট পণ্যের অবস্থা বিভক্ত করা হয়। এছাড়াও accountstatuses থেকে সামগ্রিক পণ্যের স্থিতিতে স্থানান্তর করার জন্য আমাদের গাইড পর্যালোচনা করুন।
মূল পার্থক্য
এখানে মার্চেন্ট এপিআই AccountIssue রিসোর্সের মূল উন্নতি এবং পার্থক্যগুলি রয়েছে:
- উত্সর্গীকৃত সংস্থান: অ্যাকাউন্টের সমস্যাগুলি তাদের নিজস্ব সংস্থান। কেনাকাটার জন্য সামগ্রী API-তে, অ্যাকাউন্ট-স্তরের সমস্যাগুলি সাধারণ
AccountStatusসংস্থানের মধ্যে একটি নেস্টেড ক্ষেত্র ছিল। Merchant API-এর মাধ্যমে আপনিaccounts.issues.listপদ্ধতি ব্যবহার করে সরাসরি তাদের তালিকা করতে পারেন। - স্ট্রাকচার্ড ইমপ্যাক্ট ডেটা:
AccountIssueরিসোর্স একটি বিস্তারিতimpactedDestinationsক্ষেত্র প্রদান করে। এই ফিল্ডটি আপনাকে গন্তব্য (উদাহরণস্বরূপ, শপিং বিজ্ঞাপন), নির্দিষ্ট অঞ্চল এবং সেই অঞ্চলে সমস্যার তীব্রতা সহ একটি সমস্যার প্রভাবের একটি স্পষ্ট বিভাজন দেয়। - এনাম হিসাবে তীব্রতা:
severityক্ষেত্রটি এখন একটি এনাম (CRITICAL,ERROR,SUGGESTIONমতো মান সহ), শপিংয়ের জন্য সামগ্রী API-তে স্ট্রিং-ভিত্তিক মানের তুলনায় প্রোগ্রাম্যাটিকভাবে প্রক্রিয়া করা সহজ করে তোলে। - স্ট্যান্ডার্ডাইজড আইডেন্টিফায়ার: প্রতিটি অ্যাকাউন্ট ইস্যুর ফর্ম্যাটে
accounts/{ACCOUNT_ID}/issues/{ISSUE_ID}এ একটি অনন্য, সম্পূর্ণ রিসোর্সnameথাকে। এই প্রমিত পদ্ধতি শপিংয়ের জন্য সামগ্রী API থেকেidস্ট্রিং প্রতিস্থাপন করে। - স্থানীয়করণ সমর্থন:
accounts.issues.listপদ্ধতি আপনাকে আপনার পছন্দের ভাষায় শিরোনাম এবং বিবরণের মতো সমস্যার বিবরণ পেতে একটিlanguage_codeনির্দিষ্ট করতে দেয়। কেনাকাটার জন্য সামগ্রী API-তে এটি সম্ভব ছিল না। - উন্নত অ্যাকাউন্ট আচরণ: আপনি যখন একটি উন্নত অ্যাকাউন্টে
accounts.issues.listকল করেন, তখন এটি শুধুমাত্র সেই উন্নত অ্যাকাউন্টে সরাসরি প্রযোজ্য সমস্যা ফেরত দেয়। এটি এর কোনো উপ-অ্যাকাউন্টের জন্য সমস্যা ফেরত দেয় না। কেনাকাটার জন্য বিষয়বস্তু API-এ,accountstatuses.listপদ্ধতিটি সমস্ত সাব-অ্যাকাউন্টের স্ট্যাটাস ফিরিয়ে দেবে। মার্চেন্ট এপিআই-এ সমস্ত সাব-অ্যাকাউন্টের সমস্যা পেতে, আপনাকে অবশ্যইaccounts.listSubaccountsকল করতে হবে এবং তারপর প্রতিটি সাব-অ্যাকাউন্টের জন্যaccounts.issues.listকল করতে হবে।
অনুরোধ
মার্চেন্ট এপিআই-এ, আপনি একটি নির্দিষ্ট মার্চেন্ট সেন্টার অ্যাকাউন্টের জন্য অ্যাকাউন্ট সংক্রান্ত সমস্যাগুলি তালিকাভুক্ত করতে পারেন।
GET https://merchantapi.googleapis.com/accounts/v1/accounts/ACCOUNT_ID/issues
URL তুলনা অনুরোধ
| বিবরণ অনুরোধ করুন | কেনাকাটার জন্য সামগ্রী API | বণিক API |
|---|---|---|
| একটি একক অ্যাকাউন্টের জন্য অ্যাকাউন্ট-স্তরের সমস্যাগুলি তালিকাভুক্ত করুন | GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/accountstatuses/{ACCOUNT_ID} | GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/issues |
| একটি উন্নত অ্যাকাউন্টের সমস্ত উপ-অ্যাকাউন্টের জন্য অ্যাকাউন্ট-স্তরের সমস্যাগুলি তালিকাভুক্ত করুন | GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/accountstatuses | পাওয়া যায় না। আপনাকে সাব-অ্যাকাউন্টের মাধ্যমে পুনরাবৃত্তি করতে হবে। |
শনাক্তকারী
মার্চেন্ট এপিআই-এ অ্যাকাউন্ট এবং সমস্যার শনাক্তকারী পরিবর্তিত হয়েছে।
শনাক্তকারী তুলনা
| শনাক্তকারীর বিবরণ | কেনাকাটার জন্য সামগ্রী API | বণিক API |
|---|---|---|
| অ্যাকাউন্ট শনাক্তকারী | পাথ প্যারামিটার হিসেবে {MERCHANT_ID} এবং {ACCOUNT_ID} । | ফর্ম্যাট অ্যাকাউন্টে পাথ প্যারামিটার হিসেবে {ACCOUNT_ID} accounts/{ACCOUNT_ID} । |
| সমস্যা শনাক্তকারী | প্রতিক্রিয়া বডিতে id ক্ষেত্র (উদাহরণস্বরূপ, "products-that-enable-dishonest-behavior-hacking-policy" )। | রেসপন্স বডিতে name ক্ষেত্র, যা সম্পূর্ণ রিসোর্স নাম (উদাহরণস্বরূপ, accounts/12345/issues/example-issue-id )। |
পদ্ধতি
মার্চেন্ট এপিআই-এ অ্যাকাউন্টের সমস্যা পুনরুদ্ধারের পদ্ধতিগুলি একত্রিত এবং সরলীকৃত করা হয়েছে।
পদ্ধতির তুলনা
| কেনাকাটার জন্য সামগ্রী API | বণিক API | প্রাপ্যতা এবং নোট |
|---|---|---|
accountstatuses.get | accounts.issues.list | পাওয়া যায়। একটি অ্যাকাউন্টের জন্য সমস্যা পেতে, accounts.issues.list ব্যবহার করুন এবং অ্যাকাউন্ট আইডি উল্লেখ করুন। মার্চেন্ট এপিআই একটি একক সমস্যার জন্য একটি get পদ্ধতি নেই. |
accountstatuses.list | কোন সরাসরি সমতুল্য. | পাওয়া যায় না। Merchant API-এর accounts.issues.list পদ্ধতি শুধুমাত্র নির্দিষ্ট অ্যাকাউন্টের জন্য সমস্যা দেখায়, এর সাব-অ্যাকাউন্ট নয়। সমস্ত সাব-অ্যাকাউন্টের সমস্যা পেতে, আপনাকে প্রথমে accounts.listSubaccounts এবং তারপর প্রতিটি সাব-অ্যাকাউন্টের জন্য accounts.issues.list কল করতে হবে। |
accountstatuses.custombatch | কোন সরাসরি সমতুল্য. | পাওয়া যায় না। অ্যাকাউন্ট সংক্রান্ত সমস্যার জন্য ব্যাচ প্রসেসিং মার্চেন্ট এপিআই-এ সমর্থিত নয়। প্রতিটি অ্যাকাউন্টের জন্য আপনাকে অবশ্যই পৃথক list কল করতে হবে। |
বিস্তারিত ক্ষেত্রের পরিবর্তন
অ্যাকাউন্ট ইস্যু রিসোর্সের মধ্যে ক্ষেত্রগুলিকে আরও কাঠামো এবং স্পষ্টতা প্রদানের জন্য আপডেট করা হয়েছে।
ক্ষেত্রের তুলনা
| কেনাকাটার জন্য সামগ্রী API | বণিক API | বর্ণনা |
|---|---|---|
accountLevelIssues ( AccountStatus এ অ্যারে) | accountIssues ( ListAccountIssuesResponse এ অ্যারে) | সমস্যাগুলি এখন একটি নিবেদিত, শীর্ষ-স্তরের সংস্থান, নেস্টেড ক্ষেত্র নয়। |
id (স্ট্রিং) | name (স্ট্রিং) | সমস্যা শনাক্তকারী এখন একটি সম্পূর্ণ সম্পদের নাম, উদাহরণস্বরূপ accounts/{ACCOUNT_ID}/issues/{ISSUE_ID} । |
title (স্ট্রিং) | title (স্ট্রিং) | কোন পরিবর্তন নেই। |
detail (স্ট্রিং) | detail (স্ট্রিং) | কোন পরিবর্তন নেই। |
documentation (স্ট্রিং) | documentationUri (স্ট্রিং) | এটি একটি URL নির্দেশ করার জন্য স্পষ্টতার জন্য ক্ষেত্রটির নাম পরিবর্তন করা হয়েছে৷ |
severity (স্ট্রিং) | severity (enum) | তীব্রতা এখন একটি স্ট্রিং এর পরিবর্তে একটি কাঠামোগত enum ( CRITICAL , ERROR , SUGGESTION )। |
country (স্ট্রিং), destination (স্ট্রিং) | impactedDestinations (পুনরাবৃত্ত বার্তা) | প্রভাব এখন একটি তালিকায় গঠন করা হয়েছে, প্রতিটি প্রভাবিত এলাকার জন্য গন্তব্য, অঞ্চল এবং তীব্রতাকে গোষ্ঠীবদ্ধ করে। country ক্ষেত্রটি Impact বার্তার মধ্যে regionCode দ্বারা প্রতিস্থাপিত হয়। |
| (উপলভ্য নয়) | language_code , time_zone (অনুরোধ প্যারামিটার) | list অনুরোধে নতুন প্যারামিটারগুলি title এবং detail মতো মানব-পাঠযোগ্য ক্ষেত্রগুলির স্থানীয়করণের অনুমতি দেয়৷ |