Tool: query_merchant_error_metrics
Retrieves detailed error metrics for a specific merchant business profile. This tool provides a granular breakdown of errors, allowing developers to pinpoint and resolve issues.
The following sample demonstrate how to use curl
to invoke the query_merchant_error_metrics
MCP tool.
| Curl Request |
|---|
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 tool' s MCP specification } } , "jsonrpc" : "2.0" , "id" : 1 } ' |
Input Schema
Request message for querying merchant error metrics.
QueryMerchantErrorMetricsRequest
| JSON representation |
|---|
{
"merchantId"
:
string
,
"timeRange"
:
enum (
|
| Fields | |
|---|---|
merchantId
|
Required. The unique identifier of the merchant for which error metrics are being requested. |
timeRange
|
Optional. The time range of the error metrics data. |
Output Schema
Response message for querying merchant error metrics.
QueryMerchantErrorMetricsResponse
| JSON representation |
|---|
{
"errorMetrics"
:
[
{
object (
|
| Fields | |
|---|---|
errorMetrics[]
|
The error metrics data of the merchant. |
MerchantErrorMetric
| JSON representation |
|---|
{ "errorDetail" : { object ( |
| Fields | |
|---|---|
errorDetail
|
Output only. Details of the error. |
hourlyErrorCounts[]
|
Output only. A list of error count and its timestamp, rounded to the nearest top of hour. |
ErrorDetail
| JSON representation |
|---|
{ "errorCode" : string , "errorMessage" : string } |
| Fields | |
|---|---|
errorCode
|
Error code, e.g. "OR_BIBED_07". |
errorMessage
|
Descriptive message only, no user data nor internal stack traces. |
HourlyErrorCount
| JSON representation |
|---|
{ "hourlyTimestamp" : string , "count" : integer } |
| Fields | |
|---|---|
hourlyTimestamp
|
Timestamp representing the start of the hour. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: |
count
|
The number of errors within this hour. |
Timestamp
| JSON representation |
|---|
{ "seconds" : string , "nanos" : integer } |
| Fields | |
|---|---|
seconds
|
Represents seconds of UTC time since Unix epoch 1970-01-01T00:00:00Z. Must be between -62135596800 and 253402300799 inclusive (which corresponds to 0001-01-01T00:00:00Z to 9999-12-31T23:59:59Z). |
nanos
|
Non-negative fractions of a second at nanosecond resolution. This field is the nanosecond portion of the duration, not an alternative to seconds. Negative second values with fractions must still have non-negative nanos values that count forward in time. Must be between 0 and 999,999,999 inclusive. |
Tool Annotations
Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌

