আপনার পণ্য এবং অ্যাকাউন্টের স্বাস্থ্যের উপর প্রভাব ফেলতে পারে এমন অ্যাকাউন্ট-স্তরের সমস্যাগুলি পুনরুদ্ধার করার পদ্ধতি পরিবর্তিত হয়েছে। শপিংয়ের জন্য কন্টেন্ট API-তে accountstatuses রিসোর্সের তুলনায়, Merchant API একটি ডেডিকেটেড AccountIssue রিসোর্স প্রবর্তন করে যা আরও কাঠামোগত এবং বিস্তারিত তথ্য প্রদান করে।
নতুন বৈশিষ্ট্যটি কীভাবে ব্যবহার করবেন সে সম্পর্কে আরও তথ্যের জন্য, অ্যাকাউন্ট সমস্যা দেখুন নির্দেশিকাটি দেখুন।
দ্রষ্টব্য : মার্চেন্ট API-তে, অ্যাকাউন্ট-স্তরের সমস্যা এবং সমষ্টিগত পণ্যের স্থিতি বিভক্ত করা হয়। এছাড়াও accountstatuses থেকে সমষ্টিগত পণ্যের স্থিতিগুলিতে স্থানান্তর করার জন্য আমাদের নির্দেশিকাটি পর্যালোচনা করুন।
মূল পার্থক্য
Merchant API AccountIssue রিসোর্সের মূল উন্নতি এবং পার্থক্যগুলি এখানে দেওয়া হল:
- ডেডিকেটেড রিসোর্স: অ্যাকাউন্টের সমস্যাগুলি তাদের নিজস্ব রিসোর্স। কন্টেন্ট এপিআই ফর শপিং-এ, অ্যাকাউন্ট-স্তরের সমস্যাগুলি সাধারণ
AccountStatusরিসোর্সের মধ্যে একটি নেস্টেড ফিল্ড ছিল। মার্চেন্ট এপিআই দিয়ে আপনিaccounts.issues.listপদ্ধতি ব্যবহার করে সরাসরি তাদের তালিকাভুক্ত করতে পারেন। - স্ট্রাকচার্ড ইমপ্যাক্ট ডেটা:
AccountIssueরিসোর্সটি একটি বিস্তারিতimpactedDestinationsফিল্ড প্রদান করে। এই ফিল্ডটি আপনাকে একটি সমস্যার প্রভাবের স্পষ্ট বিশ্লেষণ দেয়, যার মধ্যে রয়েছে গন্তব্য (যেমন, শপিং বিজ্ঞাপন), নির্দিষ্ট অঞ্চল এবং সেই অঞ্চলে সমস্যার তীব্রতা। - Enum হিসেবে তীব্রতা:
severityক্ষেত্রটি এখন একটি enum (CRITICAL,ERROR,SUGGESTIONএর মতো মান সহ), যা Content API for Shopping-এর স্ট্রিং-ভিত্তিক মানগুলির তুলনায় প্রোগ্রাম্যাটিকভাবে প্রক্রিয়া করা সহজ করে তোলে। - স্ট্যান্ডার্ডাইজড আইডেন্টিফায়ার: প্রতিটি অ্যাকাউন্ট ইস্যুতে
accounts/{ACCOUNT_ID}/issues/{ISSUE_ID}ফর্ম্যাটে একটি অনন্য, সম্পূর্ণ রিসোর্সnameথাকে। এই স্ট্যান্ডার্ডাইজড পদ্ধতিটি শপিংয়ের জন্য Content API থেকেidস্ট্রিং প্রতিস্থাপন করে। - স্থানীয়করণ সমর্থন:
accounts.issues.listপদ্ধতি আপনাকে আপনার পছন্দের ভাষায় শিরোনাম এবং বিবরণের মতো সমস্যার বিবরণ পেতে একটিlanguage_codeনির্দিষ্ট করতে দেয়। শপিংয়ের জন্য সামগ্রী API তে এটি সম্ভব ছিল না। - উন্নত অ্যাকাউন্ট আচরণ: যখন আপনি একটি উন্নত অ্যাকাউন্টে
accounts.issues.listকল করেন, তখন এটি কেবলমাত্র সেই সমস্যাগুলি ফেরত দেয় যা সরাসরি সেই উন্নত অ্যাকাউন্টে প্রযোজ্য হয়। এটি এর কোনও সাব-অ্যাকাউন্টের জন্য সমস্যাগুলি ফেরত দেয় না। শপিংয়ের জন্য সামগ্রী API-তে,accountstatuses.listপদ্ধতিটি সমস্ত সাব-অ্যাকাউন্টের জন্য স্ট্যাটাসগুলি ফেরত দেবে। Merchant API-তে সমস্ত সাব-অ্যাকাউন্টের জন্য সমস্যাগুলি পেতে, আপনাকেaccounts.listSubaccountsকল করতে হবে এবং তারপরে প্রতিটি সাব-অ্যাকাউন্টের জন্য পৃথকভাবেaccounts.issues.listকল করতে হবে।
অনুরোধ
মার্চেন্ট API-তে, আপনি একটি নির্দিষ্ট মার্চেন্ট সেন্টার অ্যাকাউন্টের জন্য অ্যাকাউন্টের সমস্যাগুলি তালিকাভুক্ত করতে পারেন।
GET https://merchantapi.googleapis.com/accounts/v1/accounts/ACCOUNT_ID/issues
URL তুলনার অনুরোধ করুন
| অনুরোধের বিবরণ | কেনাকাটার জন্য কন্টেন্ট 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 | উপলব্ধ নেই। আপনাকে সাব-অ্যাকাউন্টের মাধ্যমে পুনরাবৃত্তি করতে হবে। |
শনাক্তকারী
Merchant API-তে অ্যাকাউন্ট এবং সমস্যার শনাক্তকারী পরিবর্তন করা হয়েছে।
শনাক্তকারীর তুলনা
| শনাক্তকারীর বর্ণনা | কেনাকাটার জন্য কন্টেন্ট API | মার্চেন্ট এপিআই |
|---|---|---|
| অ্যাকাউন্ট শনাক্তকারী | পাথ প্যারামিটার হিসেবে {MERCHANT_ID} এবং {ACCOUNT_ID} । | accounts/{ACCOUNT_ID} {ACCOUNT_ID} ACCOUNT_ID} ফর্ম্যাটে একটি পাথ প্যারামিটার হিসেবে {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 ব্যবহার করুন এবং অ্যাকাউন্ট আইডি নির্দিষ্ট করুন। মার্চেন্ট API-তে একটি একক সমস্যার জন্য কোনও get পদ্ধতি নেই। |
accountstatuses.list | কোন সরাসরি সমতুল্য নেই। | উপলব্ধ নেই। Merchant API-তে accounts.issues.list পদ্ধতিটি শুধুমাত্র নির্দিষ্ট অ্যাকাউন্টের জন্য সমস্যাগুলি ফেরত দেয়, এর সাব-অ্যাকাউন্টগুলির জন্য নয়। সমস্ত সাব-অ্যাকাউন্টের জন্য সমস্যাগুলি পেতে, আপনাকে প্রথমে accounts.listSubaccounts কল করতে হবে এবং তারপরে প্রতিটি সাব-অ্যাকাউন্টের জন্য accounts.issues.list কল করতে হবে। |
accountstatuses.custombatch | কোন সরাসরি সমতুল্য নেই। | উপলব্ধ নেই। অ্যাকাউন্টের সমস্যার জন্য ব্যাচ প্রক্রিয়াকরণ মার্চেন্ট API তে সমর্থিত নয়। আপনাকে প্রতিটি অ্যাকাউন্টের জন্য পৃথক list কল করতে হবে। |
বিস্তারিত ক্ষেত্রের পরিবর্তন
অ্যাকাউন্ট ইস্যু রিসোর্সের মধ্যে থাকা ক্ষেত্রগুলি আরও কাঠামো এবং স্পষ্টতা প্রদানের জন্য আপডেট করা হয়েছে।
ক্ষেত্রের তুলনা
| কেনাকাটার জন্য কন্টেন্ট API | মার্চেন্ট এপিআই | বিবরণ |
|---|---|---|
accountLevelIssues ( AccountStatus এ অ্যারে) | accountIssues ( ListAccountIssuesResponse এ অ্যারে) | সমস্যাগুলি এখন একটি নিবেদিতপ্রাণ, শীর্ষ-স্তরের সম্পদ, কোনও নেস্টেড ক্ষেত্র নয়। |
id (স্ট্রিং) | name (স্ট্রিং) | সমস্যা শনাক্তকারী এখন একটি সম্পূর্ণ রিসোর্সের নাম, উদাহরণস্বরূপ accounts/{ACCOUNT_ID}/issues/{ISSUE_ID} । |
title (স্ট্রিং) | title (স্ট্রিং) | কোন পরিবর্তন নেই। |
detail (স্ট্রিং) | detail (স্ট্রিং) | কোন পরিবর্তন নেই। |
documentation (স্ট্রিং) | documentationUri (স্ট্রিং) | স্পষ্টতার জন্য ক্ষেত্রটির নাম পরিবর্তন করা হয়েছে যাতে এটি একটি URL বোঝাতে পারে। |
severity (স্ট্রিং) | severity (সংখ্যা) | Severity এখন একটি স্ট্রিং এর পরিবর্তে একটি স্ট্রাকচার্ড enum ( CRITICAL , ERROR , SUGGESTION )। |
country (স্ট্রিং), destination (স্ট্রিং) | impactedDestinations (পুনরাবৃত্ত বার্তা) | ইমপ্যাক্ট এখন একটি তালিকায় গঠিত, প্রতিটি প্রভাবিত এলাকার জন্য গন্তব্য, অঞ্চল এবং তীব্রতাকে গোষ্ঠীভুক্ত করে। Impact বার্তার মধ্যে country ক্ষেত্রটি regionCode দ্বারা প্রতিস্থাপিত হয়। |
| (উপলব্ধ নয়) | language_code , time_zone (অনুরোধের পরামিতি) | list অনুরোধে নতুন প্যারামিটারগুলি title এবং detail এর মতো মানুষের পাঠযোগ্য ক্ষেত্রগুলির স্থানীয়করণের অনুমতি দেয়। |