MCP Tools Reference: paydeveloper.googleapis.com

Strumento: query_merchant_error_metrics

Recupera metriche di errore dettagliate per un profilo dell'attività del commerciante specifico. Questo strumento fornisce una suddivisione granulare degli errori, consentendo agli sviluppatori di individuare e risolvere i problemi.

Il seguente esempio mostra come utilizzare curl per richiamare lo strumento MCP query_merchant_error_metrics.

Curl Request 
                  
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
}'

Schema di input

Messaggio di richiesta per l'esecuzione di query sulle metriche di errore del commerciante.

QueryMerchantErrorMetricsRequest

Rappresentazione JSON 
{
  "merchantId": string,
  "timeRange": enum (TimeRange)
}
Campi
merchantId

string

Obbligatorio. L'identificatore univoco del commerciante per il quale vengono richieste le metriche degli errori.
timeRange

enum (TimeRange)

Facoltativo. L'intervallo di tempo dei dati delle metriche degli errori.

Schema di output

Messaggio di risposta per l'interrogazione delle metriche di errore del commerciante.

QueryMerchantErrorMetricsResponse

Rappresentazione JSON 
{
  "errorMetrics": [
    {
      object (MerchantErrorMetric)
    }
  ]
}
Campi
errorMetrics[]

object (MerchantErrorMetric)

I dati delle metriche di errore del commerciante.

MerchantErrorMetric

Rappresentazione JSON 
{
  "errorDetail": {
    object (ErrorDetail)
  },
  "hourlyErrorCounts": [
    {
      object (HourlyErrorCount)
    }
  ]
}
Campi
errorDetail

object (ErrorDetail)

Solo output. Dettagli dell'errore.
hourlyErrorCounts[]

object (HourlyErrorCount)

Solo output. Un elenco del conteggio degli errori e del relativo timestamp, arrotondato all'inizio dell'ora più vicina.

ErrorDetail

Rappresentazione JSON 
{
  "errorCode": string,
  "errorMessage": string
}
Campi
errorCode

string

Codice di errore, ad esempio "OR_BIBED_07".
errorMessage

string

Solo messaggio descrittivo, nessun dato utente né stack trace interni.

HourlyErrorCount

Rappresentazione JSON 
{
  "hourlyTimestamp": string,
  "count": integer
}
Campi
hourlyTimestamp

string (Timestamp format)

Timestamp che rappresenta l'inizio dell'ora.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
count

integer

Il numero di errori entro quest'ora.

Timestamp

Rappresentazione JSON 
{
  "seconds": string,
  "nanos": integer
}
Campi
seconds

string (int64 format)

Rappresenta i secondi di tempo UTC dall'epoca di Unix 1970-01-01T00:00:00Z. Deve essere compreso tra -62135596800 e 253402300799 inclusi (corrispondenti a 0001-01-01T00:00:00Z e 9999-12-31T23:59:59Z).
nanos

integer

Frazioni di secondo non negative con risoluzione in nanosecondi. Questo campo è la porzione di nanosecondi della durata, non un'alternativa ai secondi. I valori negativi dei secondi con frazioni devono comunque avere valori di nanosecondi non negativi che vengono conteggiati in avanti nel tempo. Deve essere compreso tra 0 e 999.999.999 inclusi.

Annotazioni dello strumento

Suggerimento distruttivo: ❌ | Suggerimento idempotente: ✅ | Suggerimento di sola lettura: ✅ | Suggerimento open world: ❌