Produktstatistiken und ‑probleme ansehen

Mit der aggregateProductStatuses.list Methode erhalten Sie einen allgemeinen Überblick über den Status der Produkte in Ihrem Merchant Center-Konto. So können Sie den allgemeinen Zustand Ihrer Produktdaten im Blick behalten, ohne jedes einzelne Produkt abrufen zu müssen. Diese Methode liefert die Gesamtzahl Ihrer Produkte, aufgeschlüsselt nach Status (genehmigt, ausstehend, abgelehnt), und listet auch alle Probleme auf, die sich auf Ihre Produkte auswirken.

Besonderheiten

Bei der Verwendung der Methode aggregateProductStatuses.list 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 Problem-Titel und ‑Beschreibungen sollten 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.

Überblick über alle Produktstatus abrufen

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 Zielanwendung 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 sehen Sie ein Beispiel für eine Antwort nach einem 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

Sie können die Ergebnisse filtern, um den Status für ein bestimmtes Land und eine bestimmte Zielanwendung 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 sehen Sie ein Beispiel für eine Antwort nach einem 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