অ্যাকাউন্ট স্ট্যাটাস থেকে অ্যাকাউন্ট ইস্যুতে স্থানান্তর করুন

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

নতুন ফিচারটি কীভাবে ব্যবহার করবেন সে সম্পর্কে আরও তথ্যের জন্য, ‘অ্যাকাউন্টের সমস্যা দেখুন’ নির্দেশিকাটি দেখুন।

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

মূল পার্থক্য

মার্চেন্ট এপিআই-এর AccountIssue রিসোর্সের প্রধান উন্নতি ও পার্থক্যগুলো নিচে দেওয়া হলো:

  • নির্দিষ্ট রিসোর্স: অ্যাকাউন্ট সংক্রান্ত সমস্যাগুলো একটি স্বতন্ত্র রিসোর্স। Content API for Shopping-এ, অ্যাকাউন্ট-স্তরের সমস্যাগুলো সাধারণ AccountStatus রিসোর্সের মধ্যে একটি নেস্টেড ফিল্ড ছিল। Merchant API-এর মাধ্যমে আপনি accounts.issues.list মেথড ব্যবহার করে সরাসরি সেগুলোর তালিকা দেখতে পারেন।
  • কাঠামোগত প্রভাব ডেটা: AccountIssue রিসোর্সটি একটি বিস্তারিত impactedDestinations ফিল্ড প্রদান করে। এই ফিল্ডটি আপনাকে একটি ইস্যুর প্রভাবের সুস্পষ্ট বিভাজন দেয়, যার মধ্যে রয়েছে গন্তব্য (উদাহরণস্বরূপ, শপিং বিজ্ঞাপন), নির্দিষ্ট অঞ্চল এবং সেই অঞ্চলে ইস্যুটির তীব্রতা।
  • enum হিসেবে Severity: severity ফিল্ডটি এখন একটি enum (যার ভ্যালুগুলো হলো CRITICAL , ERROR , SUGGESTION ), যা Content API for Shopping-এর স্ট্রিং-ভিত্তিক ভ্যালুগুলোর তুলনায় প্রোগ্রাম্যাটিকভাবে প্রসেস করাকে আরও সহজ করে তোলে।
  • প্রমিত শনাক্তকারী: প্রতিটি অ্যাকাউন্ট ইস্যুর একটি অনন্য, পূর্ণাঙ্গ রিসোর্স name থাকে, যা accounts/{ACCOUNT_ID}/issues/{ISSUE_ID} ফরম্যাটে থাকে। এই প্রমিত পদ্ধতিটি Content API for Shopping-এর id স্ট্রিং-কে প্রতিস্থাপন করে।
  • স্থানীয়করণ সমর্থন: accounts.issues.list মেথডটি আপনাকে একটি language_code নির্দিষ্ট করার সুযোগ দেয়, যার মাধ্যমে আপনি ইস্যুর বিবরণ, যেমন শিরোনাম এবং বর্ণনা, আপনার পছন্দের ভাষায় পেতে পারেন। Content API for Shopping-এ এটি সম্ভব ছিল না।
  • অ্যাডভান্সড অ্যাকাউন্টের আচরণ: যখন আপনি কোনো অ্যাডভান্সড অ্যাকাউন্টে accounts.issues.list কল করেন, তখন এটি শুধুমাত্র সেই ইস্যুগুলোই রিটার্ন করে যা সরাসরি সেই অ্যাডভান্সড অ্যাকাউন্টের জন্য প্রযোজ্য। এটি এর কোনো সাব-অ্যাকাউন্টের জন্য ইস্যু রিটার্ন করে না। Content API for Shopping-এ, accountstatuses.list মেথডটি সমস্ত সাব-অ্যাকাউন্টের স্ট্যাটাস রিটার্ন করত। Merchant API-তে সমস্ত সাব-অ্যাকাউন্টের জন্য ইস্যু পেতে হলে, আপনাকে প্রথমে accounts.listSubaccounts কল করতে হবে এবং তারপর প্রতিটি সাব-অ্যাকাউন্টের জন্য আলাদাভাবে accounts.issues.list কল করতে হবে।

অনুরোধ

মার্চেন্ট এপিআই-তে, আপনি একটি নির্দিষ্ট মার্চেন্ট সেন্টার অ্যাকাউন্টের সমস্যাগুলো তালিকাভুক্ত করতে পারেন।

GET https://merchantapi.googleapis.com/accounts/v1/accounts/ACCOUNT_ID/issues

অনুরোধ URL তুলনা

অনুরোধের বিবরণ কেনাকাটার জন্য কন্টেন্ট এপিআই মার্চেন্ট এপিআই
একটি অ্যাকাউন্টের জন্য অ্যাকাউন্ট-স্তরের সমস্যাগুলির তালিকা 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 উপলব্ধ নয়। আপনাকে সাব-অ্যাকাউন্টগুলোর মধ্যে দিয়ে পুনরাবৃত্তি করতে হবে।

শনাক্তকারী

মার্চেন্ট এপিআই-তে অ্যাকাউন্ট এবং ইস্যুগুলোর শনাক্তকারী পরিবর্তিত হয়েছে।

শনাক্তকারী তুলনা

শনাক্তকারী বিবরণ কেনাকাটার জন্য কন্টেন্ট এপিআই মার্চেন্ট এপিআই
অ্যাকাউন্ট শনাক্তকারী {MERCHANT_ID} এবং {ACCOUNT_ID} পাথ প্যারামিটার হিসেবে। {ACCOUNT_ID} accounts/{ACCOUNT_ID} ফরম্যাটে একটি পাথ প্যারামিটার হিসেবে ব্যবহার করতে হবে।
সমস্যা শনাক্তকারী রেসপন্স বডিতে id ফিল্ড (উদাহরণস্বরূপ, "products-that-enable-dishonest-behavior-hacking-policy" )। রেসপন্স বডিতে থাকা name ফিল্ড, যা হলো সম্পূর্ণ রিসোর্স নেম (উদাহরণস্বরূপ, accounts/12345/issues/example-issue-id )।

পদ্ধতি

মার্চেন্ট এপিআই-তে অ্যাকাউন্ট সংক্রান্ত সমস্যা সমাধানের পদ্ধতিগুলোকে একত্রিত ও সরল করা হয়েছে।

পদ্ধতির তুলনা

কেনাকাটার জন্য কন্টেন্ট এপিআই মার্চেন্ট এপিআই প্রাপ্যতা ও নোট
accountstatuses.get accounts.issues.list উপলব্ধ। একটিমাত্র অ্যাকাউন্টের ইস্যুগুলো পেতে, accounts.issues.list ব্যবহার করুন এবং অ্যাকাউন্ট আইডি উল্লেখ করুন। মার্চেন্ট এপিআই-তে একটিমাত্র ইস্যুর জন্য কোনো get মেথড নেই।
accountstatuses.list সরাসরি কোনো সমতুল্য নেই। উপলব্ধ নয়। মার্চেন্ট এপিআই-এর accounts.issues.list মেথডটি শুধুমাত্র নির্দিষ্ট অ্যাকাউন্টের ইস্যুগুলো রিটার্ন করে, এর সাব-অ্যাকাউন্টগুলোর নয়। সমস্ত সাব-অ্যাকাউন্টের ইস্যু পেতে হলে, আপনাকে প্রথমে accounts.listSubaccounts কল করতে হবে এবং তারপর প্রতিটি সাব-অ্যাকাউন্টের জন্য accounts.issues.list কল করতে হবে।
accountstatuses.custombatch সরাসরি কোনো সমতুল্য নেই। উপলব্ধ নয়। মার্চেন্ট এপিআই-তে অ্যাকাউন্ট সংক্রান্ত সমস্যার জন্য ব্যাচ প্রসেসিং সমর্থিত নয়। আপনাকে প্রতিটি অ্যাকাউন্টের জন্য আলাদাভাবে list কল করতে হবে।

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

অ্যাকাউন্ট সমস্যা রিসোর্সের অন্তর্ভুক্ত ফিল্ডগুলোকে আরও সুসংগঠিত ও সুস্পষ্ট করার জন্য আপডেট করা হয়েছে।

ক্ষেত্র তুলনা

কেনাকাটার জন্য কন্টেন্ট এপিআই মার্চেন্ট এপিআই বর্ণনা
accountLevelIssues ( AccountStatus এর অ্যারে) accountIssues ( ListAccountIssuesResponse এর অ্যারে) ইস্যুগুলো এখন একটি স্বতন্ত্র, শীর্ষ-স্তরের রিসোর্স, কোনো নেস্টেড ফিল্ড নয়।
id (স্ট্রিং) name (স্ট্রিং) ইস্যু আইডেন্টিফায়ার এখন একটি সম্পূর্ণ রিসোর্স নাম, যেমন accounts/{ACCOUNT_ID}/issues/{ISSUE_ID} ।
title (স্ট্রিং) title (স্ট্রিং) কোনো পরিবর্তন নেই।
detail (স্ট্রিং) detail (স্ট্রিং) কোনো পরিবর্তন নেই।
documentation (স্ট্রিং) documentationUri (স্ট্রিং) এটি যে একটি URL, তা স্পষ্ট করার জন্য ফিল্ডটির নাম পরিবর্তন করা হয়েছে।
severity (স্ট্রিং) severity (এনাম) গুরুত্ব এখন স্ট্রিং-এর পরিবর্তে একটি স্ট্রাকচার্ড এনাম ( CRITICAL , ERROR , SUGGESTION )।
country (স্ট্রিং), destination (স্ট্রিং) impactedDestinations (পুনরাবৃত্ত বার্তা) ইমপ্যাক্ট এখন একটি তালিকা আকারে সাজানো হয়েছে, যেখানে প্রতিটি প্রভাবিত এলাকার গন্তব্য, অঞ্চল এবং তীব্রতাকে শ্রেণিবদ্ধ করা হয়েছে। Impact মেসেজের মধ্যে country ফিল্ডটি regionCode দ্বারা প্রতিস্থাপিত হয়েছে।
(উপলব্ধ নয়) language_code , time_zone (অনুরোধের প্যারামিটার) list অনুরোধের নতুন প্যারামিটারগুলো title এবং detail মতো পাঠযোগ্য ক্ষেত্রগুলোর স্থানীয়করণ করার সুযোগ দেয়।
পূর্ববর্তী
Overview
পরবর্তী
Migrate accountstatuses to Aggregate Product Statuses