type TrafficDataResponse (v202508)

  • TrafficDataResponse contains forecasted and historical traffic volume data.

  • It includes time series data for historical traffic counts, forecasted traffic counts, and forecasted sold traffic counts.

  • The overallDateRange field summarizes the date range covered by all time series within the response.
Service
ForecastService
Dependencies
getTrafficData()
▼
TrafficDataResponse

Contains forecasted and historical traffic volume data describing a segment of traffic.

Namespace
https://www.google.com/apis/ads/publisher/v202508

Field

historicalTimeSeries

TimeSeries

Time series of historical traffic ad opportunity counts.

This may be null if the requested date range did not contain any historical dates, or if no historical data are available for the requested traffic segment. This attribute is read-only.

forecastedTimeSeries

TimeSeries

Time series of forecasted traffic ad opportunity counts.

This may be null if the requested date range did not contain any future dates, or if no forecasted data are available for the requested traffic segment. This attribute is read-only.

forecastedAssignedTimeSeries

TimeSeries

Time series of future traffic volumes forecasted to be sold.

This may be null if the requested date range did not contain any future dates, or if no sell-through data are available for the requested traffic segment. This attribute is read-only.

overallDateRange

DateRange

The overall date range spanned by the union of all time series in the response.

This is a summary field for convenience. The value will be set such that the start date is equal to the earliest start date of all time series included, and the end date is equal to the latest end date of all time series included.

If all time series fields are null, this field will also be null. This attribute is read-only.