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. Diese Methode liefert die Gesamtzahl Ihrer Produkte, aufgeschlüsselt nach Status (genehmigt, ausstehend, abgelehnt), und listet alle Probleme auf, die sich auf Ihre Produkte auswirken.

Besonderheiten

Bei der Verwendung der Methode aggregateProductStatuses.list sind besondere Überlegungen zu berücksichtigen.

• Datenverfügbarkeit: Es kann mehr als 30 Minuten dauern, bis der Status eines Produkts nach dem Einfügen oder Aktualisieren in der aggregateProductStatuses-Antwort angezeigt wird.
• Konsistenz der Probleme: Die von der Methode aggregateProductStatuses.list zurückgegebenen Titel und Beschreibungen der Probleme sollten mit den von der Products API zurückgegebenen Problemen übereinstimmen. Sie können jedoch von den Problembeschreibungen in der Merchant Center-Benutzeroberfläche abweichen.

Übersicht über alle Produktstatus

In diesem Beispiel wird gezeigt, wie Sie eine Liste von AggregateProductStatus-Ressourcen abrufen. 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/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"
          ]
        }
      ]
    }
  ]
}

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

Filtern Sie die Ergebnisse, um den Status für ein bestimmtes Land und Ziel zu sehen. Verwenden Sie dazu den Suchparameter filter mit der Methode aggregateProductStatuses.list. 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/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"
          ]
        }
      ]
    }
  ]
}