MCP Tools Reference: paydeveloper.googleapis.com

Strumento: query_merchant_performance

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

I seguenti esempi mostrano come utilizzare curl per richiamare lo strumento MCP query_merchant_performance.

Richiesta 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_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'esecuzione di query sui 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'esecuzione di query sul 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 di valori delle metriche e dei relativi timestamp, arrotondati all'inizio dell'ora più vicina.

MetricDetail

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

enum (MetricType)

Tipo di metrica.
additionalDetails

map (key: string, value: string)

Coppie chiave-valore per eventuali dettagli aggiuntivi sulla metrica, ad es. "gateway": "stripe". Per i 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'inizio dell'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 dell'ora UTC dall'epoca Unix 1970-01-01T00:00:00Z. Il valore deve essere compreso tra -62135596800 e 253402300799 inclusi (corrispondenti a 0001-01-01T00:00:00Z e 9999-12-31T23:59:59Z).
nanos

integer

Frazioni non negative di un secondo con una risoluzione in nanosecondi. Questo campo è la parte in nanosecondi della durata, non un'alternativa ai secondi. I valori dei secondi negativi con frazioni devono comunque avere valori di nanosecondi non negativi che contano in avanti nel tempo. Il valore 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: ❌