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 búsqueda. La respuesta puede contener menos filas que las especificadas por `page_size`. Usa `next_page_token` para determinar si hay más filas que se deben solicitar. Permisos de autorización Requiere el siguiente alcance de OAuth: `https://www.googleapis.com/auth/content` Para obtener más información, consulta OAuth 2.0 Overview.

rpc Search(SearchRequest) returns (SearchResponse)

Recupera un informe definido por una búsqueda. La respuesta puede contener menos filas que las especificadas por page_size. Usa next_page_token para determinar si hay más filas que se deben solicitar.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

Para obtener más información, consulta OAuth 2.0 Overview.

BestSellersBrandView

Campos disponibles para la consulta en la tabla best_sellers_brand_view.

Informe Más vendidos con las marcas principales.

Los valores solo se establecen para los campos solicitados explícitamente 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, El 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 informe semanal o mensual más reciente 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` Es el país en el que se calcula la clasificación. Se representa en 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` Es el ID de la categoría de producto de Google para el que se calcula la clasificación, representado en la taxonomía de productos de Google. 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 los anuncios y las plataformas orgánicas, en la categoría y el país seleccionados, según la cantidad estimada de unidades vendidas
`previous_rank`	`int64` Clasificación por popularidad en la semana o el mes anteriores
`relative_demand`	`RelativeDemandEnum` Es la demanda estimada en relación con la marca que tiene la clasificación de popularidad más alta en la misma categoría y el mismo país.
`previous_relative_demand`	`RelativeDemandEnum` Es la demanda estimada en relación con la marca que tiene la clasificación de popularidad más alta en la misma categoría y el mismo país en la semana o el mes anterior.
`relative_demand_change`	`RelativeDemandChangeTypeEnum` Cambio en la demanda estimada. Si aumentó, disminuyó o se mantuvo estable.

BestSellersProductClusterView

Campos disponibles para la consulta en la tabla best_sellers_product_cluster_view.

Informe Más vendidos con los clústeres de productos principales Un clúster de productos es una agrupación de diferentes ofertas y variantes que representan el mismo producto, por ejemplo, Google Pixel 7.

Los valores solo se establecen para los campos solicitados explícitamente 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, El 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 informe semanal o mensual más reciente disponible.
`variant_gtins[]`	`string` Los GTIN de las 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` Es el país en el que se calcula la clasificación. Se representa en formato ISO 3166. Obligatorio en la cláusula `SELECT`. La condición en `report_country_code` es obligatoria en la cláusula `WHERE`.
`report_category_id`	`int64` Es el ID de la categoría de producto de Google para el que se calcula la clasificación, representado en la taxonomía de productos de Google. 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` Es la categoría de producto (1ᵉʳ nivel) del clúster de productos, representada en la taxonomía de productos de Google.
`category_l2`	`string` Es la categoría de producto (2º nivel) del clúster de productos, representada en la taxonomía de productos de Google.
`category_l3`	`string` Es la categoría de producto (3ᵉʳ nivel) del clúster de productos, representada en la taxonomía de productos de Google.
`category_l4`	`string` Es la categoría de producto (4º nivel) del clúster de productos, representada en la taxonomía de productos de Google.
`category_l5`	`string` Es la categoría de producto (5º nivel) del clúster de productos, representada en la taxonomía de productos de Google.
`inventory_status`	`InventoryStatus` 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 hay al menos un producto de la marca que actualmente tiene el estado `IN_STOCK` en tu fuente de datos de productos en al menos uno de los países, si todos los productos tienen el estado `OUT_OF_STOCK` en tu fuente de datos de productos en todos los países o si el estado es `NOT_IN_INVENTORY`. El campo no considera el filtro del país del informe de los más vendidos.
`rank`	`int64` Popularidad del clúster de productos en los anuncios y las plataformas orgánicas, en la categoría y el país seleccionados, según la cantidad estimada de unidades vendidas
`previous_rank`	`int64` Clasificación por popularidad en la semana o el mes anteriores
`relative_demand`	`RelativeDemandEnum` Es la demanda estimada en relación con el clúster de productos con la clasificación de popularidad más alta en la misma categoría y el mismo país.
`previous_relative_demand`	`RelativeDemandEnum` Es la demanda estimada en relación con el clúster de productos con la clasificación de popularidad más alta en la misma categoría y el mismo país en la semana o el mes anterior.
`relative_demand_change`	`RelativeDemandChangeTypeEnum` Cambio en la demanda estimada. Si aumentó, disminuyó o se mantuvo estable.

InventoryStatus

Estado del clúster de productos o la marca en tu inventario.

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

CompetitiveVisibilityBenchmarkView

Campos disponibles para la consulta en la tabla competitive_visibility_benchmark_view.

Informe Visibilidad de competencia con las comparativas de la categoría

Los valores solo se establecen para los campos solicitados explícitamente 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 en el que 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` Es el ID de la categoría de producto de Google para el que se calcula 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` Es la 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 período seleccionado (o el 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 en relación con el inicio del período seleccionado (o el primer día con impresiones distintas de cero) para un conjunto combinado de comercios con la mayor visibilidad que se aproxima al mercado. No se puede filtrar en la cláusula "WHERE".

CompetitiveVisibilityCompetitorView

Campos disponibles para la consulta en la tabla competitive_visibility_competitor_view.

Informe Visibilidad de competencia con empresas que tienen una visibilidad similar.

Los valores solo se establecen para los campos solicitados explícitamente 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` Es el dominio de tu competidor o el tuyo, si "is_your_domain" es verdadero. Es obligatorio en la cláusula `SELECT`. No se puede filtrar en la cláusula "WHERE".
`is_your_domain`	`bool` Es verdadero si esta fila contiene datos de tu dominio. No se puede filtrar en la cláusula "WHERE".
`report_country_code`	`string` País en el que 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` Es el ID de la categoría de producto de Google para el que se calcula 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` Es la fuente de tráfico de las impresiones. 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 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 muestra 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. No se puede filtrar en la cláusula "WHERE".
`page_overlap_rate`	`double` El porcentaje de superposición en la página muestra la frecuencia con la que se muestran las ofertas de los minoristas que compiten 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 superiores indica la frecuencia con la que una oferta de la competencia se publicó en una posición superior a la de tu 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 la competencia 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 tus impresiones mostradas durante un intervalo de tiempo determinado en un país y una categoría de producto determinados. No se puede filtrar en la cláusula "WHERE".

CompetitiveVisibilityTopMerchantView

Campos disponibles para la consulta en la tabla competitive_visibility_top_merchant_view.

Informe Visibilidad de competencia con la empresa con la visibilidad más alta.

Los valores solo se establecen para los campos solicitados explícitamente 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` Es el dominio de tu competidor o el tuyo, si "is_your_domain" es verdadero. Es obligatorio en la cláusula `SELECT`. No se puede filtrar en la cláusula "WHERE".
`is_your_domain`	`bool` Es verdadero si esta fila contiene datos de tu dominio. No se puede filtrar en la cláusula "WHERE".
`report_country_code`	`string` País en el que 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` Es el ID de la categoría de producto de Google para el que se calcula el informe, representado en la taxonomía de productos de Google. Obligatorio en la cláusula `SELECT`. Se requiere una condición en `report_category_id` en la cláusula `WHERE`.
`traffic_source`	`TrafficSourceEnum` Es la 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 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 muestra 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. No se puede filtrar en la cláusula "WHERE".
`page_overlap_rate`	`double` El porcentaje de superposición en la página muestra la frecuencia con la que se muestran las ofertas de los minoristas que compiten 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 superiores indica la frecuencia con la que una oferta de la competencia se publicó en una posición superior a la de tu 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 los anuncios).

MarketingMethodEnum

Valores del método de marketing

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

NonProductPerformanceView

Campos disponibles para la consulta en la tabla non_product_performance_view.

Datos de rendimiento sobre las imágenes y los vínculos de la tienda 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 cuales se segmentan las métricas de rendimiento (por ejemplo, date).

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

Los valores solo se establecen para los campos solicitados explícitamente 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` Es la cantidad de clics en las imágenes y los vínculos de la tienda en línea que dirigen a los usuarios a tus páginas que no son de productos. Métrica.
`impressions`	`int64` Es la cantidad de veces que se mostraron las imágenes y los vínculos a tiendas en línea que dirigen a los usuarios a tus páginas que no son de productos. Métrica.
`click_through_rate`	`double` Tasa de clics: Es la cantidad de clics (`clicks`) dividida por la cantidad de impresiones (`impressions`) de imágenes y vínculos a tiendas en línea que dirigen a los usuarios a tus páginas que no son de productos. Métrica.

PriceCompetitivenessProductView

Campos disponibles para la consulta en la tabla price_competitiveness_product_view.

Informe de competitividad de los precios.

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

Campos
`price`	`Price` Es el precio actual del producto.
`benchmark_price`	`Price` El último precio de referencia disponible para el catálogo del producto en el país de referencia
`report_country_code`	`string` Es el país de las comparativas de precios. Se representa en formato ISO 3166. Es obligatorio en la cláusula `SELECT`.
`id`	`string` Es el ID de REST del producto, en 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 que proporcionó el comercio.
`title`	`string` Título del producto.
`brand`	`string` Es la marca del producto.
`category_l1`	`string` Categoría de producto (1ᵉʳ nivel) en la taxonomía de productos de Google
`category_l2`	`string` Categoría de producto (2º nivel) en la taxonomía de productos de Google.
`category_l3`	`string` Categoría de producto (3ᵉʳ nivel) en la taxonomía de productos de Google.
`category_l4`	`string` Categoría de producto (4º nivel) en la taxonomía de productos de Google.
`category_l5`	`string` Categoría de producto (5º 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` 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 la consulta en la tabla price_insights_product_view.

Informe Información sobre precios.

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

Campos
`price`	`Price` Es el precio actual del producto.
`suggested_price`	`Price` Es el precio sugerido más reciente para el producto.
`effectiveness`	`Effectiveness` Es la eficacia prevista de aplicar la sugerencia de precio, agrupada.
`id`	`string` Es el ID de REST del producto, en 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 que proporcionó el comercio.
`title`	`string` Título del producto.
`brand`	`string` Es la marca del producto.
`category_l1`	`string` Categoría de producto (1ᵉʳ nivel) en la taxonomía de productos de Google.
`category_l2`	`string` Categoría de producto (2º nivel) en la taxonomía de productos de Google.
`category_l3`	`string` Categoría de producto (3ᵉʳ nivel) en la taxonomía de productos de Google.
`category_l4`	`string` Categoría de producto (4º nivel) en la taxonomía de productos de Google.
`category_l5`	`string` Categoría de producto (5º 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` 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 fracción después de introducir el precio sugerido en comparación con el precio activo actual. Por ejemplo, 0.05 es un aumento previsto del 5% en las impresiones.
`predicted_clicks_change_fraction`	`double` Es el cambio previsto en los clics como fracción después de introducir el precio sugerido en comparación con el precio activo actual. Por ejemplo, 0.05 es 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 introducir el precio sugerido en comparación con el precio activo actual. Por ejemplo, 0.05 es un aumento previsto del 5% en las conversiones).

Efectividad

Intervalo de eficacia previsto

La eficacia indica qué productos se beneficiarían más de los cambios de precio. En esta calificación, se tiene en cuenta el aumento del rendimiento que se predice ajustando el precio de oferta y la diferencia entre tus precios actuales y los sugeridos. Se prevé que las sugerencias de precios con una eficacia de HIGH generarán el mayor aumento en el rendimiento.

Enumeraciones
`EFFECTIVENESS_UNSPECIFIED`	Se desconoce la eficacia.
`LOW`	La eficacia es baja.
`MEDIUM`	La eficacia es media.
`HIGH`	La eficacia es alta.

ProductPerformanceView

Campos disponibles para la consulta en la tabla product_performance_view.

Datos de rendimiento de los productos de tu cuenta, incluidas las métricas de rendimiento (por ejemplo, clicks) y las dimensiones según las cuales se segmentan las métricas de rendimiento (por ejemplo, offer_id). Los valores de las dimensiones de productos, como offer_id, reflejan el estado de un 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 métrica.

Los valores solo se establecen para los campos solicitados explícitamente 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, que se informa en la fecha de conversión. Métrica. Disponible solo para la fuente de tráfico de `FREE`.
`marketing_method`	`MarketingMethodEnum` Es el método de marketing al que se aplican las métricas. Segmentación
`customer_country_code`	`string` Es el código del país en el que se encuentra el cliente en el momento del evento. Se representa en formato ISO 3166. Segmentación Si no se puede determinar el país del cliente, se muestra un código especial "ZZ".
`offer_id`	`string` Es el ID del producto que proporcionó 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 (1ᵉʳ nivel) en la taxonomía de productos de Google. Segmentación
`category_l2`	`string` Categoría de producto (2º nivel) en la taxonomía de productos de Google. Segmentación
`category_l3`	`string` Categoría de producto (3ᵉʳ nivel) en la taxonomía de productos de Google. Segmentación
`category_l4`	`string` Categoría de producto (4º nivel) en la taxonomía de productos de Google. Segmentación
`category_l5`	`string` Categoría de producto (5º nivel) en la taxonomía de productos de Google. Segmentación
`product_type_l1`	`string` Tipo de producto (1ᵉʳ nivel) en la taxonomía de productos del comercio Segmentación
`product_type_l2`	`string` Tipo de producto (2ᵒ 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 (4° nivel) en la taxonomía de productos del comercio Segmentación
`product_type_l5`	`string` Tipo de producto (5ᵉʳ 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 la conversión. Según el modelo de atribución, una conversión puede distribuirse en varios clics, en los que cada clic 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 de `FREE`.
`conversion_rate`	`double` Es la cantidad de conversiones dividida por la cantidad de clics, que se informa en la fecha de la impresión. Métrica. Disponible solo para la fuente de tráfico de `FREE`.

ProductView

Campos disponibles para la consulta en la tabla product_view.

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

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

Campos
`price`	`Price` Precio del producto. No se incluye si la información sobre el precio del producto no está disponible.
`gtin[]`	`string` Es la lista de los códigos comerciales globales de artículo (GTIN) del producto.
`creation_time`	`Timestamp` Es la hora en que el comercio creó el producto, expresada en segundos de marca de tiempo.
`expiration_date`	`Date` Es la fecha de vencimiento del producto, especificada en la inserción.
`item_issues[]`	`ItemIssue` Es la lista de problemas de los 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` Es el potencial de rendimiento estimado en comparación con los productos de mejor rendimiento del comercio.
`id`	`string` Es el ID de REST del producto, en 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 del feed del producto.
`offer_id`	`string` Es el ID del producto que proporcionó el comercio.
`title`	`string` Título del producto.
`brand`	`string` Es la marca del producto.
`category_l1`	`string` Categoría de producto (1ᵉʳ nivel) en la taxonomía de productos de Google.
`category_l2`	`string` Categoría de producto (2º nivel) en la taxonomía de productos de Google.
`category_l3`	`string` Categoría de producto (3ᵉʳ nivel) en la taxonomía de productos de Google.
`category_l4`	`string` Categoría de producto (4º nivel) en la taxonomía de productos de Google.
`category_l5`	`string` Categoría de producto (5º 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` 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` Disponibilidad del producto.
`shipping_label`	`string` Etiqueta de envío normalizada especificada en la fuente de datos.
`item_group_id`	`string` Es el ID de grupo de artículos que proporciona el comercio para agrupar las variantes.
`thumbnail_link`	`string` Es un 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` Es la clasificación del producto según su potencial de clics. Un producto con `click_potential_rank` 1 tiene el mayor potencial de clics entre los productos del comercio que cumplen con las condiciones de la búsqueda.

AggregatedReportingContextStatus

Es el 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

Enumeraciones
`AGGREGATED_REPORTING_CONTEXT_STATUS_UNSPECIFIED`	No se especifica.
`NOT_ELIGIBLE_OR_DISAPPROVED`	El producto no es apto o se rechazó para todos los contextos de informes.
`PENDING`	El estado del producto está pendiente en todos los contextos de informes.
`ELIGIBLE_LIMITED`	El producto es apto para algunos (pero no todos) los contextos de informes.
`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 del comercio que tienen el mejor rendimiento. El potencial de clics de un producto ayuda a los comercios a priorizar los productos que deben corregir y comprender su rendimiento en función de su potencial.

Enumeraciones
`CLICK_POTENTIAL_UNSPECIFIED`	Impacto desconocido de los clics previstos.
`LOW`	Posibilidad de recibir una cantidad baja de clics en comparación con los productos de mejor rendimiento del comercio.
`MEDIUM`	Posibilidad de 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

Es el problema del artículo asociado con el producto.

Campos

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

type

ItemIssueType

Tipo de problema del artículo.

severity

ItemIssueSeverity

Gravedad del problema del artículo

resolution

ItemIssueResolution

Resolución de problemas de artículos

ItemIssueResolution

Cómo resolver el problema

Enumeraciones
`ITEM_ISSUE_RESOLUTION_UNSPECIFIED`	No se especifica.
`MERCHANT_ACTION`	El comercio debe solucionar el problema.
`PENDING_PROCESSING`	El problema se resolverá automáticamente (por ejemplo, rastreo de imágenes) o mediante una revisión de Google. No es necesario que el comercio realice ninguna acción en este momento. La resolución podría generar otro problema (por ejemplo, si falla el rastreo).

ItemIssueSeverity

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

Campos

Campos
`severity_per_reporting_context[]`	`IssueSeverityPerReportingContext` Gravedad del problema por contexto de informes
`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 informes

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

Gravedad del problema agregada para todos los contextos de informes.

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

IssueSeverityPerReportingContext

Gravedad del problema por contexto de informes

Campos

Campos
`disapproved_countries[]`	`string` Es una lista de países rechazados en el contexto de informes, representada en formato ISO 3166.
`demoted_countries[]`	`string` Lista de países que descendieron en el contexto de informes, representadas en formato ISO 3166.
`reporting_context`	`ReportingContextEnum` Es el contexto de informes al que se aplica el problema.

disapproved_countries[]

string

Es una lista de países rechazados en el contexto de informes, representada en formato ISO 3166.

demoted_countries[]

string

Lista de países que descendieron en el contexto de informes, representadas en formato ISO 3166.

reporting_context

ReportingContextEnum

Es el contexto de informes al que se aplica el problema.

ItemIssueType

Tipo de problema.

Campos

Campos
`code`	`string` Es el código de error del problema, equivalente al `code` de Problemas del producto.
`canonical_attribute`	`string` Es el nombre del atributo canónico para problemas específicos de atributos.

code

string

Es el código de error del problema, equivalente al code de Problemas del producto.

canonical_attribute

string

Es el nombre del atributo canónico para problemas específicos de atributos.

RelativeDemand

Este tipo no tiene campos.

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

RelativeDemandEnum

Valores de demanda relativa

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

RelativeDemandChangeType

Este tipo no tiene campos.

Es la 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 relativo en la demanda.

Enumeraciones
`RELATIVE_DEMAND_CHANGE_TYPE_ENUM_UNSPECIFIED`	No se especifica.
`SINKER`	La demanda relativa es inferior al período anterior.
`FLAT`	La demanda relativa es igual al período anterior.
`RISER`	La demanda relativa es superior al 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

Informa los valores de nivel de detalle.

Enumeraciones
`REPORT_GRANULARITY_ENUM_UNSPECIFIED`	No se especifica.
`WEEKLY`	El informe se calcula durante un período de una semana.
`MONTHLY`	El informe se calcula en un período de un mes.

ReportRow

Es la fila de resultados que se muestra a partir de la búsqueda.

Solo se propaga en la respuesta el mensaje correspondiente a la tabla consultada. Dentro del mensaje propagado, solo se propagan los campos solicitados explícitamente en la consulta.

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

SearchRequest

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

Campos
`parent`	`string` Obligatorio. Es el ID de la cuenta que realiza la llamada. Debe ser una cuenta independiente o una cuenta secundaria de la MCA. Formato: accounts/{account}
`query`	`string` Obligatorio. Es una consulta que define un informe que se recuperará. Para obtener detalles sobre cómo crear tu consulta, consulta la guía del 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 recuperarán en una sola página. La configuración predeterminada es 1,000. Los valores superiores a 5,000 se convierten a 5,000.
`page_token`	`string` Opcional. Es el token de la página que se recuperará. Si no se especifica, se muestra la primera página de resultados. Para solicitar la siguiente página 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` Es un token que se puede enviar como `page_token` para recuperar la página siguiente. Si se omite, no habrá páginas siguientes.

results[]

ReportRow

Filas que coincidieron con la búsqueda.

next_page_token

string

Es un token que se puede enviar como page_token para recuperar la página siguiente. Si se omite, no habrá páginas siguientes.

TrafficSource

Este tipo no tiene campos.

Es la fuente de tráfico de las impresiones en el informe Visibilidad de competencia.

TrafficSourceEnum

Valores de la fuente de tráfico

Enumeraciones
`TRAFFIC_SOURCE_ENUM_UNSPECIFIED`	No se especifica.
`ORGANIC`	Tráfico orgánico.
`ADS`	Tráfico proveniente de anuncios
`ALL`	Tráfico orgánico y de anuncios.