type ProspectiveLineItem (v202408)
Stay organized with collections
Save and categorize content based on your preferences.
Represents a prospective line item to be forecasted.
- Namespace
-
https://www.google.com/apis/ads/publisher/v202408
Field
|
lineItem
|
LineItem
The target of the forecast. If LineItem.id is null or no line item exists with that ID,
then a forecast is computed for the subject, predicting what would happen if it were added to
the network. If a line item already exists with LineItem.id, the forecast is computed
for the subject, predicting what would happen if the existing line item's settings were
modified to match the subject.
|
proposalLineItem
|
ProposalLineItem
The target of the forecast if this prospective line item is a
proposal line item.
If ProposalLineItem.id is null or no proposal line item exists with
that ID, then a forecast is computed for the subject, predicting
what would happen if it were added to the network. If a proposal
line item already exists with ProposalLineItem.id, the forecast is
computed for the subject, predicting what would happen if the
existing proposal line item's settings were modified to match the
subject.
A proposal line item can optionally correspond to an order
LineItem, in
which case, by forecasting a proposal line item, the corresponding
line item is implicitly ignored in the forecasting.
Either lineItem or proposalLineItem should be specified but not both.
|
advertiserId
|
xsd:long
When set, the line item is assumed to be from this advertiser, and unified blocking rules will
apply accordingly. If absent, line items without an existing order won't be subject to unified
blocking rules.
|
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\u003e\u003ccode\u003eProspectiveLineItem\u003c/code\u003e objects represent a line item or proposal line item to be forecasted within Google Ad Manager.\u003c/p\u003e\n"],["\u003cp\u003eForecasts can be generated for new or existing line items to predict delivery and availability.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eProspectiveLineItem\u003c/code\u003e allows specifying either a \u003ccode\u003elineItem\u003c/code\u003e or a \u003ccode\u003eproposalLineItem\u003c/code\u003e for forecasting, but not both simultaneously.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eadvertiserId\u003c/code\u003e field, if set, determines the application of unified blocking rules for the prospective line item.\u003c/p\u003e\n"],["\u003cp\u003eThe provided namespace for \u003ccode\u003eProspectiveLineItem\u003c/code\u003e is \u003ccode\u003ehttps://www.google.com/apis/ads/publisher/v202408\u003c/code\u003e.\u003c/p\u003e\n"]]],["The `ForecastService` offers `getAvailabilityForecast()` and `getDeliveryForecast()` to analyze prospective line items. `ProspectiveLineItem` allows forecasting the impact of adding or modifying a `LineItem` or `ProposalLineItem`. If an ID exists, the forecast predicts changes if settings are modified; otherwise, it predicts the impact of adding the item. The `advertiserId` field applies unified blocking rules to the forecast, and specifying either `lineItem` or `proposalLineItem` is necessary.\n"],null,["# type ProspectiveLineItem (v202408)\n\n**Service** \n**ForecastService** **Dependencies** \n[getAvailabilityForecast()](/ad-manager/api/reference/v202408/ForecastService#getAvailabilityForecast) [getDeliveryForecast()](/ad-manager/api/reference/v202408/ForecastService#getDeliveryForecast) \n▼\n**ProspectiveLineItem**\n\nRepresents a prospective line item to be forecasted.\n\n*** ** * ** ***\n\nNamespace\n:\n `https://www.google.com/apis/ads/publisher/v202408`\n\n| Field ----- ||\n|------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ### `lineItem` | ` `[LineItem](/ad-manager/api/reference/v202408/ForecastService.LineItem)` ` The target of the forecast. If [LineItem.id](/ad-manager/api/reference/v202408/ForecastService.LineItem#id) is null or no line item exists with that ID, then a forecast is computed for the subject, predicting what would happen if it were added to the network. If a line item already exists with [LineItem.id](/ad-manager/api/reference/v202408/ForecastService.LineItem#id), the forecast is computed for the subject, predicting what would happen if the existing line item's settings were modified to match the subject. |\n| ### `proposalLineItem` | ` `[ProposalLineItem](/ad-manager/api/reference/v202408/ForecastService.ProposalLineItem)` ` The target of the forecast if this prospective line item is a proposal line item. If [ProposalLineItem.id](/ad-manager/api/reference/v202408/ForecastService.ProposalLineItem#id) is null or no proposal line item exists with that ID, then a forecast is computed for the subject, predicting what would happen if it were added to the network. If a proposal line item already exists with [ProposalLineItem.id](/ad-manager/api/reference/v202408/ForecastService.ProposalLineItem#id), the forecast is computed for the subject, predicting what would happen if the existing proposal line item's settings were modified to match the subject. A proposal line item can optionally correspond to an order [LineItem](/ad-manager/api/reference/v202408/ForecastService.LineItem), in which case, by forecasting a proposal line item, the corresponding line item is implicitly ignored in the forecasting. Either [lineItem](#lineItem) or [proposalLineItem](#proposalLineItem) should be specified but not both. \u003cbr /\u003e |\n| ### `advertiserId` | ` `xsd:`long` When set, the line item is assumed to be from this advertiser, and unified blocking rules will apply accordingly. If absent, line items without an existing order won't be subject to unified blocking rules. |"]]