Search Ads 360 Reporting API versi baru kini tersedia. Bergabunglah dengan grup Google
searchads-api-announcements untuk terus mendapatkan informasi terbaru tentang peningkatan dan rilis mendatang.
Rentang Tanggal
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Bahasa Kueri Search Ads 360 memungkinkan Anda menentukan rentang tanggal dengan dua cara:
Rentang tanggal khusus
Anda dapat menentukan tanggal dalam format ISO 8601(YYYY-MM-DD):
segments.date BETWEEN '2019-01-01' AND '2019-01-31'
segments.date >= '2019-01-01' AND segments.date <= '2019-01-31'
Jangka waktu
Beberapa kolom tanggal merujuk pada jangka waktu yang telah ditentukan, khususnya:
segments.weeksegments.monthsegments.quarter
Saat memfilter segmen ini, Anda dapat menggunakan operator = dengan tanggal yang merupakan hari pertama jangka waktu. Mulai dari v9, jika Anda menentukan tanggal
yang bukan hari pertama menstruasi, error MISALIGNED_DATE_FOR_FILTER akan
ditampilkan.
Misalnya, untuk menentukan bulan Mei tahun 2021, Anda akan menggunakan
kondisi berikut, dengan menentukan hari pertama bulan tersebut:
segments.month = '2021-05-01'
Rentang tanggal yang telah ditentukan
Daftar rentang tanggal standar yang valid adalah sebagai berikut:
| Rentang tanggal |
Laporan dibuat untuk... |
TODAY |
Hanya hari ini. |
YESTERDAY |
Hanya kemarin. |
LAST_7_DAYS |
7 hari terakhir tidak termasuk hari ini. |
LAST_BUSINESS_WEEK |
5 hari kerja, Senin hingga Jumat, pada minggu kerja sebelumnya. |
THIS_MONTH |
Semua hari dalam bulan ini. |
LAST_MONTH |
Semua hari pada bulan sebelumnya. |
LAST_14_DAYS |
14 hari terakhir tidak termasuk hari ini. |
LAST_30_DAYS |
30 hari terakhir tidak termasuk hari ini. |
THIS_WEEK_SUN_TODAY |
Periode antara hari Minggu sebelumnya dan hari ini. |
THIS_WEEK_MON_TODAY |
Periode antara hari Senin sebelumnya dan hari ini. |
LAST_WEEK_SUN_SAT |
Periode 7 hari yang dimulai dengan hari Minggu sebelumnya. |
LAST_WEEK_MON_SUN |
Periode 7 hari yang dimulai dengan hari Senin sebelumnya. |
Contoh:
segments.date DURING LAST_30_DAYS
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-29 UTC.
[null,null,["Terakhir diperbarui pada 2025-08-29 UTC."],[[["\u003cp\u003eThe Search Ads 360 Query Language allows specifying date ranges using either custom dates or predefined date ranges.\u003c/p\u003e\n"],["\u003cp\u003eCustom date ranges can be defined using ISO 8601 format and operators like \u003ccode\u003eBETWEEN\u003c/code\u003e, \u003ccode\u003e>=\u003c/code\u003e, and \u003ccode\u003e<=\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eTime period segments such as week, month, and quarter require filtering with the first day of the period using the \u003ccode\u003e=\u003c/code\u003e operator.\u003c/p\u003e\n"],["\u003cp\u003ePredefined date ranges offer shortcuts for common periods like \u003ccode\u003eTODAY\u003c/code\u003e, \u003ccode\u003eLAST_7_DAYS\u003c/code\u003e, \u003ccode\u003eLAST_MONTH\u003c/code\u003e, and others, simplifying query construction.\u003c/p\u003e\n"],["\u003cp\u003eSpecifying a date that is not the first day of a period for segments like \u003ccode\u003esegments.month\u003c/code\u003e will result in a \u003ccode\u003eMISALIGNED_DATE_FOR_FILTER\u003c/code\u003e error.\u003c/p\u003e\n"]]],["The Search Ads 360 Query Language uses custom or predefined date ranges. Custom ranges utilize ISO 8601 format (YYYY-MM-DD) for specific dates (e.g., `segments.date BETWEEN '2019-01-01' AND '2019-01-31'`). For segments like `week`, `month`, or `quarter`, filters must use the first day of the period. Predefined ranges, such as `TODAY`, `LAST_7_DAYS`, or `LAST_MONTH`, offer shortcuts (e.g., `segments.date DURING LAST_30_DAYS`).\n"],null,["# Date Ranges\n\nThe Search Ads 360 Query Language lets you specify the date range in two ways:\n\n- custom date range\n\n- predefined date range\n\nCustom date range\n-----------------\n\nYou can specify dates in ISO 8601(`YYYY-MM-DD`) format: \n\n segments.date BETWEEN '2019-01-01' AND '2019-01-31'\n\n segments.date \u003e= '2019-01-01' AND segments.date \u003c= '2019-01-31'\n\n### Time periods\n\nSome date fields refer to a predefined period of time, specifically:\n\n- `segments.week`\n- `segments.month`\n- `segments.quarter`\n\nWhen filtering on these segments, you can use the `=` operator with the date\nthat is the first day of the time period. Starting in v9, if you specify a date\nthat is not the first day of a period, a `MISALIGNED_DATE_FOR_FILTER` error is\nreturned.\n\nFor example, to specify the month of May in the year 2021, you would use the\nfollowing condition, specifying the first day of that month: \n\n segments.month = '2021-05-01'\n\nPredefined date range\n---------------------\n\nThe list of valid predefined date ranges is as follows:\n\n| Date range | Reports are generated for... |\n|-----------------------|--------------------------------------------------------------------------------|\n| `TODAY` | Today only. |\n| `YESTERDAY` | Yesterday only. |\n| `LAST_7_DAYS` | The last 7 days not including today. |\n| `LAST_BUSINESS_WEEK` | The 5 day business week, Monday through Friday, of the previous business week. |\n| `THIS_MONTH` | All days in the current month. |\n| `LAST_MONTH` | All days in the previous month. |\n| `LAST_14_DAYS` | The last 14 days not including today. |\n| `LAST_30_DAYS` | The last 30 days not including today. |\n| `THIS_WEEK_SUN_TODAY` | The period between the previous Sunday and the current day. |\n| `THIS_WEEK_MON_TODAY` | The period between the previous Monday and the current day. |\n| `LAST_WEEK_SUN_SAT` | The 7-day period starting with the previous Sunday. |\n| `LAST_WEEK_MON_SUN` | The 7-day period starting with the previous Monday. |\n\nExample: \n\n segments.date DURING LAST_30_DAYS"]]
