MCP Tools Reference: paydeveloper.googleapis.com

Araç: query_merchant_performance

Belirli bir satıcı işletme profili için üst düzey toplu performans verilerini ve entegrasyon sonrası metrikleri alır.

Aşağıdaki örnekte, curl kullanılarak query_merchant_performance MCP aracının nasıl çağrılacağı gösterilmektedir.

Curl İsteği 
                  
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 tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Giriş Şeması

Satıcı performans verilerini sorgulamak için istek mesajı.

QueryMerchantPerformanceRequest

JSON gösterimi 
{
  "merchantId": string,
  "timeRange": enum (TimeRange)
}
Alanlar
merchantId

string

Zorunlu. Performans verilerinin istendiği satıcının benzersiz tanımlayıcısı.
timeRange

enum (TimeRange)

İsteğe bağlı. Performans verilerinin zaman aralığı.

Çıkış şeması

Satıcı performansını sorgulamaya yönelik yanıt mesajı.

QueryMerchantPerformanceResponse

JSON gösterimi 
{
  "merchantPerformanceMetrics": [
    {
      object (MerchantPerformanceMetric)
    }
  ]
}
Alanlar
merchantPerformanceMetrics[]

object (MerchantPerformanceMetric)

Satıcının performans verileri.

MerchantPerformanceMetric

JSON gösterimi 
{
  "metricDetail": {
    object (MetricDetail)
  },
  "hourlyMetricValues": [
    {
      object (HourlyMetricValue)
    }
  ]
}
Alanlar
metricDetail

object (MetricDetail)

Yalnızca çıkış. Metriğin ayrıntıları.
hourlyMetricValues[]

object (HourlyMetricValue)

Yalnızca çıkış. Metrik değerinin ve zaman damgasının listesi (en yakın saate yuvarlanmış).

MetricDetail

JSON gösterimi 
{
  "metricType": enum (MetricType),
  "additionalDetails": {
    string: string,
    ...
  }
}
Alanlar
metricType

enum (MetricType)

Metriğin türü.
additionalDetails

map (key: string, value: string)

Metrikle ilgili ek ayrıntılar için anahtar/değer çiftleri (ör. "gateway": "stripe"). Ayrıntılar için bkz.

"key": value çiftlerinin listesini içeren bir nesne. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

AdditionalDetailsEntry

JSON gösterimi 
{
  "key": string,
  "value": string
}
Alanlar
key

string
value

string

HourlyMetricValue

JSON gösterimi 
{
  "hourlyTimestamp": string,
  "value": number
}
Alanlar
hourlyTimestamp

string (Timestamp format)

Metrik değerinin en yakın saate yuvarlanmış zaman damgası.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
value

number

Gerçek metrik değeri. Dönüşüm oranı için değer [0, 1] aralığındadır. Diğer metrikler için değer, sıfırdan büyük bir tam sayı olmalıdır.

Zaman damgası

JSON gösterimi 
{
  "seconds": string,
  "nanos": integer
}
Alanlar
seconds

string (int64 format)

Unix sıfır zamanı 1970-01-01T00:00:00Z'den itibaren UTC zamanının saniyelerini gösterir. -62135596800 ile 253402300799 arasında olmalıdır (0001-01-01T00:00:00Z ile 9999-12-31T23:59:59Z'ye karşılık gelir).
nanos

integer

Nanosaniye çözünürlüğünde, negatif olmayan saniyenin kesirleri. Bu alan, sürenin nanosaniye kısmıdır ve saniyenin alternatifi değildir. Kesirli negatif saniye değerleri, zaman içinde ileriye doğru sayılan negatif olmayan nanos değerlerine sahip olmalıdır. 0 ile 999.999.999 arasında olmalıdır (bu değerler dahil).

Araç Ek Açıklamaları

Yıkıcı İpucu: ❌ | İdempotent İpucu: ✅ | Salt Okunur İpucu: ✅ | Açık Dünya İpucu: ❌