Visualizzare statistiche e problemi relativi ai prodotti

Puoi utilizzare il aggregateProductStatuses.list metodo per ottenere una panoramica di alto livello dello stato dei prodotti nel tuo account Merchant Center. Questo è 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 (approvati, in attesa, non approvati) 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 la visualizzazione del suo stato nella aggregateProductStatuses risposta.
• Coerenza dei problemi: i titoli e le descrizioni dei problemi restituiti dal aggregateProductStatuses.list metodo sono pensati per 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. La chiamata a aggregateProductStatuses.list senza parametri restituisce tutti gli stati disponibili per il tuo account.

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

Di seguito è riportato un esempio di risposta da 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 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 dei filtri.

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

Di seguito è riportato un esempio di risposta da 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"
          ]
        }
      ]
    }
  ]
}