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: Es kann mehr als 30 Minuten dauern, bis der Status eines Produkts in der Antwort aggregateProductStatuses angezeigt wird, nachdem es eingefügt oder aktualisiert wurde.
• Konsistenz der Probleme: Die Titel und Beschreibungen der Probleme, die von der aggregateProductStatuses.list Methode zurückgegeben werden, sollten mit den Problemen übereinstimmen, die von der Products API zurückgegeben werden. 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 eine Beispielantwort von 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 eine Beispielantwort von 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"
          ]
        }
      ]
    }
  ]
}