Starting September 8, 2025, every new line item will need to declare whether or not they will serve Eurpoean Union (EU) political ads. Display & Video 360 API and SDF uploads that don't provide declarations will fail. See our deprecations page for more details on how to update your integration to make this declaration.
The upper bound of the date range, inclusive. Must specify a positive value for year, month, and day.
Date
Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following:
A full date, with non-zero year, month, and day values.
A month and day, with a zero year (for example, an anniversary).
A year on its own, with a zero month and a zero day.
A year and month, with a zero day (for example, a credit card expiration date).
Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
month
integer
Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
day
integer
Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.
[null,null,["Last updated 2024-09-18 UTC."],[[["\u003cp\u003eDisplay & Video 360 API v2 is sunset.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eDateRange\u003c/code\u003e specifies a date range with inclusive start and end dates.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eDate\u003c/code\u003e represents a calendar date (full or partial) with year, month, and day.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eDate\u003c/code\u003e can represent a full date, month/day, year only, or year/month.\u003c/p\u003e\n"]]],["The document defines the structure of a date range and a date for the Display & Video 360 API. A date range uses JSON format with `startDate` and `endDate` objects, specifying the inclusive bounds. Each `date` object contains `year`, `month`, and `day` fields; with rules, being a positive number for year, month or day, or 0 in order to represent partial dates. The format for representation is provided in JSON.\n"],null,["# DateRange\n\n| Display \\& Video 360 API v2 has sunset.\n- [JSON representation](#SCHEMA_REPRESENTATION)\n- [Date](#Date)\n - [JSON representation](#Date.SCHEMA_REPRESENTATION)\n\nA date range.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"startDate\": { object (/display-video/api/reference/rest/v2/DateRange#Date) }, \"endDate\": { object (/display-video/api/reference/rest/v2/DateRange#Date) } } ``` |\n\n| Fields ||\n|-------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `startDate` | `object (`[Date](/display-video/api/reference/rest/v2/DateRange#Date)`)` The lower bound of the date range, inclusive. Must specify a positive value for `year`, `month`, and `day`. |\n| `endDate` | `object (`[Date](/display-video/api/reference/rest/v2/DateRange#Date)`)` The upper bound of the date range, inclusive. Must specify a positive value for `year`, `month`, and `day`. |\n\nDate\n----\n\nRepresents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following:\n\n- A full date, with non-zero year, month, and day values.\n- A month and day, with a zero year (for example, an anniversary).\n- A year on its own, with a zero month and a zero day.\n- A year and month, with a zero day (for example, a credit card expiration date).\n\nRelated types:\n\n- `google.type.TimeOfDay`\n- `google.type.DateTime`\n- [google.protobuf.Timestamp](https://protobuf.dev/reference/protobuf/google.protobuf/#timestamp)\n\n| JSON representation |\n|---------------------------------------------------------------|\n| ``` { \"year\": integer, \"month\": integer, \"day\": integer } ``` |\n\n| Fields ||\n|---------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `year` | `integer` Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year. |\n| `month` | `integer` Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day. |\n| `day` | `integer` Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant. |"]]