# type LineItem (v202602)

**Service** **ForecastService** [LineItemService](https://developers.google.com/ad-manager/api/reference/v202602/LineItemService.LineItem) **Dependencies** [ProspectiveLineItem](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.ProspectiveLineItem) ▼ **LineItem** **Inheritance** [LineItemSummary](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItemSummary) ▼ **LineItem**


[LineItem](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem) is an advertiser's commitment to purchase a specific number of ad impressions,
clicks, or time.

*** ** * ** ***

Namespace
:
    `https://www.google.com/apis/ads/publisher/v202602`

| ## Field ||
|---|---|
| **`LineItemSummary` (inherited)** ||
| ### `orderId` | ` xsd:long` The ID of the [Order](https://developers.google.com/ad-manager/api/reference/v202602/OrderService.Order) to which the `LineItem` belongs. This attribute is required on create and ignored on update. |
| ### `id` | ` xsd:long` Uniquely identifies the `LineItem`. This attribute is read-only and is assigned by Google when a line item is created. |
| ### `name` | ` xsd:string` The name of the line item. This attribute is required and has a maximum length of 255 characters. |
| ### `externalId` | ` xsd:string` An identifier for the `LineItem` that is meaningful to the publisher. This attribute is optional and has a maximum length of 255 characters. |
| ### `orderName` | ` xsd:string` The name of the [Order](https://developers.google.com/ad-manager/api/reference/v202602/OrderService.Order). This value is read-only. |
| ### `startDateTime` | ` https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.DateTime ` The date and time on which the `LineItem` is enabled to begin serving. This attribute is required and must be in the future. |
| ### `startDateTimeType` | ` https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.StartDateTimeType ` Specifies whether to start serving to the `LineItem` right away, in an hour, etc. This attribute is optional and defaults to [StartDateTimeType.USE_START_DATE_TIME](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.StartDateTimeType#USE_START_DATE_TIME). *** ** * ** *** **Enumerations** `USE_START_DATE_TIME` :   Use the value in [startDateTime](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem#startDateTime). `IMMEDIATELY` :   The entity will start serving immediately. [startDateTime](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem#startDateTime) in the request is ignored and will be set to the current time. Additionally, [startDateTimeType](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem#startDateTimeType) will be set to [StartDateTimeType.USE_START_DATE_TIME](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.StartDateTimeType#USE_START_DATE_TIME). `ONE_HOUR_FROM_NOW` :   The entity will start serving one hour from now. [startDateTime](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem#startDateTime) in the request is ignored and will be set to one hour from the current time. Additionally, [startDateTimeType](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem#startDateTimeType) will be set to [StartDateTimeType.USE_START_DATE_TIME](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.StartDateTimeType#USE_START_DATE_TIME). `UNKNOWN` :   The value returned if the actual value is not exposed by the requested API version. <br /> |
| ### `endDateTime` | ` https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.DateTime ` The date and time on which the `LineItem` will stop serving. This attribute is required unless [LineItem.unlimitedEndDateTime](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem#unlimitedEndDateTime) is set to `true`. If specified, it must be after the [LineItem.startDateTime](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem#startDateTime). This end date and time does not include auto extension days. |
| ### `autoExtensionDays` | ` xsd:int` The number of days to allow a line item to deliver past its [endDateTime](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem#endDateTime). A maximum of 7 days is allowed. This is feature is only available for Ad Manager 360 accounts. |
| ### `unlimitedEndDateTime` | ` xsd:boolean` Specifies whether or not the `LineItem` has an end time. This attribute is optional and defaults to false. It can be be set to `true` for only line items of type [LineItemType.SPONSORSHIP](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItemType#SPONSORSHIP), [LineItemType.NETWORK](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItemType#NETWORK), [LineItemType.PRICE_PRIORITY](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItemType#PRICE_PRIORITY) and [LineItemType.HOUSE](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItemType#HOUSE). |
| ### `creativeRotationType` | ` https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.CreativeRotationType ` The strategy used for displaying multiple [Creative](https://developers.google.com/ad-manager/api/reference/v202602/CreativeService.Creative) objects that are associated with the `LineItem`. This attribute is required. *** ** * ** *** **Enumerations** `EVEN` :   Creatives are displayed roughly the same number of times over the duration of the line item. `OPTIMIZED` :   Creatives are served roughly proportionally to their performance. `MANUAL` :   Creatives are served roughly proportionally to their weights, set on the [LineItemCreativeAssociation](https://developers.google.com/ad-manager/api/reference/v202602/LineItemCreativeAssociationService.LineItemCreativeAssociation). `SEQUENTIAL` :   Creatives are served exactly in sequential order, aka Storyboarding. Set on the [LineItemCreativeAssociation](https://developers.google.com/ad-manager/api/reference/v202602/LineItemCreativeAssociationService.LineItemCreativeAssociation). <br /> |
| ### `deliveryRateType` | ` https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.DeliveryRateType ` The strategy for delivering ads over the course of the line item's duration. This attribute is optional and defaults to [DeliveryRateType.EVENLY](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.DeliveryRateType#EVENLY) or [DeliveryRateType.FRONTLOADED](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.DeliveryRateType#FRONTLOADED) depending on the network's configuration. *** ** * ** *** **Enumerations** `EVENLY` :   Line items are served as evenly as possible across the number of days specified in a line item's [LineItem.duration](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem#duration). `FRONTLOADED` :   Line items are served more aggressively in the beginning of the flight date. `AS_FAST_AS_POSSIBLE` :   The booked impressions for a line item may be delivered well before the [LineItem.endDateTime](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem#endDateTime). Other lower-priority or lower-value line items will be stopped from delivering until this line item meets the number of impressions or clicks it is booked for. <br /> |
| ### `deliveryForecastSource` | ` https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.DeliveryForecastSource ` Strategy for choosing forecasted traffic shapes to pace line items. This field is optional and defaults to [DeliveryForecastSource.HISTORICAL](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.DeliveryForecastSource#HISTORICAL). *** ** * ** *** **Enumerations** `HISTORICAL` :   The line item's historical traffic shape will be used to pace line item delivery. `FORECASTING` :   The line item's projected future traffic will be used to pace line item delivery. `CUSTOM_PACING_CURVE` :   A user specified custom pacing curve will be used to pace line item delivery. `UNKNOWN` :   The value returned if the actual value is not exposed by the requested API version. <br /> |
| ### `customPacingCurve` | ` https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.CustomPacingCurve ` The curve that is used to pace the line item's delivery. This field is required if and only if the delivery forecast source is [DeliveryForecastSource.CUSTOM_PACING_CURVE](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.DeliveryForecastSource#CUSTOM_PACING_CURVE). |
| ### `roadblockingType` | ` https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.RoadblockingType ` The strategy for serving roadblocked creatives, i.e. instances where multiple creatives must be served together on a single web page. This attribute is optional and defaults to [RoadblockingType.ONE_OR_MORE](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.RoadblockingType#ONE_OR_MORE). *** ** * ** *** **Enumerations** `ONLY_ONE` :   Only one creative from a line item can serve at a time. `ONE_OR_MORE` :   Any number of creatives from a line item can serve together at a time. `AS_MANY_AS_POSSIBLE` :   As many creatives from a line item as can fit on a page will serve. This could mean anywhere from one to all of a line item's creatives given the size constraints of ad slots on a page. `ALL_ROADBLOCK` :   All or none of the creatives from a line item will serve. This option will only work if served to a GPT tag using SRA (single request architecture mode). `CREATIVE_SET` :   A master/companion [CreativeSet](https://developers.google.com/ad-manager/api/reference/v202602/CreativeSetService.CreativeSet) roadblocking type. A [LineItem.creativePlaceholders](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem#creativePlaceholders) must be set accordingly. <br /> |
| ### `skippableAdType` | ` https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.SkippableAdType ` The nature of the line item's creatives' skippability. This attribute is optional, only applicable for video line items, and defaults to [SkippableAdType.NOT_SKIPPABLE](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.SkippableAdType#NOT_SKIPPABLE). *** ** * ** *** **Enumerations** `UNKNOWN` :   The value returned if the actual value is not exposed by the requested API version. `DISABLED` :   Skippable ad type is disabled. `ENABLED` :   Skippable ad type is enabled. `INSTREAM_SELECT` :   Skippable in-stream ad type. `ANY` :   Any skippable or not skippable. This is only for programmatic case when the creative skippability is decided by the buyside. <br /> |
| ### `frequencyCaps` | ` https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.FrequencyCap[]` The set of frequency capping units for this `LineItem`. This attribute is optional. |
| ### `lineItemType` | ` https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItemType ` Indicates the line item type of a `LineItem`. This attribute is required. The line item type determines the default priority of the line item. More information can be found on the [Ad Manager Help Center](https://support.google.com/admanager/answer/177279). *** ** * ** *** **Enumerations** `SPONSORSHIP` :   The type of [LineItem](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem) for which a percentage of all the impressions that are being sold are reserved. `STANDARD` :   The type of [LineItem](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem) for which a fixed quantity of impressions or clicks are reserved. `NETWORK` :   The type of [LineItem](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem) most commonly used to fill a site's unsold inventory if not contractually obligated to deliver a requested number of impressions. Users specify the daily percentage of unsold impressions or clicks when creating this line item. `BULK` :   The type of [LineItem](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem) for which a fixed quantity of impressions or clicks will be delivered at a priority lower than the [LineItemType.STANDARD](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItemType#STANDARD) type. `PRICE_PRIORITY` :   The type of [LineItem](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem) most commonly used to fill a site's unsold inventory if not contractually obligated to deliver a requested number of impressions. Users specify the fixed quantity of unsold impressions or clicks when creating this line item. `HOUSE` :   The type of [LineItem](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem) typically used for ads that promote products and services chosen by the publisher. These usually do not generate revenue and have the lowest delivery priority. `LEGACY_DFP` :   Represents a legacy [LineItem](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem) that has been migrated from the DFP system. Such line items cannot be created any more. Also, these line items cannot be activated or resumed. `CLICK_TRACKING` :   The type of [LineItem](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem) used for ads that track ads being served externally of Ad Manager, for example an email newsletter. The click through would reference this ad, and the click would be tracked via this ad. `ADSENSE` :   A [LineItem](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem) using dynamic allocation backed by AdSense. `AD_EXCHANGE` :   A [LineItem](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem) using dynamic allocation backed by the Google Ad Exchange. `BUMPER` :   Represents a non-monetizable video [LineItem](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem) that targets one or more bumper positions, which are short house video messages used by publishers to separate content from ad breaks. `ADMOB` :   A [LineItem](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem) using dynamic allocation backed by AdMob. `PREFERRED_DEAL` :   The type of [LineItem](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem) for which there are no impressions reserved, and will serve for a second price bid. All [LineItem](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem)s of type [LineItemType.PREFERRED_DEAL](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItemType#PREFERRED_DEAL) should be created via a [ProposalLineItem](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.ProposalLineItem) with a matching type. When creating a [LineItem](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem) of type [LineItemType.PREFERRED_DEAL](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItemType#PREFERRED_DEAL), the [ProposalLineItem.estimatedMinimumImpressions](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.ProposalLineItem#estimatedMinimumImpressions) field is required. `UNKNOWN` :   The value returned if the actual value is not exposed by the requested API version. <br /> |
| ### `priority` | ` xsd:int` The priority for the line item. Valid values range from 1 to 16. This field is optional and defaults to the default priority of the [LineItemType](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItemType). The following table shows the default, minimum, and maximum priority values are for each line item type: | LineItemType - default priority (minimum priority, maximum priority) || |---|---| | [LineItemType.SPONSORSHIP](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItemType#SPONSORSHIP) | 4 (2, 5) | | [LineItemType.STANDARD](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItemType#STANDARD) | 8 (6, 10) | | [LineItemType.NETWORK](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItemType#NETWORK) | 12 (11, 14) | | [LineItemType.BULK](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItemType#BULK) | 12 (11, 14) | | [LineItemType.PRICE_PRIORITY](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItemType#PRICE_PRIORITY) | 12 (11, 14) | | [LineItemType.HOUSE](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItemType#HOUSE) | 16 (15, 16) | | [LineItemType.CLICK_TRACKING](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItemType#CLICK_TRACKING) | 16 (1, 16) | | [LineItemType.AD_EXCHANGE](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItemType#AD_EXCHANGE) | 12 (1, 16) | | [LineItemType.ADSENSE](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItemType#ADSENSE) | 12 (1, 16) | | [LineItemType.BUMPER](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItemType#BUMPER) | 16 (15, 16) | This field can only be edited by certain networks, otherwise a [PermissionError](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.PermissionError) will occur. <br /> |
| ### `costPerUnit` | ` https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.Money ` The amount of money to spend per impression or click. This attribute is required for creating a `LineItem`. |
| ### `valueCostPerUnit` | ` https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.Money ` An amount to help the adserver rank inventory. [LineItem.valueCostPerUnit](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem#valueCostPerUnit) artificially raises the value of inventory over the [LineItem.costPerUnit](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem#costPerUnit) but avoids raising the actual [LineItem.costPerUnit](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem#costPerUnit). This attribute is optional and defaults to a [Money](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.Money) object in the local currency with [Money.microAmount](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.Money#microAmount) 0. |
| ### `costType` | ` https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.CostType ` The method used for billing this `LineItem`. This attribute is required. *** ** * ** *** **Enumerations** `CPA` : Starting February 22, 2024 the CPA [CostType](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.CostType) will be read only as part of Spotlight deprecation, [learn more](https://support.google.com/admanager/answer/7519021#spotlight). Cost per action. The [LineItem.lineItemType](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem#lineItemType) must be one of: - [LineItemType.SPONSORSHIP](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItemType#SPONSORSHIP) - [LineItemType.STANDARD](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItemType#STANDARD) - [LineItemType.BULK](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItemType#BULK) - [LineItemType.NETWORK](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItemType#NETWORK) `CPC` :   Cost per click. The [LineItem.lineItemType](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem#lineItemType) must be one of: - [LineItemType.SPONSORSHIP](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItemType#SPONSORSHIP) - [LineItemType.STANDARD](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItemType#STANDARD) - [LineItemType.BULK](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItemType#BULK) - [LineItemType.NETWORK](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItemType#NETWORK) - [LineItemType.PRICE_PRIORITY](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItemType#PRICE_PRIORITY) - [LineItemType.HOUSE](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItemType#HOUSE) `CPD` : Cost per day. The [LineItem.lineItemType](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem#lineItemType) must be one of: - [LineItemType.SPONSORSHIP](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItemType#SPONSORSHIP) - [LineItemType.NETWORK](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItemType#NETWORK) `CPM` :   Cost per mille (cost per thousand impressions). The [LineItem.lineItemType](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem#lineItemType) must be one of: - [LineItemType.SPONSORSHIP](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItemType#SPONSORSHIP) - [LineItemType.STANDARD](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItemType#STANDARD) - [LineItemType.BULK](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItemType#BULK) - [LineItemType.NETWORK](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItemType#NETWORK) - [LineItemType.PRICE_PRIORITY](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItemType#PRICE_PRIORITY) - [LineItemType.HOUSE](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItemType#HOUSE) `VCPM` :   Cost per thousand Active View viewable impressions. The [LineItem.lineItemType](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem#lineItemType) must be [LineItemType.STANDARD](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItemType#STANDARD). `CPM_IN_TARGET` :   Cost per thousand in-target impressions. The [LineItem.lineItemType](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem#lineItemType) must be [LineItemType.STANDARD](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItemType#STANDARD). `CPCV` :   Cost per completed view. This cost type is only supported for standard reservation video line items. The [LineItem.lineItemType](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem#lineItemType) must be [LineItemType.STANDARD](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItemType#STANDARD) `UNKNOWN` :   The value returned if the actual value is not exposed by the requested API version. <br /> |
| ### `discountType` | ` https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItemDiscountType ` The type of discount being applied to a `LineItem`, either percentage based or absolute. This attribute is optional and defaults to [LineItemDiscountType.PERCENTAGE](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItemDiscountType#PERCENTAGE). *** ** * ** *** **Enumerations** `ABSOLUTE_VALUE` :   An absolute value will be discounted from the line item's cost. `PERCENTAGE` :   A percentage of the cost will be applied as discount for booking the line item. <br /> |
| ### `discount` | ` xsd:double` The number here is either a percentage or an absolute value depending on the `LineItemDiscountType`. If the `LineItemDiscountType` is [LineItemDiscountType.PERCENTAGE](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItemDiscountType#PERCENTAGE), then only non-fractional values are supported. |
| ### `contractedUnitsBought` | ` xsd:long` This attribute is only applicable for certain [line item types](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem#lineItemType) and acts as an "FYI" or note, which does not impact adserving or other backend systems. For [LineItemType.SPONSORSHIP](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItemType#SPONSORSHIP) line items, this represents the minimum quantity, which is a lifetime impression volume goal for reporting purposes only. For [LineItemType.STANDARD](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItemType#STANDARD) line items, this represent the contracted quantity, which is the number of units specified in the contract the advertiser has bought for this `LineItem`. This field is just a "FYI" for traffickers to manually intervene with the `LineItem` when needed. This attribute is only available for [LineItemType.STANDARD](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItemType#STANDARD) line items if you have this feature enabled on your network. <br /> |
| ### `creativePlaceholders` | ` https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.CreativePlaceholder[]` Details about the creatives that are expected to serve through this `LineItem`. This attribute is required and replaces the `creativeSizes` attribute. |
| ### `activityAssociations` | ` https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItemActivityAssociation[]` This attribute is required and meaningful only if the [LineItem.costType](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem#costType) is `CostType.CPA`. |
| ### `environmentType` | ` https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.EnvironmentType ` The environment that the `LineItem` is targeting. The default value is [EnvironmentType.BROWSER](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.EnvironmentType#BROWSER). If this value is [EnvironmentType.VIDEO_PLAYER](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.EnvironmentType#VIDEO_PLAYER), then this line item can only target `AdUnits` that have `AdUnitSizes` whose `environmentType` is also `VIDEO_PLAYER`. *** ** * ** *** **Enumerations** `BROWSER` :   A regular web browser. `VIDEO_PLAYER` :   Video players. <br /> |
| ### `allowedFormats` | ` https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.AllowedFormats[]` The set of `allowedFormats` that this programmatic line item can have. If the set is empty, this line item allows all formats. *** ** * ** *** **Enumerations** `AUDIO` :   Audio format. This is only relevant for programmatic video line items. `UNKNOWN` :   The value returned if the actual value is not exposed by the requested API version. <br /> |
| ### `companionDeliveryOption` | ` https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.CompanionDeliveryOption ` The delivery option for companions. Setting this field is only meaningful if the following conditions are met: 1. The **Guaranteed roadblocks** feature is enabled on your network. 2. One of the following is true (both cannot be true, these are mutually exclusive). - The [environmentType](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem#environmentType) is [EnvironmentType.VIDEO_PLAYER](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.EnvironmentType#VIDEO_PLAYER). - The [roadblockingType](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem#roadblockingType) is [RoadblockingType.CREATIVE_SET](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.RoadblockingType#CREATIVE_SET). This field is optional and defaults to [CompanionDeliveryOption.OPTIONAL](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.CompanionDeliveryOption#OPTIONAL) if the above conditions are met. In all other cases it defaults to [CompanionDeliveryOption.UNKNOWN](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.CompanionDeliveryOption#UNKNOWN) and is not meaningful. *** ** * ** *** **Enumerations** `OPTIONAL` :   Companions are not required to serve a creative set. The creative set can serve to inventory that has zero or more matching companions. `AT_LEAST_ONE` :   At least one companion must be served in order for the creative set to be used. `ALL` :   All companions in the set must be served in order for the creative set to be used. This can still serve to inventory that has more companions than can be filled. `UNKNOWN` :   The delivery type is unknown. <br /> |
| ### `allowOverbook` | ` xsd:boolean` The flag indicates whether overbooking should be allowed when creating or updating reservations of line item types [LineItemType.SPONSORSHIP](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItemType#SPONSORSHIP) and [LineItemType.STANDARD](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItemType#STANDARD). When true, operations on this line item will never trigger a [ForecastError](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.ForecastError), which corresponds to an overbook warning in the UI. The default value is false. Note: this field will not persist on the line item itself, and the value will only affect the current request. <br /> |
| ### `skipInventoryCheck` | ` xsd:boolean` The flag indicates whether the inventory check should be skipped when creating or updating a line item. The default value is false. Note: this field will not persist on the line item itself, and the value will only affect the current request. <br /> |
| ### `skipCrossSellingRuleWarningChecks` | ` xsd:boolean` True to skip checks for warnings from rules applied to line items targeting inventory shared by a distributor partner for cross selling when performing an action on this line item. The default is false. |
| ### `reserveAtCreation` | ` xsd:boolean` The flag indicates whether inventory should be reserved when creating a line item of types [LineItemType.SPONSORSHIP](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItemType#SPONSORSHIP) and [LineItemType.STANDARD](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItemType#STANDARD) in an unapproved [Order](https://developers.google.com/ad-manager/api/reference/v202602/OrderService.Order). The default value is false. |
| ### `stats` | ` https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.Stats ` Contains trafficking statistics for the line item. This attribute is readonly and is populated by Google. This will be `null` in case there are no statistics for a line item yet. |
| ### `deliveryIndicator` | ` https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.DeliveryIndicator ` Indicates how well the line item has been performing. This attribute is readonly and is populated by Google. This will be `null` if the delivery indicator information is not available due to one of the following reasons: 1. The line item is not delivering. 2. The line item has an unlimited goal or cap. 3. The line item has a percentage based goal or cap. <br /> |
| ### `deliveryData` | ` https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.DeliveryData ` Delivery data provides the number of clicks or impressions delivered for a [LineItem](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem) in the last 7 days. This attribute is readonly and is populated by Google. This will be `null` if the delivery data cannot be computed due to one of the following reasons: 1. The line item is not deliverable. 2. The line item has completed delivering more than 7 days ago. 3. The line item has an absolute-based goal. [LineItem.deliveryIndicator](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem#deliveryIndicator) should be used to track its progress in this case. <br /> |
| ### `budget` | ` https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.Money ` The amount of money allocated to the `LineItem`. This attribute is readonly and is populated by Google. The currency code is readonly. |
| ### `status` | ` https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.ComputedStatus ` The status of the `LineItem`. This attribute is readonly. *** ** * ** *** **Enumerations** `DELIVERY_EXTENDED` :   The [LineItem](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem) has past its [LineItem.endDateTime](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem#endDateTime) with an auto extension, but hasn't met its goal. `DELIVERING` :   The [LineItem](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem) has begun serving. `READY` :   The [LineItem](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem) has been activated and is ready to serve. `PAUSED` :   The [LineItem](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem) has been paused from serving. `INACTIVE` :   The [LineItem](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem) is inactive. It is either caused by missing creatives or the network disabling auto-activation. `PAUSED_INVENTORY_RELEASED` :   The [LineItem](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem) has been paused and its reserved inventory has been released. The `LineItem` will not serve. `PENDING_APPROVAL` :   The [LineItem](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem) has been submitted for approval. `COMPLETED` :   The [LineItem](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem) has completed its run. `DISAPPROVED` :   The [LineItem](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem) has been disapproved and is not eligible to serve. `DRAFT` :   The [LineItem](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem) is still being drafted. `CANCELED` :   The [LineItem](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem) has been canceled and is no longer eligible to serve. This is a legacy status imported from Google Ad Manager orders. <br /> |
| ### `reservationStatus` | ` https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItemSummary.ReservationStatus ` Describes whether or not inventory has been reserved for the `LineItem`. This attribute is readonly and is assigned by Google. *** ** * ** *** **Enumerations** `RESERVED` :   Indicates that inventory has been reserved for the line item. `UNRESERVED` :   Indicates that inventory has not been reserved for the line item. <br /> |
| ### `isArchived` | ` xsd:boolean` The archival status of the `LineItem`. This attribute is readonly. |
| ### `webPropertyCode` | ` xsd:string` The web property code used for dynamic allocation line items. This web property is only required with line item types [LineItemType.AD_EXCHANGE](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItemType#AD_EXCHANGE) and [LineItemType.ADSENSE](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItemType#ADSENSE). |
| ### `appliedLabels` | ` https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.AppliedLabel[]` The set of labels applied directly to this line item. |
| ### `effectiveAppliedLabels` | ` https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.AppliedLabel[]` Contains the set of labels inherited from the order that contains this line item and the advertiser that owns the order. If a label has been negated, only the negated label is returned. This field is readonly and is assigned by Google. |
| ### `disableSameAdvertiserCompetitiveExclusion` | ` xsd:boolean` If a line item has a series of competitive exclusions on it, it could be blocked from serving with line items from the same advertiser. Setting this to `true` will allow line items from the same advertiser to serve regardless of the other competitive exclusion labels being applied. |
| ### `lastModifiedByApp` | ` xsd:string` The application that last modified this line item. This attribute is read only and is assigned by Google. |
| ### `notes` | ` xsd:string` Provides any additional notes that may annotate the `LineItem`. This attribute is optional and has a maximum length of 65,535 characters. |
| ### `competitiveConstraintScope` | ` https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.CompetitiveConstraintScope ` The `CompetitiveConstraintScope` for the competitive exclusion labels assigned to this line item. This field is optional, defaults to [CompetitiveConstraintScope.POD](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.CompetitiveConstraintScope#POD), and only applies to video line items. *** ** * ** *** **Enumerations** `POD` :   The competitive exclusion label applies to all line items within a single pod (or group). `STREAM` :   The competitive exclusion label applies to all line items within the entire stream of content. `UNKNOWN` :   The value returned if the actual value is not exposed by the requested API version. <br /> |
| ### `lastModifiedDateTime` | ` https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.DateTime ` The date and time this line item was last modified. This attribute is read only. |
| ### `creationDateTime` | ` https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.DateTime ` This attribute may be `null` for line items created before this feature was introduced. |
| ### `customFieldValues` | 1. ` https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.BaseCustomFieldValue[]` 1. ` https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.CustomFieldValue ` 2. ` https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.DropDownCustomFieldValue ` <br /> The values of the custom fields associated with this line item. |
| ### `isMissingCreatives` | ` xsd:boolean` Indicates if a `LineItem` is missing any [creatives](https://developers.google.com/ad-manager/api/reference/v202602/CreativeService.Creative) for the `creativePlaceholders` specified. [Creatives](https://developers.google.com/ad-manager/api/reference/v202602/CreativeService.Creative) can be considered missing for several reasons including: - Not enough [creatives](https://developers.google.com/ad-manager/api/reference/v202602/CreativeService.Creative) of a certain size have been uploaded, as determined by [CreativePlaceholder.expectedCreativeCount](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.CreativePlaceholder#expectedCreativeCount). For example a `LineItem` specifies 750x350, 400x200 but only a 750x350 was uploaded. Or `LineItem` specifies 750x350 with an expected count of 2, but only one was uploaded. - The [Creative.appliedLabels](https://developers.google.com/ad-manager/api/reference/v202602/CreativeService.Creative#appliedLabels) of an associated `Creative` do not match the [CreativePlaceholder.effectiveAppliedLabels](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.CreativePlaceholder#effectiveAppliedLabels) of the `LineItem`. For example `LineItem` specifies 750x350 with a Foo `AppliedLabel` but a 750x350 creative without a `AppliedLabel` was uploaded. <br /> |
| ### `programmaticCreativeSource` | ` https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.ProgrammaticCreativeSource ` Indicates the [ProgrammaticCreativeSource](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.ProgrammaticCreativeSource) of the programmatic line item. This is a read-only field. Any changes must be made on the [ProposalLineItem](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.ProposalLineItem). *** ** * ** *** **Enumerations** `PUBLISHER` :   Indicates that the programmatic line item is associated with creatives provided by the publisher. `ADVERTISER` :   Indicates that the programmatic line item is associated with creatives provided by the advertiser. `UNKNOWN` :   The value returned if the actual value is not exposed by the requested API version. <br /> |
| ### `thirdPartyMeasurementSettings` | ` https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.ThirdPartyMeasurementSettings ` <br /> |
| ### `youtubeKidsRestricted` | ` xsd:boolean` Designates this line item as intended for YT Kids app. If true, all creatives associated with this line item must be reviewed and approved. See the [Ad Manager Help Center](https://support.google.com/yt-partner-sales/answer/10015534) for more information. |
| ### `videoMaxDuration` | ` xsd:long` The max duration of a video creative associated with this `LineItem` in milliseconds. This attribute is only meaningful for video line items. For version v202011 and earlier, this attribute is optional and defaults to 0. For version v202102 and later, this attribute is required for video line items and must be greater than 0. <br /> |
| ### `primaryGoal` | ` https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.Goal ` The primary goal that this `LineItem` is associated with, which is used in its pacing and budgeting. |
| ### `secondaryGoals` | ` https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.Goal[]` The secondary goals that this `LineItem` is associated with. It is required and meaningful only if the [LineItem.costType](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem#costType) is `CostType.CPA` or if the [LineItem.lineItemType](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem#lineItemType) is [LineItemType.SPONSORSHIP](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItemType#SPONSORSHIP) and [LineItem.costType](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem#costType) is `CostType.CPM`. |
| ### `grpSettings` | ` https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.GrpSettings ` Contains the information for a line item which has a target GRP demographic. |
| ### `dealInfo` | ` https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItemDealInfoDto ` The deal information associated with this line item, if it is programmatic. |
| ### `viewabilityProviderCompanyIds` | ` xsd:long[]` Optional IDs of the [Company](https://developers.google.com/ad-manager/api/reference/v202602/CompanyService.Company) that provide ad verification for this line item. [Company.Type.VIEWABILITY_PROVIDER](https://developers.google.com/ad-manager/api/reference/v202602/CompanyService.Company.Type#VIEWABILITY_PROVIDER). |
| ### `childContentEligibility` | ` https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.ChildContentEligibility ` Child content eligibility designation for this line item. This field is optional and defaults to [ChildContentEligibility.DISALLOWED](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.ChildContentEligibility#DISALLOWED). *** ** * ** *** **Enumerations** `UNKNOWN` : `DISALLOWED` :   This line item is not eligible to serve on any requests that are child-directed. `ALLOWED` :   This line item is eligible to serve on requests that are child-directed. <br /> |
| ### `customVastExtension` | ` xsd:string` Custom XML to be rendered in a custom VAST response at serving time. |
| ### `repeatedCreativeServingEnabled` | ` xsd:boolean` Indicates whether repeated creative serving is enabled for this line item. |
| ### `deliveryAllocationProfileId` | ` xsd:long` The `AllocationDeliveryProfile` ID for this line item. |
| **`LineItem`** ||
| ### `targeting` | ` https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.Targeting ` Contains the targeting criteria for the ad campaign. This attribute is required. |
| ### `creativeTargetings` | ` https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.CreativeTargeting[]` A list of [CreativeTargeting](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.CreativeTargeting) objects that can be used to specify creative level targeting for this line item. Creative level targeting is specified in a creative placeholder's [CreativePlaceholder.targetingName](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.CreativePlaceholder#targetingName) field by referencing the creative targeting's [name](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.CreativeTargeting#name). It also needs to be re-specified in the [LineItemCreativeAssociation.targetingName](https://developers.google.com/ad-manager/api/reference/v202602/LineItemCreativeAssociationService.LineItemCreativeAssociation#targetingName) field when associating a line item with a creative that fits into that placeholder. |