查询Google Postmaster v2beta API的DELIVERY_ERROR_RATE指标遇400错误求助

问题背景 #

调用POST https://gmailpostmastertools.googleapis.com/v2beta/{parent=domains/*}/domainStats:query端点查询DELIVERY_ERROR_RATE指标时，始终返回400 INVALID_ARGUMENT错误。官方文档未明确该指标的过滤器格式，尝试多种猜测格式（如delivery_error_type = "RATE_LIMIT_EXCEEDED"）均无效。

正确请求格式 #

DELIVERY_ERROR_RATE的过滤器字段应为error_type，而非猜测的delivery_error_type，以下是可直接复用的请求体示例：

{
  "metricDefinitions": [
    {
      "name": "delivery_error_rate_rate_limit",
      "baseMetric": {
        "standardMetric": "DELIVERY_ERROR_RATE"
      },
      "filter": "error_type = \"RATE_LIMIT_EXCEEDED\""
    }
  ],
  "timeQuery": {
    "dateRanges": {
      "dateRanges": [
        {
          "start": { "year": 2025, "month": 11, "day": 1 },
          "end":   { "year": 2025, "month": 11, "day": 30 }
        }
      ]
    }
  },
  "pageSize": 200
}

可用的error_type枚举值 #

经过实测，DELIVERY_ERROR_RATE支持的错误类型包括：

• RATE_LIMIT_EXCEEDED
• INVALID_RECIPIENT
• CONTENT_POLICY_VIOLATION
• DNS_FAILURE
• CONNECTION_FAILURE
• OTHER

全类型错误率查询 #

如果需要查询所有类型的投递错误率总和，可直接省略过滤器字段，仅保留baseMetric配置即可：

{
  "metricDefinitions": [
    {
      "name": "total_delivery_error_rate",
      "baseMetric": {
        "standardMetric": "DELIVERY_ERROR_RATE"
      }
    }
  ],
  "timeQuery": {
    "dateRanges": {
      "dateRanges": [
        {
          "start": { "year": 2025, "month": 11, "day": 1 },
          "end":   { "year": 2025, "month": 11, "day": 30 }
        }
      ]
    }
  },
  "pageSize": 200
}

内容的提问来源于stack exchange，提问作者Zacky