MCP Tools Reference: paydeveloper.googleapis.com

টুল: query_merchant_error_metrics

একটি নির্দিষ্ট মার্চেন্ট বিজনেস প্রোফাইলের জন্য বিস্তারিত ত্রুটির মেট্রিক্স সংগ্রহ করে। এই টুলটি ত্রুটিগুলির একটি সূক্ষ্ম বিভাজন প্রদান করে, যা ডেভেলপারদের সমস্যাগুলি চিহ্নিত করতে এবং সমাধান করতে সাহায্য করে।

নিম্নলিখিত কোড নমুনাটি দেখায় কিভাবে query_merchant_error_metrics MCP টুলটিকে কল করার জন্য curl ব্যবহার করতে হয়।

কার্ল অনুরোধ 
curl --location 'https://paydeveloper.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "query_merchant_error_metrics",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

ইনপুট স্কিমা

মার্চেন্ট এরর মেট্রিক্স কোয়েরি করার জন্য অনুরোধ বার্তা।

QueryMerchantErrorMetricsRequest

JSON উপস্থাপনা 
{
  "merchantId": string,
  "timeRange": enum (TimeRange)
}
ক্ষেত্র
merchantId

string

প্রয়োজনীয়। যে মার্চেন্টের জন্য ত্রুটির মেট্রিক্স অনুরোধ করা হচ্ছে, তার অনন্য শনাক্তকারী।

timeRange

enum ( TimeRange )

ঐচ্ছিক। ত্রুটি মেট্রিক্স ডেটার সময়সীমা।

সময়সীমা

ডেটার সময়সীমা। পরবর্তী আইডি: ৪

এনাম
TIME_RANGE_UNSPECIFIED অনির্দিষ্ট সময়সীমা।
TIME_RANGE_PAST_DAY গত দিন, গতকাল।
TIME_RANGE_PAST_THREE_DAYS বর্তমান দিনটি বাদে বিগত তিন দিন।
TIME_RANGE_PAST_WEEK গত সপ্তাহ, বর্তমান দিনটি বাদে।

আউটপুট স্কিমা

মার্চেন্ট এরর মেট্রিক্স কোয়েরি করার প্রতিক্রিয়া বার্তা।

QueryMerchantErrorMetricsResponse

JSON উপস্থাপনা 
{
  "errorMetrics": [
    {
      object (MerchantErrorMetric)
    }
  ]
}
ক্ষেত্র
errorMetrics[]

object ( MerchantErrorMetric )

ব্যবসায়ীর ত্রুটি মেট্রিক্স ডেটা।

মার্চেন্টএররমেট্রিক

JSON উপস্থাপনা 
{
  "errorDetail": {
    object (ErrorDetail)
  },
  "hourlyErrorCounts": [
    {
      object (HourlyErrorCount)
    }
  ]
}
ক্ষেত্র
errorDetail

object ( ErrorDetail )

শুধুমাত্র আউটপুট। ত্রুটির বিবরণ।

hourlyErrorCounts[]

object ( HourlyErrorCount )

শুধুমাত্র আউটপুট। ত্রুটির সংখ্যা এবং তার টাইমস্ট্যাম্পের একটি তালিকা, যা নিকটতম ঘণ্টার শুরুতে রাউন্ড করা হয়েছে।

ত্রুটির বিবরণ

JSON উপস্থাপনা 
{
  "errorCode": string,
  "errorMessage": string
}
ক্ষেত্র
errorCode

string

ত্রুটি কোড, যেমন "OR_BIBED_07"।

errorMessage

string

শুধুমাত্র বর্ণনামূলক বার্তা, কোনো ব্যবহারকারীর ডেটা বা অভ্যন্তরীণ স্ট্যাক ট্রেস নেই।

ঘণ্টাভিত্তিক ত্রুটির সংখ্যা

JSON উপস্থাপনা 
{
  "hourlyTimestamp": string,
  "count": integer
}
ক্ষেত্র
hourlyTimestamp

string ( Timestamp format)

ঘণ্টা শুরুর সময়সূচক টাইমস্ট্যাম্প।

RFC 3339 ব্যবহার করা হয়, যেখানে তৈরি হওয়া আউটপুট সর্বদা Z-নরম্যালাইজড হবে এবং এতে ০, ৩, ৬ বা ৯টি ভগ্নাংশীয় অঙ্ক ব্যবহৃত হবে। "Z" ছাড়াও অন্যান্য অফসেটও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30" ।

count

integer

এই ঘণ্টার মধ্যে ভুলের সংখ্যা।

টাইমস্ট্যাম্প

JSON উপস্থাপনা 
{
  "seconds": string,
  "nanos": integer
}
ক্ষেত্র
seconds

string ( int64 format)

এটি ইউনিক্স ইপক 1970-01-01T00:00:00Z থেকে UTC সময়ের সেকেন্ড নির্দেশ করে। এর মান অবশ্যই -62135596800 থেকে 253402300799 (উভয় মানসহ) এর মধ্যে হতে হবে (যা 0001-01-01T00:00:00Z থেকে 9999-12-31T23:59:59Z পর্যন্ত সময়কালের সমতুল্য)।

nanos

integer

ন্যানোসেকেন্ড রেজোলিউশনে সেকেন্ডের অঋণাত্মক ভগ্নাংশ। এই ক্ষেত্রটি হলো সময়কালের ন্যানোসেকেন্ড অংশ, সেকেন্ডের বিকল্প নয়। ভগ্নাংশসহ ঋণাত্মক সেকেন্ডের মানগুলোর ক্ষেত্রেও ন্যানোর মান অবশ্যই অঋণাত্মক হতে হবে, যা সময়ের সাথে সাথে গণনা করে। এর মান অবশ্যই ০ থেকে ৯৯৯,৯৯৯,৯৯৯-এর মধ্যে হতে হবে (উভয় সংখ্যাসহ)।

টুল টীকা

কোনো নির্দিষ্ট টুলের প্রাথমিক ঝুঁকি বর্ণনা করার জন্য টুল অ্যানোটেশনগুলো এমসিপি ক্লায়েন্টদের কাছে পাঠানো হয়। বেশিরভাগ ক্লায়েন্ট এই ইঙ্গিতগুলোকে অবিশ্বস্ত হিসেবে গণ্য করে, কিন্তু কখন একজন ব্যবহারকারীকে নিশ্চিতকরণের জন্য প্রম্পট পাঠানো হবে, সেই সিদ্ধান্ত নিতে এগুলো ব্যবহার করা যেতে পারে।

টাইটেল স্ট্রিং-এর পাশাপাশি, নিম্নলিখিত বুলিয়ান হিন্টগুলো নিম্নরূপভাবে সংজ্ঞায়িত করা হয়েছে:

  • readOnlyHint : যদি true হয়, টুলটি তার পরিবেশ পরিবর্তন করে না। ডিফল্ট: false।
  • destructiveHint : যদি true হয়, তাহলে টুলটি ধ্বংসাত্মক কাজ করতে পারবে। যদি false হয়, তাহলে টুলটি শুধুমাত্র সংযোজনমূলক কাজ করতে পারবে। ডিফল্ট: true।
  • idempotentHint : যদি true হয়, তাহলে একই আর্গুমেন্ট দিয়ে টুলটিকে বারবার কল করলেও এর এনভায়রনমেন্টের উপর কোনো অতিরিক্ত প্রভাব পড়বে না। ডিফল্ট: false।
  • openWorldHint : যদি true হয়, তাহলে টুলটি বাহ্যিক সত্তার 'ওপেন ওয়ার্ল্ড'-এর সাথে ইন্টারঅ্যাক্ট করতে পারবে। যদি false হয়, তাহলে টুলটি শুধুমাত্র অভ্যন্তরীণ সত্তার সাথে ইন্টারঅ্যাক্ট করতে পারবে। উদাহরণস্বরূপ, একটি ওয়েব সার্চ টুল ওপেন ওয়ার্ল্ড হবে, কিন্তু একটি মেমরি টুল ওপেন ওয়ার্ল্ড হবে না।

ধ্বংসাত্মক ইঙ্গিত: ❌ | স্বকীয় ইঙ্গিত: ✅ | শুধুমাত্র পঠনযোগ্য ইঙ্গিত: ✅ | উন্মুক্ত বিশ্ব ইঙ্গিত: ❌