Visualizzare statistiche e problemi relativi ai prodotti

Puoi utilizzare il metodo aggregateProductStatuses.list per ottenere una panoramica generale dello stato dei prodotti nel tuo account Merchant Center. Questo è utile per monitorare l'integrità complessiva dei dati di prodotto senza dover recuperare ogni singolo prodotto. Questo metodo fornisce il numero totale di prodotti che hai, suddivisi per stato (approvati, in attesa, disapprovati) ed elenca anche eventuali problemi che interessano i tuoi prodotti.

Considerazioni speciali

Esistono considerazioni speciali quando si utilizza il metodo aggregateProductStatuses.list.

• Disponibilità dei dati: prevedi un ritardo di oltre 30 minuti tra il momento in cui un prodotto viene inserito o aggiornato e il momento in cui il suo stato viene visualizzato nella risposta aggregateProductStatuses.
• Coerenza dei problemi: i titoli e le descrizioni dei problemi restituiti dal metodo aggregateProductStatuses.list devono essere coerenti con i problemi restituiti dall'API Products. Tuttavia, potrebbero differire dalle descrizioni dei problemi mostrate nell'interfaccia utente di Merchant Center.

Visualizzare una panoramica di tutti gli stati dei prodotti

Questo esempio mostra come recuperare un elenco di risorse AggregateProductStatus. Ogni risorsa rappresenta lo stato dei prodotti per una combinazione specifica di destinazione e paese. Chiamata aggregateProductStatuses.list senza parametri restituisce tutti gli stati disponibili per il tuo account.

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

Ecco una risposta di esempio a una chiamata riuscita:

{
  "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"
          ]
        }
      ]
    }
  ]
}

Visualizzare gli stati dei prodotti per un paese e una destinazione specifici

Puoi filtrare i risultati per visualizzare lo stato di un paese e di una destinazione specifici utilizzando il parametro di query filter con il metodo aggregateProductStatuses.list. Ad esempio: country = "US" AND reportingContext = "SHOPPING_ADS". Per saperne di più, consulta la sezione Sintassi del filtro.

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

Ecco una risposta di esempio a una chiamata riuscita:

{
  "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"
          ]
        }
      ]
    }
  ]
}