MCP Tools Reference: paydeveloper.googleapis.com

Outil : query_merchant_error_metrics

Récupère des métriques d'erreur détaillées pour une fiche d'établissement spécifique. Cet outil fournit une répartition précise des erreurs, ce qui permet aux développeurs d'identifier et de résoudre les problèmes.

L'exemple de code suivant montre comment utiliser curl pour appeler l'outil MCP query_merchant_error_metrics.

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

Schéma d'entrée

Message de requête pour interroger les métriques d'erreur du marchand.

QueryMerchantErrorMetricsRequest

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

string

Obligatoire. Identifiant unique du marchand pour lequel des métriques d'erreur sont demandées.
timeRange

enum (TimeRange)

Facultatif. Période des données de métriques d'erreur.

TimeRange

Période des données. ID suivant : 4.

Enums
TIME_RANGE_UNSPECIFIED Période non spécifiée.
TIME_RANGE_PAST_DAY Jour précédent, hier.
TIME_RANGE_PAST_THREE_DAYS Trois jours précédents, jour actuel non compris.
TIME_RANGE_PAST_WEEK Semaine précédente, jour actuel non compris.

Schéma de sortie

Message de réponse pour interroger les métriques d'erreur du marchand.

QueryMerchantErrorMetricsResponse

Représentation JSON 
{
  "errorMetrics": [
    {
      object (MerchantErrorMetric)
    }
  ]
}
Champs
errorMetrics[]

object (MerchantErrorMetric)

Données de métriques d'erreur du marchand.

MerchantErrorMetric

Représentation JSON 
{
  "errorDetail": {
    object (ErrorDetail)
  },
  "hourlyErrorCounts": [
    {
      object (HourlyErrorCount)
    }
  ]
}
Champs
errorDetail

object (ErrorDetail)

Uniquement en sortie. Détails de l'erreur.
hourlyErrorCounts[]

object (HourlyErrorCount)

Uniquement en sortie. Liste du nombre d'erreurs et de son code temporel, arrondi au début de l'heure la plus proche.

ErrorDetail

Représentation JSON 
{
  "errorCode": string,
  "errorMessage": string
}
Champs
errorCode

string

Code d'erreur, par exemple "OR_BIBED_07".
errorMessage

string

Message descriptif uniquement, sans données utilisateur ni traces de pile internes.

HourlyErrorCount

Représentation JSON 
{
  "hourlyTimestamp": string,
  "count": integer
}
Champs
hourlyTimestamp

string (Timestamp format)

Code temporel représentant le début de l'heure.

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

integer

Nombre d'erreurs au cours de cette heure.

Code temporel

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. Doit être compris 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. Doit être compris entre 0 et 999 999 999 inclus.

Annotations d'outil

Les annotations d'outil sont envoyées aux clients MCP pour décrire le risque de base d'un outil donné. La plupart des clients traitent ces conseils comme non fiables, mais ils peuvent être utilisés pour déterminer quand une invite de confirmation peut être envoyée à un utilisateur.

Outre la chaîne de titre, les conseils booléens suivants sont définis comme suit :

  • readOnlyHint : si la valeur est "true", l'outil ne modifie pas son environnement. Valeur par défaut : "false".
  • destructiveHint : si la valeur est "true", l'outil peut effectuer des actions destructrices. Si la valeur est "false", l'outil ne peut effectuer que des actions additives. Valeur par défaut : "true".
  • idempotentHint : si la valeur est "true", l'appel répété de l'outil avec les mêmes arguments n'aura aucun effet supplémentaire sur son environnement. Valeur par défaut : "false".
  • openWorldHint : si la valeur est "true", l'outil peut interagir avec un "monde ouvert" d'entités externes. Si la valeur est "false", l'outil ne peut interagir qu'avec des entités internes. Par exemple, un outil de recherche sur le Web serait en monde ouvert, tandis qu'un outil de mémoire ne le serait pas.

Conseil destructif : ❌ | Conseil idempotent : ✅ | Conseil en lecture seule : ✅ | Conseil en monde ouvert : ❌