指定日期範圍
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
相對日期範圍
報表查詢提供 date_range 欄位，用於指定要納入哪些日期的資料
顯示報表中的資料您可以為 date_range 指定下列值：
TODAYYESTERDAYMONTH_TO_DATEYEAR_TO_DATELAST_7_DAYSLAST_30_DAYSCUSTOM
請注意，如未指定，預設日期範圍為 CUSTOM。
自訂日期範圍
當 date_range 設為 CUSTOM 或
未指定，您必須將 start_date 和 end_date 設為
報表範圍內的開始和結束日期。
在 API 請求的查詢參數中，開始日期參數如下所示：
startDate.year=2021&startDate.month=3&startDate.day=1
同樣地，結束日期參數看起來會像這樣：
endDate.year=2021&endDate.month=3&endDate.day=3
後續步驟
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-07-26 (世界標準時間)。
[null,null,["上次更新時間：2025-07-26 (世界標準時間)。"],[[["\u003cp\u003eAdSense report queries use a \u003ccode\u003edate_range\u003c/code\u003e field to specify the timeframe for included data, accepting values such as \u003ccode\u003eTODAY\u003c/code\u003e, \u003ccode\u003eYESTERDAY\u003c/code\u003e, or various relative ranges.\u003c/p\u003e\n"],["\u003cp\u003eFor custom date ranges, set \u003ccode\u003edate_range\u003c/code\u003e to \u003ccode\u003eCUSTOM\u003c/code\u003e and specify the inclusive start and end dates using \u003ccode\u003estart_date\u003c/code\u003e and \u003ccode\u003eend_date\u003c/code\u003e parameters.\u003c/p\u003e\n"],["\u003cp\u003eCustom start and end dates are defined by separate parameters for year, month, and day, formatted like \u003ccode\u003estartDate.year=2021&startDate.month=3&startDate.day=1\u003c/code\u003e.\u003c/p\u003e\n"]]],["Report queries utilize a `date_range` field to define data inclusion periods. Available options are `TODAY`, `YESTERDAY`, `MONTH_TO_DATE`, `YEAR_TO_DATE`, `LAST_7_DAYS`, `LAST_30_DAYS`, and `CUSTOM`. The default is `CUSTOM`. When `CUSTOM` is used, `start_date` and `end_date` parameters are mandatory, set via `startDate.year`, `startDate.month`, `startDate.day` and `endDate.year`, `endDate.month`, `endDate.day` in the API request query.\n"],null,["# Specifying a Date Range\n\nRelative date ranges\n--------------------\n\nReport queries have a `date_range` field for specifying the dates for which to include\ndata in the report. The following values can be specified for `date_range`:\n\n- `TODAY`\n- `YESTERDAY`\n- `MONTH_TO_DATE`\n- `YEAR_TO_DATE`\n- `LAST_7_DAYS`\n- `LAST_30_DAYS`\n- `CUSTOM`\n\nNote that the default date range if none is specified is `CUSTOM`.\n\nCustom date ranges\n------------------\n\nWhen `date_range` is set to `CUSTOM` or is\nunspecified, you must set `start_date` and `end_date` to\nthe (inclusive) start and end dates of the report range.\n\n\nIn your API request's query parameters, the start date parameters will look like this: \n\n```\nstartDate.year=2021&startDate.month=3&startDate.day=1\n```\n\nSimilarly, the end date parameters will look like this: \n\n```\nendDate.year=2021&endDate.month=3&endDate.day=3\n```\n\nNext steps\n----------\n\n- [Running Large Reports](/adsense/management/reporting/large_reports)\n- [Filling in Missing Dates](/adsense/management/reporting/missing_dates)\n- [Dates in Report Results](/adsense/management/reporting/handling_results#dates)"]]
