Estructura de una consulta

Las consultas de los campos de métricas y segmentos se pueden enviar a reports.search . Para crear una consulta en el lenguaje de consultas de Merchant Center, primero debes redactar consulta mediante la gramática del lenguaje. Una consulta consta de varias cláusulas:

  • SELECT
  • FROM
  • WHERE
  • ORDER BY
  • LIMIT

Las cláusulas usan nombres de campo, nombres de tablas, operadores, condiciones y orderings para ayudarte a seleccionar los datos deseados. Una vez combinados en una sola por consulta, se puede realizar una solicitud con Google Content API for Shopping. Veamos cómo cada usar una cláusula <ph type="x-smartling-placeholder"> /></ph>.

modelo de la UE

SELECT

La cláusula SELECT especifica un conjunto de campos para recuperar en la solicitud. SELECT toma una lista separada por comas de los campos y las métricas de los segmentos, y muestra los valores en la respuesta. La cláusula SELECT es obligatoria en una consulta.

Aquí hay una consulta de muestra que selecciona las métricas de clics de una tabla determinada:

SELECT
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN 2020-08-01 AND 2020-08-31

También puedes consultar diferentes tipos de campos en una sola solicitud:

SELECT
  segments.date,
  segments.program,
  metrics.impressions,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN 2020-08-01 AND 2020-08-31
  • Campos del segmento

    • segments.date
    • segments.program
  • Métricas

    • metrics.impressions
    • metrics.clicks

Algunos campos no se permiten en la cláusula SELECT debido a los siguientes motivos: restricción:

  • Consulta campos de segmentos sin al menos un campo de métrica.

Puedes encontrar información relacionada con la condición anterior en nuestros documentos de referencia.

FROM

La cláusula FROM especifica la tabla de la que se recuperarán datos en la solicitud. El en la cláusula FROM define qué campos pueden usar todos los demás para la consulta dada. Solo se puede especificar una tabla en el FROM. Actualmente, solo se admite la tabla MerchantPerformanceView. La cláusula FROM es obligatoria en una consulta al método search en la Servicio de reports.

WHERE

La cláusula WHERE especifica las condiciones que se deben aplicar cuando se filtran los datos para la para cada solicitud. Cuando se usa la cláusula WHERE, se pueden especificar una o más condiciones con AND para separarlos. Cada condición debe seguir el patrón field_name Operator value El campo de cualquier segmento se puede usar en WHERE pero los campos de métricas deben especificarse en la cláusula SELECT para que se usa en la cláusula WHERE. La cláusula WHERE es obligatoria en una consulta. porque siempre debes especificar el período en el que quieres que los datos de rendimiento que se devuelven.

El siguiente es un ejemplo del uso de WHERE para mostrar métricas de un momento determinado período:

SELECT
  segments.offer_id,
  metrics.impressions
FROM MerchantPerformanceView
WHERE segments.date BETWEEN 2020-08-01 AND 2020-08-31

Puedes combinar varias condiciones para filtrar los datos. En este ejemplo, se devolverá la cantidad de clics por oferta para el programa SHOPPING_ADS donde los clics > 100 en el período determinado de 30 días.

SELECT
  segments.offer_id,
  segments.program,
  metrics.clicks
FROM MerchantPerformanceView
WHERE metrics.clicks > 100
  AND segments.program = SHOPPING_ADS
  AND segments.date BETWEEN 2020-08-01 AND 2020-08-31;

En la siguiente consulta, notarás que se seleccionó segments.date. Independientemente de si seleccionas segments.date, un período limitado en la Siempre se debe proporcionar la cláusula WHERE para recuperar los datos de rendimiento.

SELECT
  segments.date,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN 2020-08-01 AND 2020-08-31

Cuando filtres, es importante mantener la distinción entre mayúsculas y minúsculas de tu operador en la mente.

Para obtener una lista completa de operadores, consulta el gramática del idioma.

ORDER BY

La cláusula ORDER BY especifica el orden en el que se deben ejecutar los resultados. que se devuelven. Esto te permite organizar los datos en orden ascendente o descendente. según el nombre de un campo. Cada orden se especifica como un field_name seguido de ASC o DESC. Si no se especifica ASC ni DESC, el valor predeterminado del orden a ASC. Solo los campos especificados en la cláusula SELECT se pueden usar en el ORDER BY. La cláusula ORDER BY es opcional en una consulta.

La siguiente consulta ordena las filas devueltas por número de clics, de mayor a más bajo:

SELECT
  segments.offer_id,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN 2020-08-01 AND 2020-08-31
ORDER BY metrics.clicks DESC

Puedes especificar varios campos en la cláusula ORDER BY con una coma separada lista. El orden se producirá en la misma secuencia que se especifica en la consulta. Por ejemplo, en esta consulta, los resultados se ordenarán en orden ascendente por offer_id, luego, en orden descendente por cantidad de impresiones, y luego orden descendente por cantidad de clics:

SELECT
  segments.offer_id,
  metrics.impressions,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN 2020-08-01 AND 2020-08-31
ORDER BY
  segments.offer_id,
  metrics.impressions DESC,
  metrics.clicks DESC

LIMIT

La cláusula LIMIT te permite especificar la cantidad de resultados que se mostrarán. Esto es útil si solo te interesa el resumen.

Por ejemplo, se puede usar LIMIT para restringir el número total de resultados para el siguiente consulta:

SELECT
  segments.program,
  segments.offer_id,
  metrics.impressions
FROM MerchantPerformanceView
WHERE segments.date BETWEEN 2020-08-01 AND 2020-08-31
ORDER BY metrics.impressions DESC
LIMIT 50