La API de Merchant v1beta se descontinuó y se dio de baja 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.

Medir 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 PERFORMANCE_REPORTING derecho de acceso 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 las impressions, los clicks y el click_through_rate de 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 accounts.reports.searchmétodo:

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 Informes de rendimiento.

Filtrar productos

Puedes usar product_view de la API de Merchant Reports para mostrar una vista filtrada de los datos de tus 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 la 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 los siguientes:

status_per_reporting_context
item_issues.

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

gtin
status_per_reporting_context
item_issues

Puedes consultar el campo aggregated_reporting_context_status para comprender la elegibilidad general de un producto. Este campo agrega los estados en todos los contextos de informes de un producto.

Este es un ejemplo que muestra tus productos con el estado agregado ELIGIBLE_LIMITED, lo que significa que son aptos para publicarse en al menos uno, pero no en todos, de sus contextos de informes segmentados. Puedes solicitar el estado detallado del producto por contexto de informes y los problemas del producto para investigar más. Para realizar la solicitud, pasa la siguiente instrucción del lenguaje de consultas de Merchant Center al accounts.reports.search método:

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

Esta es una respuesta de muestra de la consulta anterior:

{
  "results": [
    {
      "productView": {
        "id": "en~US~id0",
        "offerId": "id0",
        "feedLabel": "US",
        "aggregatedReportingContextStatus": "ELIGIBLE_LIMITED",
        "statusPerReportingContext": [
          {
            "reportingContext": "SHOPPING_ADS",
            "disapprovedCountries": [
              "US"
            ]
          },
          {
            "reportingContext": "FREE_LISTINGS",
            "approvedCountries": [
              "US"
            ]
          }
        ]
        "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"
          }
        ]
      }
    }
  ]
}

Puedes usar un filtro en reporting_context en la cláusula WHERE para ver los detalles del producto de un contexto de informes específico. Cuando filtras por reporting_context, aggregated_reporting_context_status se calcula solo en función del contexto de informes seleccionado, y status_per_reporting_context y item_issues solo muestran detalles de ese contexto.

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

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.

Este es un ejemplo 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 accounts.reports.search método:

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