Consulta las estadísticas y los problemas de los productos

Usa el método aggregateProductStatuses.list para obtener una descripción general de alto nivel 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 (aprobados, pendientes, rechazados), y también enumera los problemas que afectan a tus productos.

Consideraciones especiales

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

  • Disponibilidad de los datos: Se espera un retraso 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 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, es posible que difieran 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 devuelven todos los estados disponibles para tu cuenta.

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

A continuación, se muestra 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/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"
          ]
        }
      ]
    }
  ]
}

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

Filtra 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 información más detallada sobre la sintaxis de los filtros, consulta Sintaxis de los filtros.

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

A continuación, se muestra 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/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"
          ]
        }
      ]
    }
  ]
}
Anterior
Display issues and solutions to businesses