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