Especificar um período
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Períodos relativos
As consultas de relatório têm um campo date_range para especificar as datas que serão incluídas.
no relatório. Os seguintes valores podem ser especificados para date_range:
TODAYYESTERDAYMONTH_TO_DATEYEAR_TO_DATELAST_7_DAYSLAST_30_DAYSCUSTOM
Se nenhum for especificado, o período padrão será CUSTOM.
Períodos personalizados
Quando date_range for definido como CUSTOM ou for
não especificado, você deve definir start_date e end_date como
as datas (inclusivas) de início e término do período do relatório.
Nos parâmetros de consulta da solicitação de API, os parâmetros de data de início terão a seguinte aparência:
startDate.year=2021&startDate.month=3&startDate.day=1
Da mesma forma, os parâmetros de data de término terão esta aparência:
endDate.year=2021&endDate.month=3&endDate.day=3
Próximas etapas
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-07-26 UTC.
[null,null,["Última atualização 2025-07-26 UTC."],[[["\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)"]]
