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 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 tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Skema Input

Pesan permintaan untuk membuat kueri 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 terakhir, tidak termasuk hari ini.
TIME_RANGE_PAST_WEEK Satu minggu terakhir, 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 pasangan "key": value. 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 maju 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 fasilitasi API GPay yang berhasil.
VISIT_COUNT Jumlah klik pada tombol GPay API.
CONVERSION_RATE Rasio konversi tombol checkout, yang ditentukan sebagai rasio jumlah fasilitasi API GPay yang berhasil dengan jumlah klik pada tombol API GPay.

Anotasi Alat

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