MCP Tools Reference: paydeveloper.googleapis.com

Araç: query_merchant_error_metrics

Belirli bir satıcı işletme profili için ayrıntılı hata metriklerini alır. Bu araç, hataların ayrıntılı bir dökümünü sunarak geliştiricilerin sorunları belirleyip çözmesine olanak tanır.

Aşağıdaki örnekte, curl kullanılarak query_merchant_error_metrics 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_error_metrics",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Giriş Şeması

Satıcı hata metriklerini sorgulamak için istek mesajı.

QueryMerchantErrorMetricsRequest

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

string

Zorunlu. Hata metriklerinin istendiği satıcının benzersiz tanımlayıcısı.
timeRange

enum (TimeRange)

İsteğe bağlı. Hata metrikleri verilerinin zaman aralığı.

Çıkış şeması

Satıcı hata metriklerini sorgulama için yanıt mesajı.

QueryMerchantErrorMetricsResponse

JSON gösterimi 
{
  "errorMetrics": [
    {
      object (MerchantErrorMetric)
    }
  ]
}
Alanlar
errorMetrics[]

object (MerchantErrorMetric)

Satıcının hata metrikleri verileri.

MerchantErrorMetric

JSON gösterimi 
{
  "errorDetail": {
    object (ErrorDetail)
  },
  "hourlyErrorCounts": [
    {
      object (HourlyErrorCount)
    }
  ]
}
Alanlar
errorDetail

object (ErrorDetail)

Yalnızca çıkış. Hatayla ilgili ayrıntılar.
hourlyErrorCounts[]

object (HourlyErrorCount)

Yalnızca çıkış. Hata sayısının ve en yakın saate yuvarlanmış zaman damgasının listesi.

ErrorDetail

JSON gösterimi 
{
  "errorCode": string,
  "errorMessage": string
}
Alanlar
errorCode

string

Hata kodu (ör. "OR_BIBED_07").
errorMessage

string

Yalnızca açıklayıcı mesaj, kullanıcı verileri veya dahili yığın izlemeleri yok.

HourlyErrorCount

JSON gösterimi 
{
  "hourlyTimestamp": string,
  "count": integer
}
Alanlar
hourlyTimestamp

string (Timestamp format)

Saatin başlangıcını gösteren 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".
count

integer

Bu saat içindeki hata sayısı.

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: ❌