Consulta las estadísticas y los problemas de los productos

Puedes usar el método aggregateProductStatuses.list para obtener una descripción general del estado de los productos en tu cuenta de Merchant Center. Esto es útil para supervisar el estado general de tus datos de productos sin necesidad de recuperar cada producto individual. Este método proporciona la cantidad total de productos que tienes, desglosados por estado (aprobado, pendiente, rechazado), y también enumera los problemas que afectan a tus productos.

Consideraciones especiales

Hay consideraciones especiales cuando se usa el método aggregateProductStatuses.list.

• Disponibilidad de los datos: Espera una demora de más de 30 minutos entre el momento en que se inserta o actualiza un producto y el momento en que su estado se refleja en la respuesta de aggregateProductStatuses.
• Coherencia de los problemas: Los títulos y las descripciones de los problemas que devuelve el método aggregateProductStatuses.list deben ser coherentes con los problemas que devuelve la API de Products. Sin embargo, pueden diferir de las descripciones de los problemas que se muestran en la interfaz de usuario de Merchant Center.

Obtén una descripción general de todos los estados de los productos

En este ejemplo, se muestra cómo recuperar una lista de recursos AggregateProductStatus. Cada recurso representa el estado de los productos para una combinación específica de destino y país. Si llamas a aggregateProductStatuses.list sin ningún parámetro, se mostrarán todos los estados disponibles para tu cuenta.

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

Esta es una respuesta de ejemplo de una llamada exitosa:

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

Obtén los estados de los productos para un país y un destino específicos

Puedes filtrar los resultados para ver el estado de un país y un destino específicos con el parámetro de consulta filter y el método aggregateProductStatuses.list. Por ejemplo: country = "US" AND reportingContext = "SHOPPING_ADS". Para obtener más información, consulta Sintaxis de filtro.

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

Esta es una respuesta de ejemplo de una llamada exitosa:

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