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

Utilisez la méthode aggregateProductStatuses.list pour obtenir un aperçu général de l'état des produits de 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 dont vous disposez, répartis par état (approuvé, en attente, refusé), et liste également les problèmes qui affectent vos produits.

Remarques

Il existe des considérations particulières lors de l'utilisation de la méthode aggregateProductStatuses.list.

• Disponibilité des données : attendez-vous à 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 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 de problèmes affichées dans l'interface utilisateur de Merchant Center.

Obtenir un aperçu de l'état de tous les 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 de 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 en utilisant le 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"
          ]
        }
      ]
    }
  ]
}