rocket
Perkenalkan
Merchant API
- pengganti resmi Content API for Shopping.
add_alert
Catatan: Content API for Shopping akan dihentikan pada 18 Agustus 2026.
Rentang tanggal
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Bahasa Kueri Merchant Center memungkinkan Anda menentukan rentang tanggal menggunakan rentang tanggal kustom atau relatif. Semua permintaan metrik harus menyertakan kondisi untuk
segments.date
dalam klausa WHERE
untuk menunjukkan jangka waktu yang
ingin Anda gunakan untuk mengambil data performa.
Rentang tanggal khusus
Anda dapat menentukan tanggal dalam format ISO 8601(YYYY-MM-DD):
segments.date BETWEEN '2021-01-01' AND '2021-01-31'
ATAU:
segments.date >= '2021-01-01' AND segments.date <= '2021-01-31'
Anda dapat menentukan string tanggal dengan tanda kutip tunggal ('
) atau tanda kutip ganda
("
). Namun, Anda harus konsisten; misalnya: "2021-01-01'
bukan
string tanggal yang valid.
Rentang tanggal relatif
Selain rentang tanggal kustom, Anda dapat menentukan rentang tanggal relatif seperti LAST_30_DAYS
atau THIS_MONTH
dengan menggunakan DURING
, bukan BETWEEN
dan
AND
:
WHERE segments.date DURING LAST_30_DAYS
Lihat
Tata bahasa Merchant Center Query Language
untuk mengetahui daftar rentang tanggal relatif yang tersedia.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-08-13 UTC.
[null,null,["Terakhir diperbarui pada 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."]]