# ValidityPeriod

- [JSON representation](https://developers.google.com/maps-booking/reference/maps-booking-api/rest/v1alpha/ValidityPeriod#SCHEMA_REPRESENTATION)

\[START validity_period_definition\]

| JSON representation |
|---|
| ``` { "validPeriod": { object (`https://developers.google.com/maps-booking/reference/maps-booking-api/rest/v1alpha/ValidityRange`) }, "timeOfDay": [ { object (`TimeOfDayWindow`) } ], "timeExceptions": [ { object (`https://developers.google.com/maps-booking/reference/maps-booking-api/rest/v1alpha/ValidTimeException`) } ], "dateExceptions": [ { object (`https://developers.google.com/maps-booking/reference/maps-booking-api/rest/v1alpha/ActionLink#Date`) } ], "validityScope": enum (`https://developers.google.com/maps-booking/reference/maps-booking-api/rest/v1alpha/ValidityScope`), "validityDurationInDays": integer } ``` |

| Fields ||
|---|---|
| `validPeriod` | ``object (`https://developers.google.com/maps-booking/reference/maps-booking-api/rest/v1alpha/ValidityRange`)`` The start and end timestamp that the offer is valid for. These times must represent distinct days i.e. the start time must be 00:00 (beginning of the day) and the end time must be 00:00 (exclusive) on the day the validity period ends. |
| `timeOfDay[]` | ``object (`TimeOfDayWindow`)`` Specifies the valid time interval on a given day and which days are available for the offer. For timeframes crossing midnight (e.g., 10 PM to 2 AM), use separate windows for each day: one ending at 11:59:59 PM and another starting at 12:00 AM the next day. For example: Monday: 10AM to 5PM Tuesday: 10AM to 2PM Tuesday: 5PM to 7PM Wed, Thur, Fri, Sat, Sun: 3PM to 7PM If none set, it means the offer is available for all time within `validPeriod`. |
| `timeExceptions[]` | ``object (`https://developers.google.com/maps-booking/reference/maps-booking-api/rest/v1alpha/ValidTimeException`)`` Specifies exceptions to the above validPeriod and valid_time_of_week |
| `dateExceptions[]` | ``object (`https://developers.google.com/maps-booking/reference/maps-booking-api/rest/v1alpha/ActionLink#Date`)`` Specifies exceptions in days to the above validPeriod and timeOfDay |
| `validityScope` | ``enum (`https://developers.google.com/maps-booking/reference/maps-booking-api/rest/v1alpha/ValidityScope`)`` Specifies the scope of the validity period. |
| `validityDurationInDays` | `integer` The duration (in days) the voucher/coupon is valid for, once purchased. |