MCP Tools Reference: paydeveloper.googleapis.com

Araç: query_merchant_performance

Belirli bir satıcının işletme profili için üst düzey toplu performans verilerini ve entegrasyon sonrası metrikleri alır.

Aşağıdaki kod örneğinde, query_merchant_performance MCP aracını çağırmak için curl simgesinin nasıl kullanılacağı gösterilmektedir.

Curl İsteği 
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
}'

Giriş Şeması

Satıcı performans verilerini sorgulamak için istek mesajı.

QueryMerchantPerformanceRequest

JSON gösterimi 
{
  "merchantId": string,
  "timeRange": enum (TimeRange)
}
Alanlar
merchantId

string

Zorunlu. Performans verilerinin istendiği satıcının benzersiz tanımlayıcısı.
timeRange

enum (TimeRange)

İsteğe bağlı. Performans verilerinin zaman aralığı.

TimeRange

Verilerin zaman aralığı. Sonraki kimlik: 4

Sıralamalar
TIME_RANGE_UNSPECIFIED Belirtilmemiş zaman aralığı.
TIME_RANGE_PAST_DAY Geçen gün, dün.
TIME_RANGE_PAST_THREE_DAYS Geçerli gün hariç olmak üzere son üç gün.
TIME_RANGE_PAST_WEEK Geçerli gün hariç olmak üzere geçen hafta.

Çıkış şeması

Satıcı performansını sorgulamaya yönelik yanıt mesajı.

QueryMerchantPerformanceResponse

JSON gösterimi 
{
  "merchantPerformanceMetrics": [
    {
      object (MerchantPerformanceMetric)
    }
  ]
}
Alanlar
merchantPerformanceMetrics[]

object (MerchantPerformanceMetric)

Satıcının performans verileri.

MerchantPerformanceMetric

JSON gösterimi 
{
  "metricDetail": {
    object (MetricDetail)
  },
  "hourlyMetricValues": [
    {
      object (HourlyMetricValue)
    }
  ]
}
Alanlar
metricDetail

object (MetricDetail)

Yalnızca çıkış. Metriğin ayrıntıları.
hourlyMetricValues[]

object (HourlyMetricValue)

Yalnızca çıkış. Metrik değerinin ve zaman damgasının listesi (en yakın saate yuvarlanmış).

MetricDetail

JSON gösterimi 
{
  "metricType": enum (MetricType),
  "additionalDetails": {
    string: string,
    ...
  }
}
Alanlar
metricType

enum (MetricType)

Metriğin türü.
additionalDetails

map (key: string, value: string)

Ölçümle ilgili ek ayrıntılar için anahtar-değer çiftleri, örneğin, "ağ geçidi": "şerit". Ayrıntılar için

"key": value çiftlerinin listesini içeren bir nesne. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

AdditionalDetailsEntry

JSON gösterimi 
{
  "key": string,
  "value": string
}
Alanlar
key

string
value

string

HourlyMetricValue

JSON gösterimi 
{
  "hourlyTimestamp": string,
  "value": number
}
Alanlar
hourlyTimestamp

string (Timestamp format)

Metrik değerinin, en yakın saat başına yuvarlanmış zaman damgası.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
value

number

Gerçek metrik değeri. Dönüşüm oranı için değer [0, 1] aralığındadır. Diğer metrikler için değer, sıfırdan büyük bir tam sayı olmalıdır.

Zaman damgası

JSON gösterimi 
{
  "seconds": string,
  "nanos": integer
}
Alanlar
seconds

string (int64 format)

Unix Epoch 1970-01-01T00:00:00Z'den bu yana geçen UTC süresini saniye cinsinden gösterir. -62135596800 ile 253402300799 arasında (0001-01-01T00:00:00Z ile 9999-12-31T23:59:59Z'ye karşılık gelir) olmalıdır.
nanos

integer

Nanosaniye çözünürlüğünde, negatif olmayan saniyenin kesirleri. Bu alan, saniyelere alternatif olarak değil, sürenin nanosaniye kısmını belirtmek için kullanılır. Kesirli negatif saniye değerleri, zaman içinde ileriye doğru sayılan negatif olmayan nanos değerlerine sahip olmalıdır. 0 ile 999.999.999 arasında olmalıdır (bu değerler dahil).

MetricType

Ölçülen metriğin türü.

Sıralamalar
METRIC_TYPE_UNSPECIFIED Belirtilmemiş metrik türü.
FACILITATION_COUNT Başarılı GPay API kolaylaştırma sayısı.
VISIT_COUNT GPay API düğmesinin tıklanma sayısı.
CONVERSION_RATE Ödeme düğmesinin dönüşüm oranı, başarılı GPay API kolaylaştırma sayısının GPay API düğmesinin tıklanma sayısına oranı olarak tanımlanır.

Araç Ek Açıklamaları

Araç açıklamaları, belirli bir aracın temel riskini açıklamak için MCP istemcilerine gönderilir. Çoğu istemci bu ipuçlarını güvenilmeyen olarak değerlendirir ancak onay isteminin kullanıcıya ne zaman gönderileceğine karar vermek için kullanılabilirler.

Başlık dizesinin yanı sıra aşağıdaki Boole ipuçları şu şekilde tanımlanır:

  • readOnlyHint: Doğruysa araç, ortamını değiştirmez. Varsayılan: false.
  • destructiveHint: Doğruysa araç, yıkıcı işlemler gerçekleştirebilir. Yanlış ise araç yalnızca ekleme işlemleri gerçekleştirebilir. Varsayılan: true.
  • idempotentHint: Doğruysa aynı bağımsız değişkenlerle aracı tekrar tekrar çağırmanın ortamı üzerinde ek bir etkisi olmaz. Varsayılan: false.
  • openWorldHint: Doğruysa araç, harici öğelerden oluşan bir "açık dünya" ile etkileşim kurabilir. Yanlışsa araç yalnızca dahili öğelerle etkileşim kurabilir. Örneğin, bir web arama aracı açık dünya olurken bir bellek aracı açık dünya olmaz.

Yıkıcı İpucu: ❌ | İdempotent İpucu: ✅ | Salt Okunur İpucu: ✅ | Açık Dünya İpucu: ❌