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

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

Considérations particulières

L'utilisation de la méthode aggregateProductStatuses.list nécessite de prendre en compte certains éléments.

• 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 aggregateProductStatuses réponse.
• Cohérence des problèmes : les titres et les descriptions des problèmes renvoyés par la méthode aggregateProductStatuses.list doivent être cohérents avec les problèmes renvoyés par l'API Products. Toutefois, ils 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. 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/{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"
          ]
        }
      ]
    }
  ]
}

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