rocket
Conoce la
API de Merchant
(el sucesor oficial de Content API for Shopping).
update
Obtén las últimas novedades
sobre las nuevas funciones, las correcciones de errores y las actualizaciones de la API de Merchant.
add_alert
Nota: Content API for Shopping dejará de estar disponible el 18 de agosto de 2026.
Intervalos de fechas
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
El lenguaje de consultas de Merchant Center te permite especificar un período con un intervalo personalizado o relativo. Todas las solicitudes de métricas deben incluir una condición para segments.date
en la cláusula WHERE
para indicar el período del que deseas recuperar tus datos de rendimiento.
Período personalizado
Puedes especificar fechas en formato ISO 8601(AAAA-MM-DD):
segments.date BETWEEN '2021-01-01' AND '2021-01-31'
O BIEN:
segments.date >= '2021-01-01' AND segments.date <= '2021-01-31'
Puedes definir cadenas de fecha con comillas simples ('
) o comillas dobles ("
). Sin embargo, debes ser coherente. Por ejemplo, "2021-01-01'
no es una cadena de fecha válida.
Período relativo
Además de los períodos personalizados, puedes especificar un período relativo, como LAST_30_DAYS
o THIS_MONTH
, usando DURING
en lugar de BETWEEN
y AND
:
WHERE segments.date DURING LAST_30_DAYS
Consulta la gramática del lenguaje de consultas de Merchant Center para ver la lista de los períodos relativos disponibles.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-08-13 (UTC)
[null,null,["Última actualización: 2025-08-13 (UTC)"],[[["\u003cp\u003eThe Merchant API is the new version of the Content API for Shopping and represents the future of the platform.\u003c/p\u003e\n"],["\u003cp\u003eAll Merchant Center Query Language requests for metrics require a \u003ccode\u003esegments.date\u003c/code\u003e condition in the \u003ccode\u003eWHERE\u003c/code\u003e clause to specify the desired time period for performance data retrieval.\u003c/p\u003e\n"],["\u003cp\u003eDate ranges can be specified using custom ISO 8601 formatted dates or relative date ranges like \u003ccode\u003eLAST_30_DAYS\u003c/code\u003e using \u003ccode\u003eDURING\u003c/code\u003e in the \u003ccode\u003eWHERE\u003c/code\u003e clause.\u003c/p\u003e\n"]]],["The beta version of the Merchant API, the new Content API for Shopping, is introduced. All requests for performance metrics require a `segments.date` condition in the `WHERE` clause. Dates can be specified in ISO 8601 format within a custom range using `BETWEEN` or `\u003e=` and `\u003c=`. Alternatively, relative date ranges like `LAST_30_DAYS` can be specified with `DURING`. For a list of available date ranges, the grammar documentation should be consulted.\n"],null,["# Date ranges\n\nThe Merchant Center Query Language lets you specify a date range using a custom\nor relative date range. **All requests for metrics must include a condition for\n`segments.date` in the`WHERE` clause** to indicate the time period from which\nyou want to retrieve your performance data.\n\nCustom date range\n-----------------\n\nYou can specify dates in ISO 8601(YYYY-MM-DD) format: \n\n segments.date BETWEEN '2021-01-01' AND '2021-01-31'\n\nOR: \n\n segments.date \u003e= '2021-01-01' AND segments.date \u003c= '2021-01-31'\n\nYou can define date strings with either single quotes (`'`) or double quotes\n(`\"`). However, you must be consistent; for example: `\"2021-01-01'` is not a\nvalid date string.\n\nRelative date range\n-------------------\n\nIn addition to custom date ranges, you can specify a relative date range such\nas `LAST_30_DAYS` or `THIS_MONTH` by using `DURING` instead of `BETWEEN` and\n`AND`: \n\n WHERE segments.date DURING LAST_30_DAYS\n\nCheck out the\n[Merchant Center Query Language grammar](/shopping-content/guides/reports/query-language/grammar)\nfor the list of available relative date ranges."]]