MCP Tools Reference: paydeveloper.googleapis.com

টুল: query_merchant_performance

একটি নির্দিষ্ট মার্চেন্ট বিজনেস প্রোফাইলের জন্য উচ্চ-স্তরের সমষ্টিগত পারফরম্যান্স ডেটা এবং ইন্টিগ্রেশন-পরবর্তী মেট্রিক্স পুনরুদ্ধার করে।

নিম্নলিখিত কোড নমুনাটি দেখায় কিভাবে query_merchant_performance 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_performance",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

ইনপুট স্কিমা

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

কোয়েরি মার্চেন্ট পারফরম্যান্স রিকোয়েস্ট

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 গত সপ্তাহ, বর্তমান দিনটি বাদে।

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

মার্চেন্টের পারফরম্যান্স জিজ্ঞাসা করার প্রতিক্রিয়া বার্তা।

কোয়েরি মার্চেন্ট পারফরম্যান্স রেসপন্স

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

object ( MerchantPerformanceMetric )

ব্যবসায়ীর কর্মক্ষমতার তথ্য।

মার্চেন্ট পারফরম্যান্স মেট্রিক

JSON উপস্থাপনা 
{
  "metricDetail": {
    object (MetricDetail)
  },
  "hourlyMetricValues": [
    {
      object (HourlyMetricValue)
    }
  ]
}
ক্ষেত্র
metricDetail

object ( MetricDetail )

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

hourlyMetricValues[]

object ( HourlyMetricValue )

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

মেট্রিকডিটেল

JSON উপস্থাপনা 
{
  "metricType": enum (MetricType),
  "additionalDetails": {
    string: string,
    ...
  }
}
ক্ষেত্র
metricType

enum ( MetricType )

মেট্রিকের ধরণ।

additionalDetails

map (key: string, value: string)

মেট্রিক সম্পর্কে যেকোনো অতিরিক্ত বিবরণের জন্য কী-ভ্যালু পেয়ার, যেমন, 'গেটওয়ে': 'স্ট্রাইপ'। বিস্তারিত জানতে দেখুন

একটি অবজেক্ট যা "key": value জোড়ের একটি তালিকা ধারণ করে। উদাহরণ: { "name": "wrench", "mass": "1.3kg", "count": "3" } ।

অতিরিক্ত বিবরণ এন্ট্রি

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

string

value

string

ঘণ্টাভিত্তিক মেট্রিক মান

JSON উপস্থাপনা 
{
  "hourlyTimestamp": string,
  "value": number
}
ক্ষেত্র
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" ।

value

number

মেট্রিকের প্রকৃত মান। কনভার্সন রেটের ক্ষেত্রে, মানটি [0, 1] পরিসরের মধ্যে থাকে। অন্যান্য মেট্রিকের জন্য, মানটি একটি অঋণাত্মক পূর্ণসংখ্যা।

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

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

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

মেট্রিকটাইপ

যে ধরনের মেট্রিক পরিমাপ করা হচ্ছে।

এনাম
METRIC_TYPE_UNSPECIFIED অনির্দিষ্ট মেট্রিক প্রকার।
FACILITATION_COUNT সফল GPay API ফেসিলিটেশনের সংখ্যা।
VISIT_COUNT GPay API বাটনে ক্লিকের সংখ্যা।
CONVERSION_RATE চেকআউট বাটনের কনভার্সন রেট, যা GPay API বাটনে ক্লিকের সংখ্যার সাথে সফল GPay API ফেসিলিটেশনের সংখ্যার অনুপাত হিসাবে সংজ্ঞায়িত করা হয়।

টুল টীকা

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

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

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

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