查看商品统计信息和问题

使用 aggregateProductStatuses.list 方法大致了解 Merchant Center 账号中的商品状态。这有助于监控商品数据的整体健康状况，而无需提取每件商品的数据。此方法会提供您拥有的商品总数（按状态 [已批准、待审核、未批准] 细分），还会列出影响您商品的任何问题。

特别注意事项

使用 aggregateProductStatuses.list 方法时，需要注意一些特殊事项。

• 数据可用性：从插入或更新商品到其状态反映在 aggregateProductStatuses 响应中，预计会有超过 30 分钟的延迟。
• 问题一致性：aggregateProductStatuses.list 方法返回的问题标题和说明旨在与 Products API 返回的问题保持一致。不过，它们可能与 Merchant Center 界面中显示的问题说明不同。

查看所有商品状态的概览

此示例展示了如何检索 AggregateProductStatus 资源列表。 每个资源都代表特定目标平台和国家/地区组合的商品状态。在不使用任何参数的情况下调用 aggregateProductStatuses.list 会返回您账号的所有可用状态。

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/aggregateProductStatuses

以下是成功调用的示例响应：

{
  "aggregateProductStatuses": [
    {
      "name": "accounts/{ACCOUNT_ID}/aggregateProductStatuses/SHOPPING_ADS~US",
      "reportingContext": "SHOPPING_ADS",
      "countryCode": "US",
      "statistics": {
        "approvedCount": "1500",
        "pendingCount": "50",
        "disapprovedCount": "25"
      },
      "issues": [
        {
          "issueType": "missing_image",
          "severity": "ERROR",
          "numProducts": "15",
          "sampleProducts": [
            "accounts/{ACCOUNT_ID}/products/en~US~SKU001",
            "accounts/{ACCOUNT_ID}/products/en~US~SKU002"
          ]
        },
        {
          "issueType": "invalid_price",
          "severity": "CRITICAL",
          "numProducts": "10",
          "sampleProducts": [
            "accounts/{ACCOUNT_ID}/products/en~US~SKU003"
          ]
        }
      ]
    },
    {
      "name": "accounts/{ACCOUNT_ID}/aggregateProductStatuses/FREE_LISTINGS~US",
      "reportingContext": "FREE_LISTINGS",
      "countryCode": "US",
      "statistics": {
        "approvedCount": "1510",
        "pendingCount": "50",
        "disapprovedCount": "15"
      },
      "issues": [
        {
          "issueType": "missing_image",
          "severity": "ERROR",
          "numProducts": "15",
          "sampleProducts": [
            "accounts/{ACCOUNT_ID}/products/en~US~SKU001",
            "accounts/{ACCOUNT_ID}/products/en~US~SKU002"
          ]
        }
      ]
    }
  ]
}

获取特定国家/地区和目标平台的商品状态

使用 filter 查询参数和 aggregateProductStatuses.list 方法过滤结果，以查看特定国家/地区和目标平台的状态。例如：country = "US" AND reportingContext = "SHOPPING_ADS"。 如需详细了解过滤条件语法，请参阅过滤条件语法。

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/aggregateProductStatuses?filter=countryCode%3D"US"%20AND%20reportingContext%3D"SHOPPING_ADS"

以下是成功调用的示例响应：

{
  "aggregateProductStatuses": [
    {
      "name": "accounts/{ACCOUNT_ID}/aggregateProductStatuses/SHOPPING_ADS~US",
      "reportingContext": "SHOPPING_ADS",
      "countryCode": "US",
      "statistics": {
        "approvedCount": "1500",
        "pendingCount": "50",
        "disapprovedCount": "25"
      },
      "issues": [
        {
          "issueType": "missing_image",
          "severity": "ERROR",
          "numProducts": "15",
          "sampleProducts": [
            "accounts/{ACCOUNT_ID}/products/en~US~SKU001",
            "accounts/{ACCOUNT_ID}/products/en~US~SKU002"
          ]
        },
        {
          "issueType": "invalid_price",
          "severity": "CRITICAL",
          "numProducts": "10",
          "sampleProducts": [
            "accounts/{ACCOUNT_ID}/products/en~US~SKU003"
          ]
        }
      ]
    }
  ]
}