rocket
Poznaj
Merchant API, który oficjalnie zastąpi interfejs Content API for Shopping.
update
Najnowsze informacje
o nowych funkcjach, poprawkach błędów i aktualizacjach interfejsu Merchant API.
add_alert
Uwaga: 18 sierpnia 2026 r. wycofamy interfejs Content API for Shopping.
Zakresy dat
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Język zapytań Merchant Center umożliwia określanie zakresu dat za pomocą niestandardowego lub względnego zakresu dat. Wszystkie prośby o dane muszą zawierać warunek w klauzuli segments.dateWHERE, aby wskazać okres, z którego chcesz pobrać dane o skuteczności.
Niestandardowy zakres dat
Daty możesz podawać w formacie ISO 8601(RRRR-MM-DD):
segments.date BETWEEN '2021-01-01' AND '2021-01-31'
LUB:
segments.date >= '2021-01-01' AND segments.date <= '2021-01-31'
Ciągi znaków daty możesz definiować za pomocą pojedynczych (') lub podwójnych cudzysłowów ("). Musisz jednak zachować spójność. Na przykład "2021-01-01' nie jest prawidłowym ciągiem znaków daty.
Względny zakres dat
Oprócz niestandardowych zakresów dat możesz określić względny zakres dat, np. LAST_30_DAYS lub THIS_MONTH, używając DURING zamiast BETWEEN i AND:
WHERE segments.date DURING LAST_30_DAYS
Listę dostępnych względnych zakresów dat znajdziesz w gramatyce języka zapytań Merchant Center.
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-08-13 UTC.
[null,null,["Ostatnia aktualizacja: 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."]]
