MCP Tools Reference: paydeveloper.googleapis.com

Alat: query_merchant_performance

Mengambil data performa gabungan tingkat tinggi dan metrik pasca-integrasi untuk profil bisnis penjual tertentu.

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

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

Skema Input

Pesan permintaan untuk mengkueri data performa penjual.

QueryMerchantPerformanceRequest

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

string

Wajib. ID unik penjual yang data performanya diminta.
timeRange

enum (TimeRange)

Opsional. Rentang waktu data performa.

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 sebelumnya, tidak termasuk hari ini.
TIME_RANGE_PAST_WEEK Minggu sebelumnya, tidak termasuk hari ini.

Skema Output

Pesan respons untuk mengkueri performa penjual.

QueryMerchantPerformanceResponse

Representasi JSON 
{
  "merchantPerformanceMetrics": [
    {
      object (MerchantPerformanceMetric)
    }
  ]
}
Kolom
merchantPerformanceMetrics[]

object (MerchantPerformanceMetric)

Data performa penjual.

MerchantPerformanceMetric

Representasi JSON 
{
  "metricDetail": {
    object (MetricDetail)
  },
  "hourlyMetricValues": [
    {
      object (HourlyMetricValue)
    }
  ]
}
Kolom
metricDetail

object (MetricDetail)

Hanya output. Detail metrik.
hourlyMetricValues[]

object (HourlyMetricValue)

Hanya output. Daftar nilai metrik dan stempel waktunya, yang dibulatkan ke awal jam terdekat.

MetricDetail

Representasi JSON 
{
  "metricType": enum (MetricType),
  "additionalDetails": {
    string: string,
    ...
  }
}
Kolom
metricType

enum (MetricType)

Jenis metrik.
additionalDetails

map (key: string, value: string)

Pasangan nilai kunci untuk detail tambahan tentang metrik, misalnya, "gateway": "stripe". Untuk mengetahui detailnya, lihat

Objek yang berisi daftar "key": value pasangan. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

AdditionalDetailsEntry

Representasi JSON 
{
  "key": string,
  "value": string
}
Kolom
key

string
value

string

HourlyMetricValue

Representasi JSON 
{
  "hourlyTimestamp": string,
  "value": number
}
Kolom
hourlyTimestamp

string (Timestamp format)

Stempel waktu nilai metrik yang dibulatkan ke awal jam terdekat.

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

number

Nilai metrik sebenarnya. Untuk rasio konversi, nilainya berada dalam rentang [0, 1]. Untuk metrik lainnya, nilainya adalah bilangan bulat non-negatif.

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 nano non-negatif yang dihitung ke depan dalam waktu. Harus antara 0 dan 999.999.999 inklusif.

MetricType

Jenis metrik yang diukur.

Enum
METRIC_TYPE_UNSPECIFIED Jenis metrik tidak ditentukan.
FACILITATION_COUNT Jumlah fasilitas GPay API yang berhasil.
VISIT_COUNT Jumlah klik pada tombol GPay API.
CONVERSION_RATE Rasio konversi tombol checkout, yang ditentukan sebagai rasio jumlah fasilitas GPay API yang berhasil dengan jumlah klik pada tombol GPay API.

Anotasi Alat

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

Selain string judul, petunjuk boolean berikut ditentukan sebagai berikut:

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

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