API Báo cáo Search Ads 360 mới hiện đã ra mắt. Tham gia nhóm Google
searchads-api-announcements để luôn được cập nhật về những cải tiến và bản phát hành sắp tới.
Phạm vi ngày
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Ngôn ngữ truy vấn Search Ads 360 cho phép bạn chỉ định phạm vi ngày theo hai cách:
Phạm vi ngày tùy chỉnh
Bạn có thể chỉ định ngày ở định dạng 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'
Khoảng thời gian
Một số trường ngày đề cập đến một khoảng thời gian xác định trước, cụ thể là:
segments.weeksegments.monthsegments.quarter
Khi lọc theo các phân khúc này, bạn có thể sử dụng toán tử = với ngày là ngày đầu tiên của khoảng thời gian. Kể từ phiên bản 9, nếu bạn chỉ định một ngày không phải là ngày đầu tiên của một khoảng thời gian, thì lỗi MISALIGNED_DATE_FOR_FILTER sẽ được trả về.
Ví dụ: để chỉ định tháng 5 năm 2021, bạn sẽ sử dụng điều kiện sau, chỉ định ngày đầu tiên của tháng đó:
segments.month = '2021-05-01'
Phạm vi ngày được xác định trước
Sau đây là danh sách các phạm vi ngày đặt trước hợp lệ:
| Phạm vi ngày |
Báo cáo được tạo cho... |
TODAY |
Chỉ hôm nay. |
YESTERDAY |
Chỉ hôm qua. |
LAST_7_DAYS |
7 ngày qua (không tính hôm nay). |
LAST_BUSINESS_WEEK |
Tuần làm việc 5 ngày, từ thứ Hai đến thứ Sáu của tuần làm việc trước đó. |
THIS_MONTH |
Tất cả các ngày trong tháng hiện tại. |
LAST_MONTH |
Tất cả các ngày trong tháng trước. |
LAST_14_DAYS |
14 ngày qua (không tính hôm nay). |
LAST_30_DAYS |
30 ngày gần nhất, không tính ngày hôm nay. |
THIS_WEEK_SUN_TODAY |
Khoảng thời gian từ Chủ Nhật tuần trước đến ngày hiện tại. |
THIS_WEEK_MON_TODAY |
Khoảng thời gian từ thứ Hai tuần trước đến ngày hiện tại. |
LAST_WEEK_SUN_SAT |
Khoảng thời gian 7 ngày bắt đầu từ Chủ Nhật tuần trước. |
LAST_WEEK_MON_SUN |
Khoảng thời gian 7 ngày bắt đầu từ thứ Hai tuần trước. |
Ví dụ:
segments.date DURING LAST_30_DAYS
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-08-29 UTC.
[null,null,["Cập nhật lần gần đây nhất: 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"]]
