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

Vous pouvez utiliser la méthode aggregateProductStatuses.list pour obtenir un aperçu général de l'état des produits dans votre compte Merchant Center. Cela est utile pour surveiller l'état général de vos données produit sans avoir à récupérer chaque produit individuellement. Cette méthode fournit le nombre total de produits que vous possédez, ventilés par état (approuvé, en attente, refusé), et liste également les problèmes qui affectent vos produits.

Considérations particulières

Il existe des considérations spéciales 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 de Merchant Center.

Afficher 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. Si vous appelez aggregateProductStatuses.list sans aucun paramètre, tous les états disponibles pour votre compte sont renvoyés.

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

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

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

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

Vous pouvez filtrer 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, consultez la section 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/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"
          ]
        }
      ]
    }
  ]
}