Produktstatistiken und ‑probleme ansehen

Mit der Methode aggregateProductStatuses.list können Sie sich einen allgemeinen Überblick über den Status der Produkte in Ihrem Merchant Center-Konto verschaffen. Das ist nützlich, um den allgemeinen Zustand Ihrer Produktdaten zu überwachen, ohne jedes einzelne Produkt abrufen zu müssen. Diese Methode liefert die Gesamtzahl der Produkte, die Sie haben, aufgeschlüsselt nach Status („Genehmigt“, „Ausstehend“, „Abgelehnt“). 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 Anzeige 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 über alle 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/{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/online~en~US~SKU001",
            "accounts/{ACCOUNT_ID}/products/online~en~US~SKU002"
          ]
        },
        {
          "issueType": "invalid_price",
          "severity": "CRITICAL",
          "numProducts": "10",
          "sampleProducts": [
            "accounts/{ACCOUNT_ID}/products/online~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/online~en~US~SKU001",
            "accounts/{ACCOUNT_ID}/products/online~en~US~SKU002"
          ]
        }
      ]
    }
  ]
}

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

Mit dem Abfrageparameter filter und der Methode aggregateProductStatuses.list können Sie die Ergebnisse filtern, um den Status für ein bestimmtes Land und Ziel zu sehen. Beispiel: country = "US" AND reportingContext = "SHOPPING_ADS". Weitere Informationen zur Filtersyntax 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/{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/online~en~US~SKU001",
            "accounts/{ACCOUNT_ID}/products/online~en~US~SKU002"
          ]
        },
        {
          "issueType": "invalid_price",
          "severity": "CRITICAL",
          "numProducts": "10",
          "sampleProducts": [
            "accounts/{ACCOUNT_ID}/products/online~en~US~SKU003"
          ]
        }
      ]
    }
  ]
}
Zurück
Display issues and solutions to businesses