Se usó la API de Cloud Translation para traducir esta página.

Package google.shopping.merchant.reports.v1beta

Índice

ReportService (interfaz)
BestSellersBrandView (mensaje)
BestSellersProductClusterView (mensaje)
BestSellersProductClusterView.InventoryStatus (enumeración)
CompetitiveVisibilityBenchmarkView (mensaje)
CompetitiveVisibilityCompetitorView (mensaje)
CompetitiveVisibilityTopMerchantView (mensaje)
MarketingMethod (mensaje)
MarketingMethod.MarketingMethodEnum (enumeración)
NonProductPerformanceView (mensaje)
PriceCompetitivenessProductView (mensaje)
PriceInsightsProductView (mensaje)
PriceInsightsProductView.Effectiveness (enumeración)
ProductPerformanceView (mensaje)
ProductView (mensaje)
ProductView.AggregatedReportingContextStatus (enumeración)
ProductView.ClickPotential (enumeración)
ProductView.ItemIssue (mensaje)
ProductView.ItemIssue.ItemIssueResolution (enumeración)
ProductView.ItemIssue.ItemIssueSeverity (mensaje)
ProductView.ItemIssue.ItemIssueSeverity.AggregatedIssueSeverity (enumeración)
ProductView.ItemIssue.ItemIssueSeverity.IssueSeverityPerReportingContext (mensaje)
ProductView.ItemIssue.ItemIssueType (mensaje)
RelativeDemand (mensaje)
RelativeDemand.RelativeDemandEnum (enumeración)
RelativeDemandChangeType (mensaje)
RelativeDemandChangeType.RelativeDemandChangeTypeEnum (enumeración)
ReportGranularity (mensaje)
ReportGranularity.ReportGranularityEnum (enumeración)
ReportRow (mensaje)
SearchRequest (mensaje)
SearchResponse (mensaje)
TrafficSource (mensaje)
TrafficSource.TrafficSourceEnum (enumeración)

ReportService

Servicio para recuperar informes y estadísticas sobre tus productos, su rendimiento y su entorno competitivo en Google.

Buscar

Buscar
`rpc Search(SearchRequest) returns (SearchResponse)` Recupera un informe definido por una consulta de búsqueda. La respuesta puede contener menos filas que las que especifica `page_size`. Confía en `next_page_token` para determinar si hay más filas para solicitar. Alcances de autorización Requiere el siguiente alcance de OAuth: `https://www.googleapis.com/auth/content` Para obtener más información, consulta la Descripción general de OAuth 2.0.

rpc Search(SearchRequest) returns (SearchResponse)

Recupera un informe definido por una consulta de búsqueda. La respuesta puede contener menos filas que las que especifica page_size. Confía en next_page_token para determinar si hay más filas para solicitar.

Alcances de autorización

Requiere el siguiente alcance de OAuth:

https://www.googleapis.com/auth/content

Para obtener más información, consulta la Descripción general de OAuth 2.0.

BestSellersBrandView

Campos disponibles para consultar en la tabla best_sellers_brand_view.

Informe de los más vendidos con las marcas principales.

Los valores solo se establecen para los campos solicitados de forma explícita en la búsqueda de la solicitud.

Campos
`report_date`	`Date` Fecha del informe. El valor de este campo solo puede ser uno de los siguientes: El primer día de la semana (lunes) para los informes semanales Primer día del mes para los informes mensuales. Es obligatorio en la cláusula `SELECT`. Si no se especifica una condición `WHERE` en `report_date` en la consulta, se muestra el último informe semanal o mensual disponible.
`report_granularity`	`ReportGranularityEnum` Nivel de detalle del informe La clasificación se puede realizar en un período de una semana o un mes. Es obligatorio en la cláusula `SELECT`. La condición en `report_granularity` es obligatoria en la cláusula `WHERE`.
`report_country_code`	`string` País donde se calcula la clasificación. Se representa en el formato ISO 3166. Es obligatorio en la cláusula `SELECT`. La condición en `report_country_code` es obligatoria en la cláusula `WHERE`.
`report_category_id`	`int64` ID de categoría de producto de Google para el que se calculará la clasificación, representado en la taxonomía de productos de Google. Es obligatorio en la cláusula `SELECT`. Si no se especifica una condición `WHERE` en `report_category_id` en la consulta, se muestran las clasificaciones de todas las categorías de nivel superior.
`brand`	`string` Es el nombre de la marca.
`rank`	`int64` La popularidad de la marca en Google Ads y plataformas orgánicas para la categoría y el país seleccionados en función de la cantidad estimada de unidades vendidas.
`previous_rank`	`int64` Clasificación por popularidad según la semana o el mes anteriores
`relative_demand`	`RelativeDemandEnum` Demanda estimada en relación con la marca con la clasificación por popularidad más alta en la misma categoría y el mismo país
`previous_relative_demand`	`RelativeDemandEnum` Demanda estimada en relación con la marca con la clasificación por popularidad más alta en la misma categoría y el mismo país la semana o el mes anteriores
`relative_demand_change`	`RelativeDemandChangeTypeEnum` Cambio en la demanda estimada. Si subió, se hundió o se mantuvo plana.

BestSellersProductClusterView

Campos disponibles para consultar en la tabla best_sellers_product_cluster_view.

El informe de los más vendidos con las agrupaciones de productos principales Un clúster de productos es un grupo de diferentes ofertas y variantes que representan el mismo producto, por ejemplo, Google Pixel 7.

Los valores solo se establecen para los campos solicitados de forma explícita en la búsqueda de la solicitud.

Campos
`report_date`	`Date` Fecha del informe. El valor de este campo solo puede ser uno de los siguientes: El primer día de la semana (lunes) para los informes semanales Primer día del mes para los informes mensuales. Es obligatorio en la cláusula `SELECT`. Si no se especifica una condición `WHERE` en `report_date` en la consulta, se muestra el último informe semanal o mensual disponible.
`variant_gtins[]`	`string` GTIN de variantes de ejemplo del clúster de productos.
`report_granularity`	`ReportGranularityEnum` Nivel de detalle del informe La clasificación se puede realizar en un período de una semana o un mes. Es obligatorio en la cláusula `SELECT`. La condición en `report_granularity` es obligatoria en la cláusula `WHERE`.
`report_country_code`	`string` País donde se calcula la clasificación. Se representa en el formato ISO 3166. Es obligatorio en la cláusula `SELECT`. La condición en `report_country_code` es obligatoria en la cláusula `WHERE`.
`report_category_id`	`int64` ID de categoría de producto de Google para el que se calculará la clasificación, representado en la taxonomía de productos de Google. Es obligatorio en la cláusula `SELECT`. Si no se especifica una condición `WHERE` en `report_category_id` en la consulta, se muestran las clasificaciones de todas las categorías de nivel superior.
`title`	`string` Es el título del clúster de productos.
`brand`	`string` Es la marca del clúster de productos.
`category_l1`	`string` La categoría de producto (primer nivel) del clúster de productos, representada en la taxonomía de productos de Google.
`category_l2`	`string` Categoría de producto (segundo nivel) del clúster de productos, representada en la taxonomía de productos de Google.
`category_l3`	`string` La categoría de producto (tercer nivel) del clúster de productos, representada en la taxonomía de productos de Google.
`category_l4`	`string` Categoría de producto (cuarto nivel) del clúster de productos, representada en la taxonomía de productos de Google.
`category_l5`	`string` Categoría de producto (quinto nivel) del clúster de productos, representada en la taxonomía de productos de Google.
`inventory_status`	`InventoryStatus` Indica si el clúster de productos es `IN_STOCK` en tu fuente de datos de productos en al menos uno de los países, `OUT_OF_STOCK` en tu fuente de datos de productos en todos los países o `NOT_IN_INVENTORY` en absoluto. El campo no considera el filtro del país del informe de los más vendidos
`brand_inventory_status`	`InventoryStatus` Si actualmente hay al menos un producto de la marca `IN_STOCK` en tu fuente de datos de productos en al menos uno de los países, todos los productos estarán `OUT_OF_STOCK` en la fuente de datos de productos en todos los países, o bien `NOT_IN_INVENTORY`. El campo no considera el filtro del país del informe de los más vendidos
`rank`	`int64` La popularidad del clúster de productos en plataformas orgánicas y anuncios para la categoría y el país seleccionados según la cantidad estimada de unidades vendidas
`previous_rank`	`int64` Clasificación por popularidad según la semana o el mes anteriores
`relative_demand`	`RelativeDemandEnum` Demanda estimada en relación con el grupo de productos con la clasificación por popularidad más alta en la misma categoría y el mismo país.
`previous_relative_demand`	`RelativeDemandEnum` Demanda estimada en relación con el grupo de productos con la clasificación por popularidad más alta en la misma categoría y el mismo país la semana o el mes anteriores.
`relative_demand_change`	`RelativeDemandChangeTypeEnum` Cambio en la demanda estimada. Si subió, se hundió o se mantuvo plana.

InventoryStatus

Es el estado del clúster de productos o la marca en tu inventario.

Enumeradores
`INVENTORY_STATUS_UNSPECIFIED`	No se especifica.
`IN_STOCK`	Tienes un producto para este clúster de productos o marca en stock.
`OUT_OF_STOCK`	Tienes un producto para este clúster de productos o marca en el inventario, pero actualmente agotado.
`NOT_IN_INVENTORY`	No tienes un producto para este clúster de productos o marca en el inventario.

CompetitiveVisibilityBenchmarkView

Campos disponibles para consultar en la tabla competitive_visibility_benchmark_view.

Informe de Visibilidad respecto a la competencia con las comparativas de categorías.

Los valores solo se establecen para los campos solicitados de forma explícita en la búsqueda de la solicitud.

Campos
`date`	`Date` Es la fecha de esta fila. Es obligatorio en la cláusula `SELECT`. Se requiere una condición en `date` en la cláusula `WHERE`.
`report_country_code`	`string` País donde aparecieron las impresiones. Es obligatorio en la cláusula `SELECT`. Se requiere una condición en `report_country_code` en la cláusula `WHERE`.
`report_category_id`	`int64` ID de categoría de producto de Google para el que se calculará el informe, representado en la taxonomía de productos de Google. Es obligatorio en la cláusula `SELECT`. Se requiere una condición en `report_category_id` en la cláusula `WHERE`.
`traffic_source`	`TrafficSourceEnum` Fuente de tráfico de las impresiones. Es obligatorio en la cláusula `SELECT`.
`your_domain_visibility_trend`	`double` Es el cambio en la visibilidad en función de las impresiones de tu dominio con respecto al inicio del intervalo de tiempo seleccionado (o del primer día con impresiones distintas de cero). No se puede filtrar en la cláusula “WHERE”.
`category_benchmark_visibility_trend`	`double` Es el cambio en la visibilidad según las impresiones con respecto al inicio del intervalo de tiempo seleccionado (o el primer día con impresiones distintas de cero) para un conjunto combinado de comercios con visibilidad más alta que se aproxima al mercado. No se puede filtrar en la cláusula “WHERE”.

CompetitiveVisibilityCompetitorView

Campos disponibles para consultar en la tabla competitive_visibility_competitor_view.

informe de Visibilidad respecto de la competencia con empresas que tienen una visibilidad similar.

Los valores solo se establecen para los campos solicitados de forma explícita en la búsqueda de la solicitud.

Campos
`date`	`Date` Es la fecha de esta fila. Se requiere una condición en `date` en la cláusula `WHERE`.
`domain`	`string` Dominio de la competencia o tu dominio, si “es_tu_dominio” es verdadero. Es obligatorio en la cláusula `SELECT`. No se puede filtrar en la cláusula “WHERE”.
`is_your_domain`	`bool` Verdadero si esta fila contiene datos de su dominio. No se puede filtrar en la cláusula “WHERE”.
`report_country_code`	`string` País donde aparecieron las impresiones. Es obligatorio en la cláusula `SELECT`. Se requiere una condición en `report_country_code` en la cláusula `WHERE`.
`report_category_id`	`int64` ID de categoría de producto de Google para el que se calculará el informe, representado en la taxonomía de productos de Google. Es obligatorio en la cláusula `SELECT`. Se requiere una condición en `report_category_id` en la cláusula `WHERE`.
`traffic_source`	`TrafficSourceEnum` Fuente de tráfico de las impresiones. Es obligatorio en la cláusula `SELECT`.
`rank`	`int64` Es la posición del dominio en la clasificación de empresas similares para las claves seleccionadas (`date`, `report_category_id`, `report_country_code`, `traffic_source`) según las impresiones. 1 es el valor más alto. No se puede filtrar en la cláusula “WHERE”.
`ads_organic_ratio`	`double` La Proporción de anuncios y de búsqueda orgánica indica la frecuencia con la que el dominio recibe impresiones de los anuncios de Shopping en comparación con el tráfico orgánico. El número se redondea y se agrupa en buckets. No se puede filtrar en la cláusula “WHERE”.
`page_overlap_rate`	`double` El Porcentaje de superposición de la página muestra la frecuencia con la que las ofertas de los minoristas que compiten se muestran junto con las tuyas en la misma página. No se puede filtrar en la cláusula “WHERE”.
`higher_position_rate`	`double` El porcentaje de posiciones más alto indica la frecuencia con la que una oferta de la competencia se publicó en una posición superior a la de la página. No se puede filtrar en la cláusula “WHERE”.
`relative_visibility`	`double` La visibilidad relativa indica la frecuencia con la que se muestran las ofertas de tus competidores en comparación con las tuyas. En otras palabras, es la cantidad de impresiones mostradas de un minorista de la competencia dividida por la cantidad de impresiones mostradas durante un intervalo de tiempo en un país y una categoría de producto determinados. No se puede filtrar en la cláusula “WHERE”.

CompetitiveVisibilityTopMerchantView

Campos disponibles para consultar en la tabla competitive_visibility_top_merchant_view.

Informe Visibilidad respecto de la competencia con la empresa con la mayor visibilidad.

Los valores solo se establecen para los campos solicitados de forma explícita en la búsqueda de la solicitud.

Campos
`date`	`Date` Es la fecha de esta fila. No se puede seleccionar en la cláusula `SELECT`. Se requiere una condición en `date` en la cláusula `WHERE`.
`domain`	`string` Dominio de la competencia o tu dominio, si “es_tu_dominio” es verdadero. Es obligatorio en la cláusula `SELECT`. No se puede filtrar en la cláusula “WHERE”.
`is_your_domain`	`bool` Verdadero si esta fila contiene datos de su dominio. No se puede filtrar en la cláusula “WHERE”.
`report_country_code`	`string` País donde aparecieron las impresiones. Es obligatorio en la cláusula `SELECT`. Se requiere una condición en `report_country_code` en la cláusula `WHERE`.
`report_category_id`	`int64` ID de categoría de producto de Google para el que se calculará el informe, representado en la taxonomía de productos de Google. Es obligatorio en la cláusula `SELECT`. Se requiere una condición en `report_category_id` en la cláusula `WHERE`.
`traffic_source`	`TrafficSourceEnum` Fuente de tráfico de las impresiones. Es obligatorio en la cláusula `SELECT`.
`rank`	`int64` Es la posición del dominio en la clasificación de los comercios principales para las claves seleccionadas (`date`, `report_category_id`, `report_country_code`, `traffic_source`) según las impresiones. 1 es el valor más alto. No se puede filtrar en la cláusula “WHERE”.
`ads_organic_ratio`	`double` La Proporción de anuncios y de búsqueda orgánica indica la frecuencia con la que el dominio recibe impresiones de los anuncios de Shopping en comparación con el tráfico orgánico. El número se redondea y se agrupa en buckets. No se puede filtrar en la cláusula “WHERE”.
`page_overlap_rate`	`double` El Porcentaje de superposición de la página muestra la frecuencia con la que las ofertas de los minoristas que compiten se muestran junto con las tuyas en la misma página. No se puede filtrar en la cláusula “WHERE”.
`higher_position_rate`	`double` El porcentaje de posiciones más alto indica la frecuencia con la que una oferta de la competencia se publicó en una posición superior a la de la página. No se puede filtrar en la cláusula “WHERE”.

MarketingMethod

Este tipo no tiene campos.

Es el método de marketing que se usa para promocionar tus productos en Google (orgánico en comparación con anuncios).

MarketingMethodEnum

Valores de los métodos de marketing.

Enumeradores
`MARKETING_METHOD_ENUM_UNSPECIFIED`	No se especifica.
`ORGANIC`	Marketing orgánico.
`ADS`	Marketing basado en anuncios.

NonProductPerformanceView

Campos disponibles para consultar en la tabla non_product_performance_view.

Datos de rendimiento en las imágenes y los vínculos de tiendas en línea que dirigen a los usuarios a tus páginas que no son de productos Esto incluye las métricas de rendimiento (por ejemplo, clicks) y las dimensiones según las métricas de rendimiento que están segmentadas (por ejemplo, date).

No se pueden seleccionar campos de segmento en las consultas sin seleccionar, al menos, un campo de la métrica.

Los valores solo se establecen para los campos solicitados de forma explícita en la búsqueda de la solicitud.

Campos
`date`	`Date` Es la fecha en la zona horaria del comercio a la que se aplican las métricas. Segmentación La condición en `date` es obligatoria en la cláusula `WHERE`.
`week`	`Date` Primer día de la semana (lunes) de la fecha de las métricas en la zona horaria del comercio. Segmentación
`clicks`	`int64` Cantidad de clics en imágenes y vínculos de tiendas en línea que dirigen a los usuarios a tus páginas que no son de productos. Métrica.
`impressions`	`int64` Cantidad de veces que se mostraron las imágenes y los vínculos de tiendas en línea que dirigen a tus páginas que no son de productos. Métrica.
`click_through_rate`	`double` Tasa de clics: Cantidad de clics (`clicks`) dividida por la cantidad de impresiones (`impressions`) de las imágenes y los vínculos de tiendas en línea que dirigen a los usuarios a tus páginas que no son de productos. Métrica.

PriceCompetitivenessProductView

Campos disponibles para consultar en la tabla price_competitiveness_product_view.

Informe de competitividad de los precios

Los valores solo se establecen para los campos solicitados de forma explícita en la búsqueda de la solicitud.

Campos
`price`	`Price` Es el precio actual del producto.
`benchmark_price`	`Price` Es la comparativa de precios más reciente disponible para el catálogo del producto en el país comparativo.
`report_country_code`	`string` Es el país de la comparativa de precios. Se representa en el formato ISO 3166. Es obligatorio en la cláusula `SELECT`.
`id`	`string` Es el ID de REST del producto, con el formato `channel~languageCode~feedLabel~offerId`. Se puede usar para unir datos con la tabla `product_view`. Es obligatorio en la cláusula `SELECT`.
`offer_id`	`string` Es el ID del producto proporcionado por el comercio.
`title`	`string` Título del producto.
`brand`	`string` Es la marca del producto.
`category_l1`	`string` Categoría de producto (primer nivel) en la taxonomía de productos de Google.
`category_l2`	`string` Categoría de producto (segundo nivel) en la taxonomía de productos de Google.
`category_l3`	`string` Categoría de producto (tercer nivel) en la taxonomía de productos de Google.
`category_l4`	`string` Categoría de producto (cuarto nivel) en la taxonomía de productos de Google.
`category_l5`	`string` Categoría de producto (quinto nivel) en la taxonomía de productos de Google.
`product_type_l1`	`string` Es el tipo de producto (primer nivel) en la taxonomía de productos del comercio.
`product_type_l2`	`string` Es el tipo de producto (segundo nivel) en la taxonomía de productos del comercio.
`product_type_l3`	`string` Es el tipo de producto (tercer nivel) en la taxonomía de productos del comercio.
`product_type_l4`	`string` Es el tipo de producto (cuarto nivel) en la taxonomía de productos del comercio.
`product_type_l5`	`string` Es el tipo de producto (quinto nivel) en la taxonomía de productos del comercio.

PriceInsightsProductView

Campos disponibles para consultar en la tabla price_insights_product_view.

Informe de estadísticas de precios

Los valores solo se establecen para los campos solicitados de forma explícita en la búsqueda de la solicitud.

Campos
`price`	`Price` Es el precio actual del producto.
`suggested_price`	`Price` Es el último precio sugerido del producto.
`effectiveness`	`Effectiveness` La eficacia prevista de aplicar la sugerencia de precios, agrupada en buckets.
`id`	`string` Es el ID de REST del producto, con el formato `channel~languageCode~feedLabel~offerId`. Se puede usar para unir datos con la tabla `product_view`. Es obligatorio en la cláusula `SELECT`.
`offer_id`	`string` Es el ID del producto proporcionado por el comercio.
`title`	`string` Título del producto.
`brand`	`string` Es la marca del producto.
`category_l1`	`string` Categoría de producto (primer nivel) en la taxonomía de productos de Google.
`category_l2`	`string` Categoría de producto (segundo nivel) en la taxonomía de productos de Google.
`category_l3`	`string` Categoría de producto (tercer nivel) en la taxonomía de productos de Google.
`category_l4`	`string` Categoría de producto (cuarto nivel) en la taxonomía de productos de Google.
`category_l5`	`string` Categoría de producto (quinto nivel) en la taxonomía de productos de Google.
`product_type_l1`	`string` Es el tipo de producto (primer nivel) en la taxonomía de productos del comercio.
`product_type_l2`	`string` Es el tipo de producto (segundo nivel) en la taxonomía de productos del comercio.
`product_type_l3`	`string` Es el tipo de producto (tercer nivel) en la taxonomía de productos del comercio.
`product_type_l4`	`string` Es el tipo de producto (cuarto nivel) en la taxonomía de productos del comercio.
`product_type_l5`	`string` Es el tipo de producto (quinto nivel) en la taxonomía de productos del comercio.
`predicted_impressions_change_fraction`	`double` Es el cambio previsto en las impresiones como una fracción después de ingresar el precio sugerido en comparación con el precio activo actual. Por ejemplo, 0.05 significa un aumento previsto en las impresiones del 5%.
`predicted_clicks_change_fraction`	`double` Es el cambio previsto en los clics como fracción después de ingresar el precio sugerido en comparación con el precio activo actual. Por ejemplo, 0.05 significa un aumento previsto del 5% en los clics.
`predicted_conversions_change_fraction`	`double` Es el cambio previsto en las conversiones como una fracción después de ingresar el precio sugerido en comparación con el precio activo actual. Por ejemplo, 0.05 significa un aumento previsto en las conversiones del 5%).

Efectividad

Intervalo de eficacia prevista.

La eficacia indica qué productos se beneficiarían más de los cambios de precio. Esta calificación considera el aumento del rendimiento que se predice mediante el ajuste del precio de oferta y la diferencia entre tu precio actual y el sugerido. Se prevé que las sugerencias de precios con una eficacia del HIGH generarán el mayor aumento en el rendimiento.

Enumeradores
`EFFECTIVENESS_UNSPECIFIED`	La eficacia es desconocida.
`LOW`	La eficacia es baja.
`MEDIUM`	La eficacia es media.
`HIGH`	La eficacia es alta.

ProductPerformanceView

Campos disponibles para consultar en la tabla product_performance_view.

Datos de rendimiento de productos de tu cuenta, incluidas las métricas de rendimiento (por ejemplo, clicks) y las dimensiones según las que se segmentan las métricas de rendimiento (por ejemplo, offer_id). Los valores de las dimensiones del producto, como offer_id, reflejan el estado del producto en el momento de la impresión.

No se pueden seleccionar campos de segmento en las consultas sin seleccionar, al menos, un campo de la métrica.

Los valores solo se establecen para los campos solicitados de forma explícita en la búsqueda de la solicitud.

Campos
`date`	`Date` Es la fecha en la zona horaria del comercio a la que se aplican las métricas. Segmentación La condición en `date` es obligatoria en la cláusula `WHERE`.
`week`	`Date` Primer día de la semana (lunes) de la fecha de las métricas en la zona horaria del comercio. Segmentación
`conversion_value`	`Price` Es el valor de las conversiones atribuidas al producto, registradas en la fecha de conversión. Métrica. Disponible solo para la fuente de tráfico `FREE`.
`marketing_method`	`MarketingMethodEnum` Método de marketing al que se aplican las métricas. Segmentación
`customer_country_code`	`string` Es el código del país donde se encuentra el cliente en el momento del evento. Se representa en el formato ISO 3166. Segmentación Si no se puede determinar el país del cliente, se devuelve un código "ZZ" especial.
`offer_id`	`string` Es el ID del producto proporcionado por el comercio. Segmentación
`title`	`string` Título del producto. Segmentación
`brand`	`string` Es la marca del producto. Segmentación
`category_l1`	`string` Categoría de producto (primer nivel) en la taxonomía de productos de Google. Segmentación
`category_l2`	`string` Categoría de producto (2o nivel) en la taxonomía de productos de Google. Segmentación
`category_l3`	`string` Categoría de producto (tercer nivel) en la taxonomía de productos de Google. Segmentación
`category_l4`	`string` Categoría de producto (cuarto nivel) en la taxonomía de productos de Google. Segmentación
`category_l5`	`string` Categoría de producto (5.o nivel) en la taxonomía de productos de Google. Segmentación
`product_type_l1`	`string` Tipo de producto (1er nivel) en la taxonomía de productos del comercio. Segmentación
`product_type_l2`	`string` Tipo de producto (2o nivel) en la taxonomía de productos del comercio. Segmentación
`product_type_l3`	`string` Tipo de producto (tercer nivel) en la taxonomía de productos del comercio. Segmentación
`product_type_l4`	`string` Tipo de producto (cuarto nivel) en la taxonomía de productos del comercio. Segmentación
`product_type_l5`	`string` Tipo de producto (5o nivel) en la taxonomía de productos del comercio. Segmentación
`custom_label0`	`string` Etiqueta personalizada 0 para la agrupación personalizada de productos. Segmentación
`custom_label1`	`string` Etiqueta personalizada 1 para la agrupación personalizada de productos. Segmentación
`custom_label2`	`string` Etiqueta personalizada 2 para la agrupación personalizada de productos. Segmentación
`custom_label3`	`string` Etiqueta personalizada 3 para la agrupación personalizada de productos. Segmentación
`custom_label4`	`string` Etiqueta personalizada 4 para la agrupación personalizada de productos. Segmentación
`clicks`	`int64` Cantidad de clics Métrica.
`impressions`	`int64` Es la cantidad de veces que se muestran los productos del comercio. Métrica.
`click_through_rate`	`double` Tasa de clics: Es la cantidad de clics que reciben los productos del comercio (clics) dividida por la cantidad de veces que se muestran los productos (impresiones). Métrica.
`conversions`	`double` Es la cantidad de conversiones atribuidas al producto, registradas en la fecha de conversión. Según el modelo de atribución, una conversión puede distribuirse entre varios clics, y cada uno recibe su propio crédito asignado. Esta métrica es la suma de todos esos créditos. Métrica. Disponible solo para la fuente de tráfico `FREE`.
`conversion_rate`	`double` Es la cantidad de conversiones dividida por la cantidad de clics registrados en la fecha de la impresión. Métrica. Disponible solo para la fuente de tráfico `FREE`.

ProductView

Campos disponibles para consultar en la tabla product_view.

Productos en el inventario actual. Los productos de esta tabla son los mismos que los de la subAPI Productos, pero no todos los atributos de la subAPI Productos están disponibles para consultarlos en esta tabla. A diferencia de la subAPI de Productos, esta tabla permite filtrar la lista de productos que se muestra por atributos. Para recuperar un solo producto antes del id o enumerar todos los productos, se debe usar la subAPI de Productos.

Los valores solo se establecen para los campos solicitados de forma explícita en la búsqueda de la solicitud.

Campos
`price`	`Price` Es el precio del producto. Aparece si la información sobre el precio del producto no está disponible.
`gtin[]`	`string` Es la lista de códigos comerciales globales de artículos (GTIN) del producto.
`creation_time`	`Timestamp` Es la hora en que el comercio creó el producto, expresada en segundos de la marca de tiempo.
`expiration_date`	`Date` Es la fecha de vencimiento del producto, que se especifica en la inserción.
`item_issues[]`	`ItemIssue` Es la lista de problemas de artículos del producto. No se puede usar este campo para ordenar los resultados. Solo se pueden usar los atributos seleccionados de este campo (por ejemplo, `item_issues.severity.aggregated_severity`) para filtrar los resultados.
`click_potential`	`ClickPotential` Potencial de rendimiento estimado en comparación con los productos de mejor rendimiento del comercio.
`id`	`string` Es el ID de REST del producto, con el formato `channel~languageCode~feedLabel~offerId`. Los métodos de la API de Merchant que operan en productos toman esto como su parámetro `name`. Es obligatorio en la cláusula `SELECT`.
`channel`	`ChannelEnum` Canal del producto. Puede ser `ONLINE` o `LOCAL`.
`language_code`	`string` Es el código de idioma del producto en formato BCP 47.
`feed_label`	`string` Es la etiqueta de feed del producto.
`offer_id`	`string` Es el ID del producto proporcionado por el comercio.
`title`	`string` Título del producto.
`brand`	`string` Es la marca del producto.
`category_l1`	`string` Categoría de producto (primer nivel) en la taxonomía de productos de Google.
`category_l2`	`string` Categoría de producto (segundo nivel) en la taxonomía de productos de Google.
`category_l3`	`string` Categoría de producto (tercer nivel) en la taxonomía de productos de Google.
`category_l4`	`string` Categoría de producto (cuarto nivel) en la taxonomía de productos de Google.
`category_l5`	`string` Categoría de producto (quinto nivel) en la taxonomía de productos de Google.
`product_type_l1`	`string` Es el tipo de producto (primer nivel) en la taxonomía de productos del comercio.
`product_type_l2`	`string` Es el tipo de producto (segundo nivel) en la taxonomía de productos del comercio.
`product_type_l3`	`string` Es el tipo de producto (tercer nivel) en la taxonomía de productos del comercio.
`product_type_l4`	`string` Es el tipo de producto (cuarto nivel) en la taxonomía de productos del comercio.
`product_type_l5`	`string` Es el tipo de producto (quinto nivel) en la taxonomía de productos del comercio.
`condition`	`string` Estado del producto.
`availability`	`string` La disponibilidad del producto.
`shipping_label`	`string` Se especificó una etiqueta de envío normalizada en la fuente de datos.
`item_group_id`	`string` Es el ID de grupo de artículos que proporcionó el comercio para agrupar variantes.
`thumbnail_link`	`string` Vínculo a la imagen procesada del producto, alojada en la infraestructura de Google.
`aggregated_reporting_context_status`	`AggregatedReportingContextStatus` Estado agregado.
`click_potential_rank`	`int64` Clasificación del producto en función de su potencial de clics Un producto con `click_potential_rank` 1 tiene el potencial de clics más alto entre los productos del comercio que cumplen con las condiciones de búsqueda.

AggregatedReportingContextStatus

Estado del producto agregado para todos los contextos de informes.

Este es un ejemplo de cómo se calcula el estado agregado:

Fichas gratuitas	Anuncios de Shopping	Estado
Aprobada	Aprobada	APTA
Aprobada	Pendiente	APTA
Aprobada	Rechazado	ELIGIBLE_LIMITED
Pendiente	Pendiente	PENDIENTE
Rechazado	Rechazado	NOT_ELIGIBLE_OR_DISAPPROVED

Enumeradores
`AGGREGATED_REPORTING_CONTEXT_STATUS_UNSPECIFIED`	No se especifica.
`NOT_ELIGIBLE_OR_DISAPPROVED`	El producto no es apto o se rechazó en todos los contextos de los informes.
`PENDING`	El estado del producto está pendiente en todos los contextos de los informes.
`ELIGIBLE_LIMITED`	El producto es apto para algunos contextos de informes (pero no para todos).
`ELIGIBLE`	El producto es apto para todos los contextos de informes.

ClickPotential

El potencial de clics de un producto es un cálculo de su potencial de rendimiento en comparación con los productos de mejor rendimiento del comercio. El potencial de clics de un producto ayuda a los comercios a priorizar cuáles corregir y a comprender su rendimiento en función de su potencial.

Enumeradores
`CLICK_POTENTIAL_UNSPECIFIED`	Impacto previsto de los clics desconocido
`LOW`	Potencial para recibir una cantidad baja de clics en comparación con los productos de mejor rendimiento del comercio.
`MEDIUM`	Potencial para recibir una cantidad moderada de clics en comparación con los productos de mejor rendimiento del comercio.
`HIGH`	Posibilidad de recibir una cantidad de clics similar a la de los productos con mejor rendimiento del comercio.

ItemIssue

Problema del artículo asociado con el producto.

Campos

Campos
`type`	`ItemIssueType` Tipo de problema del artículo.
`severity`	`ItemIssueSeverity` Gravedad del problema del elemento.
`resolution`	`ItemIssueResolution` Resolución del problema del artículo.

type

ItemIssueType

Tipo de problema del artículo.

severity

ItemIssueSeverity

Gravedad del problema del elemento.

resolution

ItemIssueResolution

Resolución del problema del artículo.

ItemIssueResolution

Cómo resolver el problema.

Enumeradores
`ITEM_ISSUE_RESOLUTION_UNSPECIFIED`	No se especifica.
`MERCHANT_ACTION`	El comercio tiene que solucionar el problema.
`PENDING_PROCESSING`	El problema se resolverá automáticamente (por ejemplo, con el rastreo de imágenes) o mediante una revisión de Google. No se requiere ninguna acción del comercio en este momento. La resolución puede generar otro problema (por ejemplo, si falla el rastreo).

ItemIssueSeverity

Cómo afecta el problema la publicación del producto

Campos

Campos
`severity_per_reporting_context[]`	`IssueSeverityPerReportingContext` Gravedad del problema por contexto de informe.
`aggregated_severity`	`AggregatedIssueSeverity` Gravedad agregada del problema en todos los contextos de informes que afecta. Este campo se puede usar para filtrar los resultados.

severity_per_reporting_context[]

IssueSeverityPerReportingContext

Gravedad del problema por contexto de informe.

aggregated_severity

AggregatedIssueSeverity

Gravedad agregada del problema en todos los contextos de informes que afecta.

Este campo se puede usar para filtrar los resultados.

AggregatedIssueSeverity

Se agregó la gravedad del problema para todos los contextos de informes.

Enumeradores
`AGGREGATED_ISSUE_SEVERITY_UNSPECIFIED`	No se especifica.
`DISAPPROVED`	El problema rechaza el producto en al menos un contexto de denuncia.
`DEMOTED`	El problema desciende de nivel el producto en todos los contextos de informes a los que afecta.
`PENDING`	La resolución del problema es `PENDING_PROCESSING`.

IssueSeverityPerReportingContext

Gravedad del problema por contexto de informe.

Campos

Campos
`disapproved_countries[]`	`string` Lista de países rechazados en el contexto de los informes, representada en formato ISO 3166.
`demoted_countries[]`	`string` Lista de países que descenderon de nivel en el contexto de los informes, representados en formato ISO 3166.
`reporting_context`	`ReportingContextEnum` El contexto de los informes al que se aplica el problema.

disapproved_countries[]

string

Lista de países rechazados en el contexto de los informes, representada en formato ISO 3166.

demoted_countries[]

string

Lista de países que descenderon de nivel en el contexto de los informes, representados en formato ISO 3166.

reporting_context

ReportingContextEnum

El contexto de los informes al que se aplica el problema.

ItemIssueType

Tipo de problema.

Campos

Campos
`code`	`string` Código de error del problema, equivalente a `code` de Problemas de productos.
`canonical_attribute`	`string` Nombre de atributo canónico para problemas específicos de atributos.

code

string

Código de error del problema, equivalente a code de Problemas de productos.

canonical_attribute

string

Nombre de atributo canónico para problemas específicos de atributos.

RelativeDemand

Este tipo no tiene campos.

Demanda relativa de un clúster de productos o una marca en el informe Más vendidos.

RelativeDemandEnum

Valores de demanda relativas.

Enumeradores
`RELATIVE_DEMAND_ENUM_UNSPECIFIED`	No se especifica.
`VERY_LOW`	La demanda corresponde al 0% al 5% de la demanda del clúster de productos o la marca con la clasificación más alta.
`LOW`	La demanda representa entre un 6% y un 10% de la demanda de la marca o el clúster de productos con la clasificación más alta.
`MEDIUM`	La demanda representa entre un 11% y un 20% de la demanda de la marca o el clúster de productos con la clasificación más alta.
`HIGH`	La demanda representa entre un 21% y un 50% de la demanda de la marca o el clúster de productos con la clasificación más alta.
`VERY_HIGH`	La demanda representa entre el 51% y el 100% de la demanda de la marca o el clúster de productos con la clasificación más alta.

RelativeDemandChangeType

Este tipo no tiene campos.

Demanda relativa de un clúster de productos o una marca en el informe de los más vendidos en comparación con el período anterior.

RelativeDemandChangeTypeEnum

Valores del tipo de cambio de la demanda relativa.

Enumeradores
`RELATIVE_DEMAND_CHANGE_TYPE_ENUM_UNSPECIFIED`	No se especifica.
`SINKER`	La demanda relativa es menor que el período anterior.
`FLAT`	La demanda relativa es igual al período anterior.
`RISER`	La demanda relativa es mayor que en el período anterior.

ReportGranularity

Este tipo no tiene campos.

Nivel de detalle del informe de los más vendidos Los informes de los más vendidos se calculan en un período de una semana y un mes.

ReportGranularityEnum

Valores del nivel de detalle del informe.

Enumeradores
`REPORT_GRANULARITY_ENUM_UNSPECIFIED`	No se especifica.
`WEEKLY`	El informe se calcula en un período de una semana.
`MONTHLY`	El informe se calcula a lo largo de un período de un mes.

ReportRow

Fila de resultados que se muestra en la consulta de búsqueda.

En la respuesta, solo se propaga el mensaje correspondiente a la tabla consultada. En el mensaje propagado, solo se propagan los campos solicitados de forma explícita en la consulta.

Campos
`product_performance_view`	`ProductPerformanceView` Campos disponibles para consultar en la tabla `product_performance_view`.
`non_product_performance_view`	`NonProductPerformanceView` Campos disponibles para consultar en la tabla `non_product_performance_view`.
`product_view`	`ProductView` Campos disponibles para consultar en la tabla `product_view`.
`price_competitiveness_product_view`	`PriceCompetitivenessProductView` Campos disponibles para consultar en la tabla `price_competitiveness_product_view`.
`price_insights_product_view`	`PriceInsightsProductView` Campos disponibles para consultar en la tabla `price_insights_product_view`.
`best_sellers_product_cluster_view`	`BestSellersProductClusterView` Campos disponibles para consultar en la tabla `best_sellers_product_cluster_view`.
`best_sellers_brand_view`	`BestSellersBrandView` Campos disponibles para consultar en la tabla `best_sellers_brand_view`.
`competitive_visibility_competitor_view`	`CompetitiveVisibilityCompetitorView` Campos disponibles para consultar en la tabla `competitive_visibility_competitor_view`.
`competitive_visibility_top_merchant_view`	`CompetitiveVisibilityTopMerchantView` Campos disponibles para consultar en la tabla `competitive_visibility_top_merchant_view`.
`competitive_visibility_benchmark_view`	`CompetitiveVisibilityBenchmarkView` Campos disponibles para consultar en la tabla `competitive_visibility_benchmark_view`.

SearchRequest

Mensaje de la solicitud para el método ReportService.Search.

Campos
`parent`	`string` Obligatorio. ID de la cuenta que realiza la llamada. Debe ser una cuenta independiente o secundaria de MCA. Formato: accounts/{account}
`query`	`string` Obligatorio. Consulta que define un informe que se recuperará. Si deseas obtener detalles sobre cómo crear tu consulta, revisa la guía Lenguaje de consulta. Para obtener la lista completa de las tablas y los campos disponibles, consulta los campos disponibles.
`page_size`	`int32` Opcional. Cantidad de `ReportRows` que se deben recuperar en una sola página. La configuración predeterminada es 1,000. Los valores superiores a 5,000 se fuerzan a 5,000.
`page_token`	`string` Opcional. El token de la página que se recuperará. Si no se especifica, se muestra la primera página de resultados. Para solicitar la página siguiente de resultados, se debe usar el valor obtenido de `next_page_token` en la respuesta anterior.

SearchResponse

Mensaje de respuesta para el método ReportService.Search.

Campos

Campos
`results[]`	`ReportRow` Filas que coincidieron con la búsqueda.
`next_page_token`	`string` Token que se puede enviar como `page_token` para recuperar la página siguiente. Si se omite, no hay páginas posteriores.

results[]

ReportRow

Filas que coincidieron con la búsqueda.

next_page_token

string

Token que se puede enviar como page_token para recuperar la página siguiente. Si se omite, no hay páginas posteriores.

TrafficSource

Este tipo no tiene campos.

Fuente del tráfico de las impresiones en el informe Visibilidad de competencia.

TrafficSourceEnum

Valores de la fuente de tráfico.

Enumeradores
`TRAFFIC_SOURCE_ENUM_UNSPECIFIED`	No se especifica.
`ORGANIC`	Tráfico orgánico.
`ADS`	Es el tráfico que proviene de los anuncios.
`ALL`	Tráfico orgánico y de anuncios