La API de Merchant v1beta se descontinuará y se cerrará el 28 de febrero de 2026. Para conocer los pasos para realizar la transición a la versión estable más reciente, consulta Migra de v1beta a v1.

Evalúa tus productos

Puedes usar la API de Merchant Reports para ver datos de rendimiento, filtrar tus productos por atributos específicos y mejorar tus precios.

Mide el rendimiento

Puedes recuperar las métricas de rendimiento de tu cuenta con la API de Merchant Reports product_performance_view.

Requisitos

Para recuperar este informe, deberás tener el rol de Rendimiento y estadísticas.

Para asignar el rol de Rendimiento y estadísticas a un usuario existente, crea una solicitud de parche y asigna el derecho de acceso PERFORMANCE_REPORTING al usuario. En la siguiente solicitud, se muestra cómo puedes crear una solicitud de parche para asignar el derecho de acceso PERFORMANCE_REPORTING:

PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/users/{EMAIL_ID}

{
  "accessRights": [
    "PERFORMANCE_REPORTING"
  ]
}

Reemplaza lo siguiente:

{ACCOUNT_ID}: Es el identificador único de la cuenta de Merchant Center.
{EMAIL_ID}: Es la dirección de correo electrónico del usuario al que deseas asignar el rol.

Consulta de muestra

La siguiente consulta recupera impressions, clicks y click_through_rate para todos los productos de tu cuenta durante un período específico de 30 días. Para realizar la solicitud, pasa la siguiente instrucción del lenguaje de consultas de Merchant Center al método accounts.reports.search:

SELECT impressions, clicks, click_through_rate
FROM product_performance_view
WHERE date BETWEEN '2020-12-01' AND '2020-12-30'

Para obtener más información sobre los informes de rendimiento, consulta la guía de Informes de rendimiento.

Filtrar productos

Puedes usar el objeto product_view de la API de Merchant Reports para mostrar una vista filtrada de tus datos de productos, incluidos los estados de los productos. Por ejemplo, puedes consultar product_view para enumerar los productos que tienen problemas o para obtener una lista de tus productos nuevos y verificar su publicación.

Debes incluir el campo id en la cláusula SELECT de tu consulta. El id tiene el mismo valor que el ID de REST del producto.

Puedes filtrar según todos los campos disponibles, excepto item_issues. Puedes ordenar la respuesta según todos los campos disponibles, excepto los siguientes:

gtin
item_issues

Este es un ejemplo que devuelve tus productos con el estado NOT_ELIGIBLE_OR_DISAPPROVED. Para realizar la solicitud, pasa la siguiente instrucción del Lenguaje de consultas de Merchant Center al método accounts.reports.search:

SELECT
  id,
  offer_id,
  feed_label,
  title,
  aggregated_reporting_context_status,
  item_issues
FROM product_view
WHERE aggregated_reporting_context_status = 'NOT_ELIGIBLE_OR_DISAPPROVED'

Esta es una respuesta de ejemplo de la búsqueda anterior:

{
  "results": [
    {
      "productView": {
        "id": "en~US~id0",
        "offerId": "id0",
        "feedLabel": "US",
        "aggregatedReportingContextStatus": "NOT_ELIGIBLE_OR_DISAPPROVED",
        "itemIssues": [
          {
            "type": {
              "code": "invalid_string_value",
              "canonicalAttribute": "n:product_code"
            },
            "severity": {
              "severityPerReportingContext": [
                {
                  "reportingContext": "SHOPPING_ADS",
                  "disapprovedCountries": [
                    "US"
                  ]
                },
                {
                  "reportingContext": "FREE_LISTINGS",
                  "disapprovedCountries": [
                    "US"
                  ]
                }
              ],
              "aggregatedSeverity": "DISAPPROVED"
            },
            "resolution": "MERCHANT_ACTION"
          },
          {
            "type": {
              "code": "apparel_missing_brand",
              "canonicalAttribute": "n:brand"
            },
            "severity": {
              "severityPerReportingContext": [
                {
                  "reportingContext": "SHOPPING_ADS",
                  "disapprovedCountries": [
                    "US"
                  ]
                }
              ],
              "aggregatedSeverity": "DEMOTED"
            },
            "resolution": "MERCHANT_ACTION"
          }
        ]
      }
    }
  ]
}

Para obtener más información sobre los campos disponibles para la consulta, consulta Campos en la tabla productView.

Mejora los precios

Puedes usar la vista de estadísticas de precios para ver los precios de oferta sugeridos para tus productos y las predicciones del rendimiento que puedes esperar si actualizas los precios de tus productos. Puedes usar este informe para definir los precios de tus productos de manera más eficaz.

Para obtener más información, consulta Mejora los precios de los productos con el informe de estadísticas de precios.

Consulta price_insights_product_view para ver los precios de oferta sugeridos para tus productos.

Aquí tienes una muestra que puedes usar para ver los precios de oferta sugeridos para tus productos. Para realizar la solicitud, pasa la siguiente instrucción del lenguaje de consultas de Merchant Center al método accounts.reports.search:

SELECT
  id,
  title,
  brand,
  price,
  suggested_price,
  predicted_impressions_change_fraction,
  predicted_clicks_change_fraction,
  predicted_conversion_change_fraction
FROM price_insights_product_view