type TrafficDataResponse (v202408)
Stay organized with collections
Save and categorize content based on your preferences.
Contains forecasted and historical traffic volume data describing a segment of traffic.
- Namespace
-
https://www.google.com/apis/ads/publisher/v202408
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.
|
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-06 UTC.
[null,null,["Last updated 2025-08-06 UTC."],[[["\u003cp\u003eTrafficDataResponse object contains forecasted and historical traffic volume data.\u003c/p\u003e\n"],["\u003cp\u003eIt includes three time series: historical, forecasted, and forecasted assigned traffic ad opportunity counts.\u003c/p\u003e\n"],["\u003cp\u003eThe response also provides an overall date range spanning all time series.\u003c/p\u003e\n"],["\u003cp\u003eData may be null if the requested date range or traffic segment lacks historical, forecasted, or sell-through data.\u003c/p\u003e\n"]]],["The `ForecastService` utilizes the `getTrafficData()` method to generate a `TrafficDataResponse`. This response provides data on traffic segments, encompassing `historicalTimeSeries`, `forecastedTimeSeries`, and `forecastedAssignedTimeSeries`. Each of these fields contains time-series data about ad opportunity counts. An `overallDateRange` field indicates the total date range of all time series. If the data isn't available or not contained in the requested range, some or all the fields may be null. All the fields in the response are read-only.\n"],null,["# type TrafficDataResponse (v202408)\n\n**Service** \n**ForecastService** **Dependencies** \n[getTrafficData()](/ad-manager/api/reference/v202408/ForecastService#getTrafficData) \n▼\n**TrafficDataResponse**\n\nContains forecasted and historical traffic volume data describing a segment of traffic.\n\n*** ** * ** ***\n\nNamespace\n:\n `https://www.google.com/apis/ads/publisher/v202408`\n\n| Field ----- ||\n|------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ### `historicalTimeSeries` | ` `[TimeSeries](/ad-manager/api/reference/v202408/ForecastService.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. \u003cbr /\u003e |\n| ### `forecastedTimeSeries` | ` `[TimeSeries](/ad-manager/api/reference/v202408/ForecastService.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. \u003cbr /\u003e |\n| ### `forecastedAssignedTimeSeries` | ` `[TimeSeries](/ad-manager/api/reference/v202408/ForecastService.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. \u003cbr /\u003e |\n| ### `overallDateRange` | ` `[DateRange](/ad-manager/api/reference/v202408/ForecastService.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. \u003cbr /\u003e |"]]