- [JSON representation](https://developers.google.com/workspace/gmail/postmaster/reference/rest/v2/TimeQuery#SCHEMA_REPRESENTATION)
- [DateRanges](https://developers.google.com/workspace/gmail/postmaster/reference/rest/v2/TimeQuery#DateRanges)
  - [JSON representation](https://developers.google.com/workspace/gmail/postmaster/reference/rest/v2/TimeQuery#DateRanges.SCHEMA_REPRESENTATION)
- [DateRange](https://developers.google.com/workspace/gmail/postmaster/reference/rest/v2/TimeQuery#DateRange)
  - [JSON representation](https://developers.google.com/workspace/gmail/postmaster/reference/rest/v2/TimeQuery#DateRange.SCHEMA_REPRESENTATION)
- [DateList](https://developers.google.com/workspace/gmail/postmaster/reference/rest/v2/TimeQuery#DateList)
  - [JSON representation](https://developers.google.com/workspace/gmail/postmaster/reference/rest/v2/TimeQuery#DateList.SCHEMA_REPRESENTATION)

The date ranges or specific dates for which you want to retrieve data.

| JSON representation |
|---|
| ``` { "dateRanges": { object (`https://developers.google.com/workspace/gmail/postmaster/reference/rest/v2/TimeQuery#DateRanges`) }, "dateList": { object (`https://developers.google.com/workspace/gmail/postmaster/reference/rest/v2/TimeQuery#DateList`) } } ``` |

| Fields ||
|---|---|
| Union field `time_specification`. The type of time specification. `time_specification` can be only one of the following: ||
| `dateRanges` | ``object (`https://developers.google.com/workspace/gmail/postmaster/reference/rest/v2/TimeQuery#DateRanges`)`` A list of date ranges. |
| `dateList` | ``object (`https://developers.google.com/workspace/gmail/postmaster/reference/rest/v2/TimeQuery#DateList`)`` A list of specific dates. |

## DateRanges

A set of date ranges.

| JSON representation |
|---|
| ``` { "dateRanges": [ { object (`https://developers.google.com/workspace/gmail/postmaster/reference/rest/v2/TimeQuery#DateRange`) } ] } ``` |

| Fields ||
|---|---|
| `dateRanges[]` | ``object (`https://developers.google.com/workspace/gmail/postmaster/reference/rest/v2/TimeQuery#DateRange`)`` Required. The list of date ranges for which to retrieve data. |

## DateRange

A single date range defined by a start and end date.

| JSON representation |
|---|
| ``` { "start": { object (`https://developers.google.com/workspace/gmail/postmaster/reference/rest/v2/Date`) }, "end": { object (`https://developers.google.com/workspace/gmail/postmaster/reference/rest/v2/Date`) } } ``` |

| Fields ||
|---|---|
| `start` | ``object (`https://developers.google.com/workspace/gmail/postmaster/reference/rest/v2/Date`)`` Required. The inclusive start date of the date range. |
| `end` | ``object (`https://developers.google.com/workspace/gmail/postmaster/reference/rest/v2/Date`)`` Required. The inclusive end date of the date range. |

## DateList

A set of specific dates.

| JSON representation |
|---|
| ``` { "dates": [ { object (`https://developers.google.com/workspace/gmail/postmaster/reference/rest/v2/Date`) } ] } ``` |

| Fields ||
|---|---|
| `dates[]` | ``object (`https://developers.google.com/workspace/gmail/postmaster/reference/rest/v2/Date`)`` Required. The list of specific dates for which to retrieve data. |