Produktstatistiken und ‑probleme ansehen

Mit der Methode aggregateProductStatuses.list erhalten Sie einen allgemeinen Überblick über den Status der Produkte in Ihrem Merchant Center-Konto. Das ist nützlich, um den Gesamtzustand Ihrer Produktdaten zu überwachen, ohne jedes einzelne Produkt abrufen zu müssen. Bei dieser Methode wird die Gesamtzahl Ihrer Produkte nach Status (genehmigt, ausstehend, abgelehnt) aufgeschlüsselt. Außerdem werden alle Probleme aufgeführt, die sich auf Ihre Produkte auswirken.

Besonderheiten

Bei der Verwendung der aggregateProductStatuses.list-Methode sind einige Besonderheiten zu beachten.

• Datenverfügbarkeit: Zwischen dem Einfügen oder Aktualisieren eines Produkts und der Aktualisierung des Status in der aggregateProductStatuses-Antwort kann es zu einer Verzögerung von mehr als 30 Minuten kommen.
• Konsistenz der Probleme: Die von der Methode aggregateProductStatuses.list zurückgegebenen Titel und Beschreibungen von Problemen sollen mit den von der Products API zurückgegebenen Problemen übereinstimmen. Sie können jedoch von den Problembeschreibungen abweichen, die in der Merchant Center-Benutzeroberfläche angezeigt werden.

Übersicht aller Produktstatus

In diesem Beispiel wird gezeigt, wie eine Liste von AggregateProductStatus-Ressourcen abgerufen wird. Jede Ressource stellt den Status von Produkten für eine bestimmte Kombination aus Ziel und Land dar. Wenn Sie aggregateProductStatuses.list ohne Parameter aufrufen, werden alle verfügbaren Status für Ihr Konto zurückgegeben.

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

Hier ist eine Beispielantwort für einen erfolgreichen Aufruf:

{
  "aggregateProductStatuses": [
    {
      "name": "accounts/12345/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/12345/products/online~en~US~SKU001",
            "accounts/12345/products/online~en~US~SKU002"
          ]
        },
        {
          "issueType": "invalid_price",
          "severity": "CRITICAL",
          "numProducts": "10",
          "sampleProducts": [
            "accounts/12345/products/online~en~US~SKU003"
          ]
        }
      ]
    },
    {
      "name": "accounts/12345/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/12345/products/online~en~US~SKU001",
            "accounts/12345/products/online~en~US~SKU002"
          ]
        }
      ]
    }
  ]
}

Produktstatus für ein bestimmtes Land und eine bestimmte Zielanwendung abrufen

Sie können die Ergebnisse filtern, um den Status für ein bestimmtes Land und Ziel zu sehen. Verwenden Sie dazu den Abfrageparameter filter mit der Methode aggregateProductStatuses.list. Beispiel: country = "US" AND reportingContext = "SHOPPING_ADS". Weitere Informationen finden Sie unter Filtersyntax.

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

Hier ist eine Beispielantwort für einen erfolgreichen Aufruf:

{
  "aggregateProductStatuses": [
    {
      "name": "accounts/12345/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/12345/products/online~en~US~SKU001",
            "accounts/12345/products/online~en~US~SKU002"
          ]
        },
        {
          "issueType": "invalid_price",
          "severity": "CRITICAL",
          "numProducts": "10",
          "sampleProducts": [
            "accounts/12345/products/online~en~US~SKU003"
          ]
        }
      ]
    }
  ]
}