MCP Tools Reference: paydeveloper.googleapis.com

ツール: query_merchant_error_metrics

特定の販売者のビジネス プロフィールの詳細なエラー指標を取得します。このツールを使用すると、エラーを細かく分類して、問題を特定して解決できます。

次のコードサンプルは、curl を使用して query_merchant_error_metrics MCP ツールを呼び出す方法を示しています。

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

入力スキーマ

販売者のエラー指標をクエリするリクエスト メッセージ。

QueryMerchantErrorMetricsRequest

JSON 表現 
{
  "merchantId": string,
  "timeRange": enum (TimeRange)
}
フィールド
merchantId

string

必須。エラー指標がリクエストされている販売者の一意の識別子。
timeRange

enum (TimeRange)

省略可。エラー指標データの期間。

TimeRange

データの期間。次の ID: 4

列挙型
TIME_RANGE_UNSPECIFIED 期間が指定されていません。
TIME_RANGE_PAST_DAY 過去 1 日間（昨日）。
TIME_RANGE_PAST_THREE_DAYS 過去 3 日間（当日を除く）。
TIME_RANGE_PAST_WEEK 過去 1 週間（当日を除く）。

出力スキーマ

販売者のエラー指標をクエリするレスポンス メッセージ。

QueryMerchantErrorMetricsResponse

JSON 表現 
{
  "errorMetrics": [
    {
      object (MerchantErrorMetric)
    }
  ]
}
フィールド
errorMetrics[]

object (MerchantErrorMetric)

販売者のエラー指標データ。

MerchantErrorMetric

JSON 表現 
{
  "errorDetail": {
    object (ErrorDetail)
  },
  "hourlyErrorCounts": [
    {
      object (HourlyErrorCount)
    }
  ]
}
フィールド
errorDetail

object (ErrorDetail)

出力専用。エラーの詳細。
hourlyErrorCounts[]

object (HourlyErrorCount)

出力専用。エラー数とそのタイムスタンプのリスト（最も近い正時に丸められます）。

ErrorDetail

JSON 表現 
{
  "errorCode": string,
  "errorMessage": string
}
フィールド
errorCode

string

エラーコード（例: OR_BIBED_07）。
errorMessage

string

説明メッセージのみ。ユーザーデータや内部スタック トレースは含まれません。

HourlyErrorCount

JSON 表現 
{
  "hourlyTimestamp": string,
  "count": integer
}
フィールド
hourlyTimestamp

string (Timestamp format)

正時の開始を表すタイムスタンプ。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。
count

integer

この時間内のエラー数。

タイムスタンプ

JSON 表現 
{
  "seconds": string,
  "nanos": integer
}
フィールド
seconds

string (int64 format)

UNIX エポック 1970-01-01T00:00:00Z からの UTC 時刻の秒数を表します。-62135596800～253402300799 の範囲（両端を含む）にする必要があります（これは 0001-01-01T00:00:00Z～9999-12-31T23:59:59Z に対応します）。
nanos

integer

ナノ秒分解能による、秒の負ではない小数以下部分。このフィールドは、秒の代替ではなく、期間のナノ秒部分です。小数以下を含む負の秒の値は、時間を前方にカウントする負ではない nanos 値を持つ必要があります。0 ～ 999,999,999 にする必要があります（両端を含む）。

ツールのアノテーション

ツールのアノテーションは、特定のツールの基本的なリスクを説明するために MCP クライアントに送信されます。ほとんどのクライアントはこれらのヒントを信頼できないものとして扱いますが、確認プロンプトをユーザーに送信するタイミングを判断するために使用できます。

タイトル文字列とともに、次のブール値のヒントが次のように定義されます。

  • readOnlyHint: true の場合、ツールはその環境を変更しません。デフォルトは false です。
  • destructiveHint: true の場合、ツールは破壊的なアクションを実行できます。false の場合、ツールは追加アクションのみを実行できます。デフォルト値は true です。
  • idempotentHint: true の場合、同じ引数でツールを繰り返し呼び出しても、環境に影響はありません。デフォルトは false です。
  • openWorldHint: true の場合、ツールは外部エンティティの「オープン ワールド」とやり取りできます。false の場合、ツールは内部エンティティとのみやり取りできます。たとえば、ウェブ検索ツールはオープン ワールドですが、メモリツールはオープン ワールドではありません。

破壊的ヒント: ❌ | べき等ヒント: ✅ | 読み取り専用ヒント: ✅ | オープン ワールド ヒント: ❌