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. Ciò è utile per monitorare lo stato generale dei dati di prodotto senza dover recuperare ogni singolo prodotto. Questo metodo fornisce il numero totale di prodotti che hai, suddivisi per stato (approvato, in attesa, non approvato) 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 l'inserimento o l'aggiornamento di un prodotto 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.

Ottenere 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. La 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 di una chiamata riuscita:

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

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ù, vedi 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 di una chiamata riuscita:

{
  "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"
          ]
        }
      ]
    }
  ]
}
Indietro
Display issues and solutions to businesses