Afficher les statistiques et les problèmes liés aux produits

Utilisez la méthode aggregateProductStatuses.list pour obtenir une vue d'ensemble de l'état des produits dans votre compte Merchant Center. Cela vous permet de surveiller l'état général de vos données produit sans avoir à extraire chaque produit individuellement. Cette méthode fournit le nombre total de produits que vous possédez, ventilé par état (approuvé, en attente, refusé), et liste également tous les problèmes qui affectent vos produits.

Considérations particulières

Il existe des points spécifiques à prendre en compte lorsque vous utilisez la méthode aggregateProductStatuses.list.

  • Disponibilité des données : prévoyez un délai de plus de 30 minutes entre l'insertion ou la mise à jour d'un produit et l'affichage de son état dans la réponse aggregateProductStatuses.
  • Cohérence des problèmes : les titres et les descriptions des problèmes renvoyés par la méthode aggregateProductStatuses.list sont censés être cohérents avec les problèmes renvoyés par l'API Products. Toutefois, elles peuvent différer des descriptions des problèmes affichées dans l'interface utilisateur Merchant Center.

Obtenir un aperçu de tous les états des produits

Cet exemple montre comment récupérer une liste de ressources AggregateProductStatus. Chaque ressource représente l'état des produits pour une combinaison spécifique de destination et de pays. L'appel aggregateProductStatuses.list sans aucun paramètre renvoie tous les états disponibles pour votre compte.

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

Voici un exemple de réponse à un appel réussi :

{
  "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/en~US~SKU001",
            "accounts/{ACCOUNT_ID}/products/en~US~SKU002"
          ]
        },
        {
          "issueType": "invalid_price",
          "severity": "CRITICAL",
          "numProducts": "10",
          "sampleProducts": [
            "accounts/{ACCOUNT_ID}/products/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/en~US~SKU001",
            "accounts/{ACCOUNT_ID}/products/en~US~SKU002"
          ]
        }
      ]
    }
  ]
}

Obtenir l'état des produits pour un pays et une destination spécifiques

Filtrez les résultats pour afficher l'état d'un pays et d'une destination spécifiques à l'aide du paramètre de requête filter avec la méthode aggregateProductStatuses.list. Exemple : country = "US" AND reportingContext = "SHOPPING_ADS". Pour en savoir plus sur la syntaxe des filtres, consultez Syntaxe des filtres.

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

Voici un exemple de réponse à un appel réussi :

{
  "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/en~US~SKU001",
            "accounts/{ACCOUNT_ID}/products/en~US~SKU002"
          ]
        },
        {
          "issueType": "invalid_price",
          "severity": "CRITICAL",
          "numProducts": "10",
          "sampleProducts": [
            "accounts/{ACCOUNT_ID}/products/en~US~SKU003"
          ]
        }
      ]
    }
  ]
}
Précédent
Display issues and solutions to businesses