MCP Tools Reference: paydeveloper.googleapis.com

Narzędzie: query_merchant_error_metrics

Pobiera szczegółowe dane o błędach dotyczące konkretnego profilu firmy sprzedawcy. To narzędzie zapewnia szczegółowy podział błędów, co pozwala deweloperom wskazywać i rozwiązywać problemy.

Poniższy przykład pokazuje, jak za pomocą znaku curl wywołać narzędzie query_merchant_error_metrics MCP.

Żądanie 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 tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Schemat wejściowy

Wiadomość z prośbą o wykonanie zapytania dotyczącego wskaźników błędów sprzedawcy.

QueryMerchantErrorMetricsRequest

Zapis JSON 
{
  "merchantId": string,
  "timeRange": enum (TimeRange)
}
Pola
merchantId

string

Wymagane. Unikalny identyfikator sprzedawcy, dla którego są żądane dane o błędach.
timeRange

enum (TimeRange)

Opcjonalnie. Zakres czasu danych wskaźników błędów.

Schemat wyjściowy

Komunikat odpowiedzi na zapytanie o dane o błędach sprzedawcy.

QueryMerchantErrorMetricsResponse

Zapis JSON 
{
  "errorMetrics": [
    {
      object (MerchantErrorMetric)
    }
  ]
}
Pola
errorMetrics[]

object (MerchantErrorMetric)

Dane o błędach sprzedawcy.

MerchantErrorMetric

Zapis JSON 
{
  "errorDetail": {
    object (ErrorDetail)
  },
  "hourlyErrorCounts": [
    {
      object (HourlyErrorCount)
    }
  ]
}
Pola
errorDetail

object (ErrorDetail)

Tylko dane wyjściowe. Szczegóły błędu.
hourlyErrorCounts[]

object (HourlyErrorCount)

Tylko dane wyjściowe. Lista liczby błędów i sygnatury czasowej zaokrąglonej do najbliższej pełnej godziny.

ErrorDetail

Zapis JSON 
{
  "errorCode": string,
  "errorMessage": string
}
Pola
errorCode

string

Kod błędu, np. „OR_BIBED_07”.
errorMessage

string

Tylko komunikat opisowy, bez danych użytkownika ani wewnętrznych śladów stosu.

HourlyErrorCount

Zapis JSON 
{
  "hourlyTimestamp": string,
  "count": integer
}
Pola
hourlyTimestamp

string (Timestamp format)

Sygnatura czasowa reprezentująca początek godziny.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
count

integer

Liczba błędów w ciągu tej godziny.

Sygnatura czasowa

Zapis JSON 
{
  "seconds": string,
  "nanos": integer
}
Pola
seconds

string (int64 format)

Reprezentuje sekundy czasu UTC od epoki uniksowej 1970-01-01T00:00:00Z. Musi mieścić się w przedziale od -62135596800 do 253402300799 (włącznie), co odpowiada zakresowi od 0001-01-01T00:00:00Z do 9999-12-31T23:59:59Z.
nanos

integer

Nieujemne ułamki sekundy w rozdzielczości nanosekundowej. To pole zawiera część czasu trwania w nanosekundach, a nie alternatywę dla sekund. Ujemne wartości sekund z ułamkami muszą mieć nieujemne wartości nanosekund, które liczą czas do przodu. Musi mieścić się w zakresie od 0 do 999 999 999 włącznie.

Adnotacje narzędzi

Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌