Consulta las estadísticas y los problemas de los productos

Puedes usar el aggregateProductStatuses.list método 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 los datos de tus productos sin necesidad de recuperar cada producto individual. Este método proporciona la cantidad total de productos que tienes, desglosada por estado (aprobado, pendiente, rechazado) y también enumera los problemas que afectan tus productos.

Consideraciones especiales

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

  • Disponibilidad de 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 se refleja su estado en la aggregateProductStatuses respuesta.
  • Coherencia de los problemas: Los títulos y las descripciones de los problemas que muestra el aggregateProductStatuses.list deben ser coherentes con los problemas que muestra 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 parámetros, 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 correcta:

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

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 usando el parámetro de consulta filter con 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 correcta:

{
  "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"
          ]
        }
      ]
    }
  ]
}
Anterior
Display issues and solutions to businesses