MCP Tools Reference: paydeveloper.googleapis.com

Outil : query_merchant_performance

Récupère des données agrégées de haut niveau sur les performances et des métriques post-intégration pour une fiche d'établissement spécifique.

L'exemple suivant montre comment utiliser curl pour appeler l'outil MCP query_merchant_performance.

Requête 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
}'

Schéma d'entrée

Message de requête pour interroger les données sur les performances du marchand.

QueryMerchantPerformanceRequest

Représentation JSON 
{
  "merchantId": string,
  "timeRange": enum (TimeRange)
}
Champs
merchantId

string

Obligatoire. Identifiant unique du marchand pour lequel des données sur les performances sont demandées.
timeRange

enum (TimeRange)

Facultatif. Plage de dates des données sur les performances.

Schéma de sortie

Message de réponse pour interroger les performances du marchand.

QueryMerchantPerformanceResponse

Représentation JSON 
{
  "merchantPerformanceMetrics": [
    {
      object (MerchantPerformanceMetric)
    }
  ]
}
Champs
merchantPerformanceMetrics[]

object (MerchantPerformanceMetric)

Données sur les performances du marchand.

MerchantPerformanceMetric

Représentation JSON 
{
  "metricDetail": {
    object (MetricDetail)
  },
  "hourlyMetricValues": [
    {
      object (HourlyMetricValue)
    }
  ]
}
Champs
metricDetail

object (MetricDetail)

Uniquement en sortie. Détails de la métrique.
hourlyMetricValues[]

object (HourlyMetricValue)

Uniquement en sortie. Liste de valeurs de métriques et de leurs codes temporels, arrondis à l'heure la plus proche.

MetricDetail

Représentation JSON 
{
  "metricType": enum (MetricType),
  "additionalDetails": {
    string: string,
    ...
  }
}
Champs
metricType

enum (MetricType)

Type de métrique.
additionalDetails

map (key: string, value: string)

Paires clé/valeur pour tout détail supplémentaire concernant la métrique (par exemple, "gateway": "stripe"). Pour en savoir plus, consultez

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.

AdditionalDetailsEntry

Représentation JSON 
{
  "key": string,
  "value": string
}
Champs
key

string
value

string

HourlyMetricValue

Représentation JSON 
{
  "hourlyTimestamp": string,
  "value": number
}
Champs
hourlyTimestamp

string (Timestamp format)

Code temporel de la valeur de la métrique, arrondi à l'heure la plus proche.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
value

number

Valeur réelle de la métrique. Pour le taux de conversion, la valeur est comprise entre 0 et 1. Pour les autres métriques, la valeur est un nombre entier non négatif.

Horodatage

Représentation JSON 
{
  "seconds": string,
  "nanos": integer
}
Champs
seconds

string (int64 format)

Représente les secondes de l'heure UTC à partir de l'epoch Unix 1970-01-01T00:00:00Z. La valeur doit être comprise entre -62135596800 et 253402300799 inclus (ce qui correspond à 0001-01-01T00:00:00Z et 9999-12-31T23:59:59Z).
nanos

integer

Fractions de secondes non négatives avec une précision de l'ordre de la nanoseconde. Ce champ correspond à la partie en nanosecondes de la durée, et non à une alternative aux secondes. Les valeurs de secondes négatives avec des fractions doivent toujours comporter des valeurs de nanosecondes non négatives comptabilisées dans le temps. La valeur doit être comprise entre 0 et 999 999 999 inclus.

Annotations d'outils

Indication destructive : ❌ | Indication idempotente : ✅ | Indication en lecture seule : ✅ | Indication Open World : ❌