rocket
Découvrez l'
API Merchant, qui remplace officiellement Content API for Shopping.
update
Dernières actualités
concernant les nouvelles fonctionnalités, les corrections de bugs et les mises à jour de l'API Merchant.
add_alert
Remarque : Content API for Shopping sera abandonnée le 18 août 2026.
Plages de dates
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Le langage de requête Merchant Center vous permet de spécifier une plage de dates personnalisée ou relative. Toutes les requêtes de métriques doivent inclure une condition pour segments.date dans la clause WHERE afin d'indiquer la période pour laquelle vous souhaitez récupérer vos données sur les performances.
Période personnalisée
Vous pouvez indiquer les dates au format ISO 8601(AAAA-MM-JJ) :
segments.date BETWEEN '2021-01-01' AND '2021-01-31'
OU :
segments.date >= '2021-01-01' AND segments.date <= '2021-01-31'
Vous pouvez définir des chaînes de date comportant des guillemets simples (') ou doubles ("). Cependant, vous devez être cohérent : "2021-01-01' n'est pas une chaîne de date valide, par exemple.
Plage de dates relative
En plus d'une plage de dates personnalisée, vous pouvez spécifier une plage de dates relative comme LAST_30_DAYS ou THIS_MONTH en utilisant DURING au lieu de BETWEEN et AND :
WHERE segments.date DURING LAST_30_DAYS
Consultez la grammaire du langage de requête Merchant Center pour obtenir la liste des plages de dates relatives disponibles.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/13 (UTC).
[null,null,["Dernière mise à jour le 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."]]
