rocket
Merchant API
– der offizielle Nachfolger der Content API for Shopping.
add_alert
Hinweis: Die Content API for Shopping wird am 18. August 2026 eingestellt.
Zeiträume
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Mit der Merchant Center Query Language können Sie einen Zeitraum mit einem benutzerdefinierten oder relativen Zeitraum angeben. Alle Anfragen für Messwerte müssen eine Bedingung für segments.date in der WHERE-Klausel enthalten, um den Zeitraum anzugeben, aus dem Sie Ihre Leistungsdaten abrufen möchten.
Benutzerdefinierter Zeitraum
Sie können Datumsangaben im ISO 8601-Format(JJJJ-MM-TT) angeben:
segments.date BETWEEN '2021-01-01' AND '2021-01-31'
ODER:
segments.date >= '2021-01-01' AND segments.date <= '2021-01-31'
Sie können Datumsstrings entweder mit einfachen (') oder doppelten Anführungszeichen (") definieren. Sie müssen jedoch konsistent sein. "2021-01-01' ist beispielsweise kein gültiger Datumsstring.
Relativer Zeitraum
Zusätzlich zu benutzerdefinierten Zeiträumen können Sie auch einen relativen Zeitraum wie LAST_30_DAYS oder THIS_MONTH angeben. Verwenden Sie dazu DURING anstelle von BETWEEN und AND:
WHERE segments.date DURING LAST_30_DAYS
Eine Liste der verfügbaren relativen Zeiträume finden Sie in der Grammatik der Merchant Center Query Language.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-08-13 (UTC).
[null,null,["Zuletzt aktualisiert: 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."]]
