MCP Tools Reference: paydeveloper.googleapis.com

Strumento: query_merchant_performance

Recupera dati sul rendimento aggregati di alto livello e metriche post-integrazione per un profilo dell'attività del commerciante specifico.

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

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_performance",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Schema di input

Messaggio di richiesta per l'interrogazione dei dati sul rendimento del commerciante.

QueryMerchantPerformanceRequest

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

string

Obbligatorio. L'identificatore univoco del commerciante per il quale vengono richiesti i dati sul rendimento.
timeRange

enum (TimeRange)

Facoltativo. L'intervallo di tempo dei dati sul rendimento.

TimeRange

L'intervallo di tempo dei dati. ID successivo: 4

Enum
TIME_RANGE_UNSPECIFIED Intervallo di tempo non specificato.
TIME_RANGE_PAST_DAY Il giorno precedente, ieri.
TIME_RANGE_PAST_THREE_DAYS Gli ultimi tre giorni, escluso il giorno corrente.
TIME_RANGE_PAST_WEEK La settimana precedente, escluso il giorno corrente.

Schema di output

Messaggio di risposta per l'interrogazione del rendimento del commerciante.

QueryMerchantPerformanceResponse

Rappresentazione JSON 
{
  "merchantPerformanceMetrics": [
    {
      object (MerchantPerformanceMetric)
    }
  ]
}
Campi
merchantPerformanceMetrics[]

object (MerchantPerformanceMetric)

I dati sul rendimento del commerciante.

MerchantPerformanceMetric

Rappresentazione JSON 
{
  "metricDetail": {
    object (MetricDetail)
  },
  "hourlyMetricValues": [
    {
      object (HourlyMetricValue)
    }
  ]
}
Campi
metricDetail

object (MetricDetail)

Solo output. Dettagli della metrica.
hourlyMetricValues[]

object (HourlyMetricValue)

Solo output. Un elenco del valore della metrica e del relativo timestamp, arrotondato all'ora più vicina.

MetricDetail

Rappresentazione JSON 
{
  "metricType": enum (MetricType),
  "additionalDetails": {
    string: string,
    ...
  }
}
Campi
metricType

enum (MetricType)

Il tipo di metrica.
additionalDetails

map (key: string, value: string)

Coppie chiave-valore per eventuali dettagli aggiuntivi sulla metrica, ad es. "gateway": "stripe". Per maggiori dettagli, vedi

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

AdditionalDetailsEntry

Rappresentazione JSON 
{
  "key": string,
  "value": string
}
Campi
key

string
value

string

HourlyMetricValue

Rappresentazione JSON 
{
  "hourlyTimestamp": string,
  "value": number
}
Campi
hourlyTimestamp

string (Timestamp format)

Il timestamp del valore della metrica arrotondato all'ora più vicina.

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".
value

number

Il valore effettivo della metrica. Per il tasso di conversione, il valore è compreso nell'intervallo [0, 1]. Per le altre metriche, il valore è un numero intero non negativo.

Timestamp

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

string (int64 format)

Rappresenta i secondi di tempo UTC a partire dall'epoca 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 parte in nanosecondi della durata, non un'alternativa ai secondi. I valori negativi dei secondi con frazioni devono comunque avere valori non negativi dei nanosecondi che vengono conteggiati in avanti nel tempo. Deve essere compreso tra 0 e 999.999.999 inclusi.

MetricType

Il tipo di metrica misurata.

Enum
METRIC_TYPE_UNSPECIFIED Tipo di metrica non specificato.
FACILITATION_COUNT Il numero di facilitazioni dell'API GPay riuscite.
VISIT_COUNT Il numero di clic sul pulsante dell'API GPay.
CONVERSION_RATE Il tasso di conversione del pulsante di pagamento, definito come il rapporto tra il numero di facilitazioni dell'API GPay riuscite e il numero di clic sul pulsante dell'API GPay.

Annotazioni dello strumento

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