MCP Tools Reference: paydeveloper.googleapis.com

Alat: query_merchant_error_metrics

Mengambil metrik error mendetail untuk profil bisnis penjual tertentu. Alat ini memberikan perincian kesalahan yang terperinci, memungkinkan developer untuk mengidentifikasi dan menyelesaikan masalah.

Contoh kode berikut menunjukkan cara menggunakan curl untuk memanggil alat MCP query_merchant_error_metrics.

Permintaan 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
}'

Skema Input

Pesan permintaan untuk membuat kueri metrik error penjual.

QueryMerchantErrorMetricsRequest

Representasi JSON 
{
  "merchantId": string,
  "timeRange": enum (TimeRange)
}
Kolom
merchantId

string

Wajib. ID unik penjual yang metrik errornya diminta.
timeRange

enum (TimeRange)

Opsional. Rentang waktu data metrik error.

TimeRange

Rentang waktu data. ID Berikutnya: 4

Enum
TIME_RANGE_UNSPECIFIED Rentang waktu tidak ditentukan.
TIME_RANGE_PAST_DAY Hari sebelumnya, kemarin.
TIME_RANGE_PAST_THREE_DAYS Tiga hari terakhir, tidak termasuk hari ini.
TIME_RANGE_PAST_WEEK Satu minggu terakhir, tidak termasuk hari ini.

Skema Output

Pesan respons untuk membuat kueri metrik error penjual.

QueryMerchantErrorMetricsResponse

Representasi JSON 
{
  "errorMetrics": [
    {
      object (MerchantErrorMetric)
    }
  ]
}
Kolom
errorMetrics[]

object (MerchantErrorMetric)

Data metrik kesalahan pedagang.

MerchantErrorMetric

Representasi JSON 
{
  "errorDetail": {
    object (ErrorDetail)
  },
  "hourlyErrorCounts": [
    {
      object (HourlyErrorCount)
    }
  ]
}
Kolom
errorDetail

object (ErrorDetail)

Hanya output. Detail error.
hourlyErrorCounts[]

object (HourlyErrorCount)

Hanya output. Daftar jumlah error dan stempel waktunya, yang dibulatkan ke awal jam terdekat.

ErrorDetail

Representasi JSON 
{
  "errorCode": string,
  "errorMessage": string
}
Kolom
errorCode

string

Kode error, misalnya "OR_BIBED_07".
errorMessage

string

Hanya pesan deskriptif, tidak ada data pengguna atau rekaman aktivitas internal.

HourlyErrorCount

Representasi JSON 
{
  "hourlyTimestamp": string,
  "count": integer
}
Kolom
hourlyTimestamp

string (Timestamp format)

Stempel waktu yang menunjukkan awal jam.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
count

integer

Jumlah error dalam satu jam ini.

Stempel waktu

Representasi JSON 
{
  "seconds": string,
  "nanos": integer
}
Kolom
seconds

string (int64 format)

Mewakili detik waktu UTC sejak epoch Unix 1970-01-01T00:00:00Z. Harus antara -62135596800 dan 253402300799 inklusif (yang sesuai dengan 0001-01-01T00:00:00Z hingga 9999-12-31T23:59:59Z).
nanos

integer

Pecahan detik non-negatif pada resolusi nanodetik. Kolom ini adalah bagian nanodetik dari durasi, bukan alternatif untuk detik. Nilai detik negatif dengan pecahan harus tetap memiliki nilai nanos non-negatif yang dihitung maju dalam waktu. Harus antara 0 dan 999.999.999 inklusif.

Anotasi Alat

Anotasi alat dikirim ke klien MCP untuk menjelaskan risiko dasar alat tertentu. Sebagian besar klien memperlakukan petunjuk ini sebagai tidak tepercaya, tetapi petunjuk ini dapat digunakan untuk memutuskan kapan perintah konfirmasi dapat dikirim ke pengguna.

Selain string judul, petunjuk boolean berikut ditentukan sebagai berikut:

  • readOnlyHint: Jika benar, alat tidak akan mengubah lingkungannya. Default: false.
  • destructiveHint: Jika benar (true), alat dapat melakukan tindakan merusak. Jika salah (false), alat hanya dapat melakukan tindakan tambahan. Default: true.
  • idempotentHint: Jika benar (true), memanggil alat berulang kali dengan argumen yang sama tidak akan memberikan efek tambahan pada lingkungannya. Default: false.
  • openWorldHint: Jika benar, alat dapat berinteraksi dengan 'dunia terbuka' entitas eksternal. Jika salah (false), alat hanya dapat berinteraksi dengan entitas internal. Misalnya, alat penelusuran web akan menjadi open world, sedangkan alat memori tidak akan menjadi open world.

Petunjuk Destruktif: ❌ | Petunjuk Idempoten: ✅ | Petunjuk Hanya Baca: ✅ | Petunjuk Dunia Terbuka: ❌