# REST Resource: advertisers.lineItems

> [!WARNING]
> Display \& Video 360 API v1 has been sunset.

- [Resource: LineItem](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#LineItem)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#LineItem.SCHEMA_REPRESENTATION)
- [LineItemType](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#LineItemType)
- [LineItemFlight](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#LineItemFlight)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#LineItemFlight.SCHEMA_REPRESENTATION)
- [LineItemFlightDateType](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#LineItemFlightDateType)
- [LineItemBudget](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#LineItemBudget)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#LineItemBudget.SCHEMA_REPRESENTATION)
- [LineItemBudgetAllocationType](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#LineItemBudgetAllocationType)
- [PartnerRevenueModel](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#PartnerRevenueModel)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#PartnerRevenueModel.SCHEMA_REPRESENTATION)
- [PartnerRevenueModelMarkupType](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#PartnerRevenueModelMarkupType)
- [ConversionCountingConfig](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#ConversionCountingConfig)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#ConversionCountingConfig.SCHEMA_REPRESENTATION)
- [TrackingFloodlightActivityConfig](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#TrackingFloodlightActivityConfig)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#TrackingFloodlightActivityConfig.SCHEMA_REPRESENTATION)
- [TargetingExpansionConfig](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#TargetingExpansionConfig)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#TargetingExpansionConfig.SCHEMA_REPRESENTATION)
- [TargetingExpansionLevel](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#TargetingExpansionLevel)
- [LineItemWarningMessage](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#LineItemWarningMessage)
- [MobileApp](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#MobileApp)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#MobileApp.SCHEMA_REPRESENTATION)
- [Platform](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#Platform)
- [Methods](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#METHODS_SUMMARY)

## Resource: LineItem

A single line item.

| JSON representation |
|---|
| ``` { "name": string, "advertiserId": string, "campaignId": string, "insertionOrderId": string, "lineItemId": string, "displayName": string, "lineItemType": enum (`https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#LineItemType`), "entityStatus": enum (`https://developers.google.com/display-video/api/reference/rest/v1/EntityStatus`), "updateTime": string, "partnerCosts": [ { object (`https://developers.google.com/display-video/api/reference/rest/v1/PartnerCost`) } ], "flight": { object (`https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#LineItemFlight`) }, "budget": { object (`https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#LineItemBudget`) }, "pacing": { object (`https://developers.google.com/display-video/api/reference/rest/v1/Pacing`) }, "frequencyCap": { object (`https://developers.google.com/display-video/api/reference/rest/v1/FrequencyCap`) }, "partnerRevenueModel": { object (`https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#PartnerRevenueModel`) }, "conversionCounting": { object (`https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#ConversionCountingConfig`) }, "creativeIds": [ string ], "bidStrategy": { object (`https://developers.google.com/display-video/api/reference/rest/v1/BiddingStrategy`) }, "integrationDetails": { object (`https://developers.google.com/display-video/api/reference/rest/v1/IntegrationDetails`) }, "inventorySourceIds": [ string ], "targetingExpansion": { object (`https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#TargetingExpansionConfig`) }, "warningMessages": [ enum (`https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#LineItemWarningMessage`) ], "mobileApp": { object (`https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#MobileApp`) }, "reservationType": enum (`https://developers.google.com/display-video/api/reference/rest/v1/ReservationType`), "excludeNewExchanges": boolean } ``` |

| Fields ||
|---|---|
| `name` | `string` Output only. The resource name of the line item. |
| `advertiserId` | `string (https://developers.google.com/discovery/v1/type-format format)` Output only. The unique ID of the advertiser the line item belongs to. |
| `campaignId` | `string (https://developers.google.com/discovery/v1/type-format format)` Output only. The unique ID of the campaign that the line item belongs to. |
| `insertionOrderId` | `string (https://developers.google.com/discovery/v1/type-format format)` Required. Immutable. The unique ID of the insertion order that the line item belongs to. |
| `lineItemId` | `string (https://developers.google.com/discovery/v1/type-format format)` Output only. The unique ID of the line item. Assigned by the system. |
| `displayName` | `string` Required. The display name of the line item. Must be UTF-8 encoded with a maximum size of 240 bytes. |
| `lineItemType` | ``enum (`https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#LineItemType`)`` Required. Immutable. The type of the line item. |
| `entityStatus` | ``enum (`https://developers.google.com/display-video/api/reference/rest/v1/EntityStatus`)`` Required. Controls whether or not the line item can spend its budget and bid on inventory. - For `https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems/create#google.ads.displayvideo.v1.LineItemService.CreateLineItem` method, only `ENTITY_STATUS_DRAFT` is allowed. To activate a line item, use `https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems/patch#google.ads.displayvideo.v1.LineItemService.UpdateLineItem` method and update the status to `ENTITY_STATUS_ACTIVE` after creation. - A line item cannot be changed back to `ENTITY_STATUS_DRAFT` status from any other status. - If the line item's parent insertion order is not active, the line item can't spend its budget even if its own status is `ENTITY_STATUS_ACTIVE`. |
| `updateTime` | ``string (`https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Timestamp` format)`` Output only. The timestamp when the line item was last updated. Assigned by the system. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: `"2014-10-02T15:01:23Z"` and `"2014-10-02T15:01:23.045123456Z"`. |
| `partnerCosts[]` | ``object (`https://developers.google.com/display-video/api/reference/rest/v1/PartnerCost`)`` The partner costs associated with the line item. If absent or empty in `https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems/create#google.ads.displayvideo.v1.LineItemService.CreateLineItem` method, the newly created line item will inherit partner costs from its parent insertion order. |
| `flight` | ``object (`https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#LineItemFlight`)`` Required. The start and end time of the line item's flight. |
| `budget` | ``object (`https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#LineItemBudget`)`` Required. The budget allocation setting of the line item. |
| `pacing` | ``object (`https://developers.google.com/display-video/api/reference/rest/v1/Pacing`)`` Required. The budget spending speed setting of the line item. |
| `frequencyCap` | ``object (`https://developers.google.com/display-video/api/reference/rest/v1/FrequencyCap`)`` Required. The impression frequency cap settings of the line item. The `https://developers.google.com/display-video/api/reference/rest/v1/FrequencyCap#FIELDS.max_impressions` field in this settings object must be used if assigning a limited cap. |
| `partnerRevenueModel` | ``object (`https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#PartnerRevenueModel`)`` Required. The partner revenue model setting of the line item. |
| `conversionCounting` | ``object (`https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#ConversionCountingConfig`)`` The conversion tracking setting of the line item. |
| `creativeIds[]` | `string (https://developers.google.com/discovery/v1/type-format format)` The IDs of the creatives associated with the line item. |
| `bidStrategy` | ``object (`https://developers.google.com/display-video/api/reference/rest/v1/BiddingStrategy`)`` Required. The bidding strategy of the line item. |
| `integrationDetails` | ``object (`https://developers.google.com/display-video/api/reference/rest/v1/IntegrationDetails`)`` Integration details of the line item. |
| `inventorySourceIds[]` | `string (https://developers.google.com/discovery/v1/type-format format)` The IDs of the private inventory sources assigned to the line item. |
| `targetingExpansion` | ``object (`https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#TargetingExpansionConfig`)`` The [optimized targeting](https://support.google.com/displayvideo/answer/12060859) settings of the line item. This config is only applicable for display, video, or audio line items that use automated bidding and positively target eligible audience lists. |
| `warningMessages[]` | ``enum (`https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#LineItemWarningMessage`)`` Output only. The warning messages generated by the line item. These warnings do not block saving the line item, but some may block the line item from running. |
| `mobileApp` | ``object (`https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#MobileApp`)`` The mobile app promoted by the line item. This is applicable only when `https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#LineItem.FIELDS.line_item_type` is either `LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL` or `LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL`. |
| `reservationType` | ``enum (`https://developers.google.com/display-video/api/reference/rest/v1/ReservationType`)`` Output only. The reservation type of the line item. |
| `excludeNewExchanges` | `boolean` Whether to exclude new exchanges from automatically being targeted by the line item. This field is false by default. |

## LineItemType

Possible types of a line item.

The type of the line item determines which settings and options are applicable, such as the format of the ads or targeting options.

| Enums ||
|---|---|
| `LINE_ITEM_TYPE_UNSPECIFIED` | Type value is not specified or is unknown in this version. Line items of this type and their targeting cannot be created or updated using the API. |
| `LINE_ITEM_TYPE_DISPLAY_DEFAULT` | Image, HTML5, native, or rich media ads. |
| `LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL` | Display ads that drive installs of an app. |
| `LINE_ITEM_TYPE_VIDEO_DEFAULT` | Video ads sold on a CPM basis for a variety of environments. |
| `LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL` | Video ads that drive installs of an app. |
| `LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INVENTORY` | Display ads served on mobile app inventory. Line items of this type and their targeting cannot be created or updated using the API. |
| `LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INVENTORY` | Video ads served on mobile app inventory. Line items of this type and their targeting cannot be created or updated using the API. |
| `LINE_ITEM_TYPE_AUDIO_DEFAULT` | RTB Audio ads sold for a variety of environments. |
| `LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP` | Over-the-top ads present in OTT insertion orders. This type is only applicable to line items with an insertion order of `https://developers.google.com/display-video/api/reference/rest/v1/advertisers.insertionOrders#InsertionOrder.FIELDS.insertion_order_type` `OVER_THE_TOP`. |

## LineItemFlight

Settings that control the active duration of a line item.

| JSON representation |
|---|
| ``` { "flightDateType": enum (`https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#LineItemFlightDateType`), "dateRange": { object (`https://developers.google.com/display-video/api/reference/rest/v1/DateRange`) }, "triggerId": string } ``` |

| Fields ||
|---|---|
| `flightDateType` | ``enum (`https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#LineItemFlightDateType`)`` Required. The type of the line item's flight dates. |
| `dateRange` | ``object (`https://developers.google.com/display-video/api/reference/rest/v1/DateRange`)`` The flight start and end dates of the line item. They are resolved relative to the parent advertiser's time zone. - Required when `https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#LineItemFlight.FIELDS.flight_date_type` is `LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM`. Output only otherwise. - When creating a new flight, both `startDate` and `endDate` must be in the future. - An existing flight with a `startDate` in the past has a mutable `endDate` but an immutable `startDate`. - `endDate` must be the `startDate` or later, both before the year 2037. |
| `triggerId` | `string (https://developers.google.com/discovery/v1/type-format format)` The ID of the manual trigger associated with the line item. - Required when `https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#LineItemFlight.FIELDS.flight_date_type` is `LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER`. Must not be set otherwise. - When set, the line item's flight dates are inherited from its parent insertion order. - Active line items will spend when the selected trigger is activated within the parent insertion order's flight dates. **Warning:** Line Items using manual triggers no longer serve in Display \& Video 360. This field will sunset on August 1, 2023. Read our [feature deprecation announcement](https://developers.google.com/display-video/api/deprecations#features.manual_triggers) for more information. |

## LineItemFlightDateType

Possible types of a line item's flight dates.

| Enums ||
|---|---|
| `LINE_ITEM_FLIGHT_DATE_TYPE_UNSPECIFIED` | Type value is not specified or is unknown in this version. |
| `LINE_ITEM_FLIGHT_DATE_TYPE_INHERITED` | The line item's flight dates are inherited from its parent insertion order. |
| `LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM` | The line item uses its own custom flight dates. |
| `LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER` | The line item uses a trigger. **Warning:** Line Items using manual triggers no longer serve in Display \& Video 360. This value will sunset on August 1, 2023. Read our [feature deprecation announcement](https://developers.google.com/display-video/api/deprecations#features.manual_triggers) for more information. |

## LineItemBudget

Settings that control how budget is allocated.

| JSON representation |
|---|
| ``` { "budgetAllocationType": enum (`https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#LineItemBudgetAllocationType`), "budgetUnit": enum (`https://developers.google.com/display-video/api/reference/rest/v1/BudgetUnit`), "maxAmount": string } ``` |

| Fields ||
|---|---|
| `budgetAllocationType` | ``enum (`https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#LineItemBudgetAllocationType`)`` Required. The type of the budget allocation. `LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC` is only applicable when automatic budget allocation is enabled for the parent insertion order. |
| `budgetUnit` | ``enum (`https://developers.google.com/display-video/api/reference/rest/v1/BudgetUnit`)`` Output only. The budget unit specifies whether the budget is currency based or impression based. This value is inherited from the parent insertion order. |
| `maxAmount` | `string (https://developers.google.com/discovery/v1/type-format format)` The maximum budget amount the line item will spend. Must be greater than 0. When `https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#LineItemBudget.FIELDS.budget_allocation_type` is: - `LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC`, this field is immutable and is set by the system. - `LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED`, if `https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#LineItemBudget.FIELDS.budget_unit` is: - `BUDGET_UNIT_CURRENCY`, this field represents maximum budget amount to spend, in micros of the advertiser's currency. For example, 1500000 represents 1.5 standard units of the currency. - `BUDGET_UNIT_IMPRESSIONS`, this field represents the maximum number of impressions to serve. - `LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED`, this field is not applicable and will be ignored by the system. |

## LineItemBudgetAllocationType

Possible types of the budget allocation.

| Enums ||
|---|---|
| `LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNSPECIFIED` | Type value is not specified or is unknown in this version. |
| `LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC` | Automatic budget allocation is enabled for the line item. |
| `LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED` | A fixed max budget amount is allocated for the line item. |
| `LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED` | No budget limit is applied to the line item. |

## PartnerRevenueModel

Settings that control how partner revenue is calculated.

| JSON representation |
|---|
| ``` { "markupType": enum (`https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#PartnerRevenueModelMarkupType`), "markupAmount": string } ``` |

| Fields ||
|---|---|
| `markupType` | ``enum (`https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#PartnerRevenueModelMarkupType`)`` Required. The markup type of the partner revenue model. |
| `markupAmount` | `string (https://developers.google.com/discovery/v1/type-format format)` Required. The markup amount of the partner revenue model. Must be greater than or equal to 0. - When the `https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#PartnerRevenueModel.FIELDS.markup_type` is set to be `PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM`, this field represents the CPM markup in micros of advertiser's currency. For example, 1500000 represents 1.5 standard units of the currency. - When the `https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#PartnerRevenueModel.FIELDS.markup_type` is set to be `PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP`, this field represents the media cost percent markup in millis. For example, 100 represents 0.1% (decimal 0.001). - When the `https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#PartnerRevenueModel.FIELDS.markup_type` is set to be `PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP`, this field represents the total media cost percent markup in millis. For example, 100 represents 0.1% (decimal 0.001). |

## PartnerRevenueModelMarkupType

Possible markup types of the partner revenue model.

| Enums ||
|---|---|
| `PARTNER_REVENUE_MODEL_MARKUP_TYPE_UNSPECIFIED` | Type value is not specified or is unknown in this version. |
| `PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM` | Calculate the partner revenue based on a fixed CPM. |
| `PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP` | Calculate the partner revenue based on a percentage surcharge of its media cost. > [!WARNING] > Can no longer be assigned to new or existing line items, use `PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP` instead. |
| `PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP` | Calculate the partner revenue based on a percentage surcharge of its total media cost, which includes all partner costs and data costs. |

## ConversionCountingConfig

Settings that control how conversions are counted.

All post-click conversions will be counted. A percentage value can be set for post-view conversions counting.

| JSON representation |
|---|
| ``` { "postViewCountPercentageMillis": string, "floodlightActivityConfigs": [ { object (`https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#TrackingFloodlightActivityConfig`) } ] } ``` |

| Fields ||
|---|---|
| `postViewCountPercentageMillis` | `string (https://developers.google.com/discovery/v1/type-format format)` The percentage of post-view conversions to count, in millis (1/1000 of a percent). Must be between 0 and 100000 inclusive. For example, to track 50% of the post-click conversions, set a value of 50000. |
| `floodlightActivityConfigs[]` | ``object (`https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#TrackingFloodlightActivityConfig`)`` The Floodlight activity configs used to track conversions. The number of conversions counted is the sum of all of the conversions counted by all of the Floodlight activity IDs specified in this field. |

## TrackingFloodlightActivityConfig

Settings that control the behavior of a single Floodlight activity config.

| JSON representation |
|---|
| ``` { "floodlightActivityId": string, "postClickLookbackWindowDays": integer, "postViewLookbackWindowDays": integer } ``` |

| Fields ||
|---|---|
| `floodlightActivityId` | `string (https://developers.google.com/discovery/v1/type-format format)` Required. The ID of the Floodlight activity. |
| `postClickLookbackWindowDays` | `integer` Required. The number of days after an ad has been clicked in which a conversion may be counted. Must be between 0 and 90 inclusive. |
| `postViewLookbackWindowDays` | `integer` Required. The number of days after an ad has been viewed in which a conversion may be counted. Must be between 0 and 90 inclusive. |

## TargetingExpansionConfig

Settings that control the [optimized targeting](https://support.google.com/displayvideo/answer/12060859) settings of the line item.

| JSON representation |
|---|
| ``` { "targetingExpansionLevel": enum (`https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#TargetingExpansionLevel`), "excludeFirstPartyAudience": boolean } ``` |

| Fields ||
|---|---|
| `targetingExpansionLevel` | ``enum (`https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#TargetingExpansionLevel`)`` Required. Whether optimized targeting is turned on. This field supports the following values: - `NO_EXPANSION`: optimized targeting is turned off - `LEAST_EXPANSION`: optimized targeting is turned on If this field is set to any other value, it will automatically be set to `LEAST_EXPANSION`. `NO_EXPANSION` will be the default value for the field and will be automatically assigned if you do not set the field. |
| `excludeFirstPartyAudience (deprecated)` | `boolean` > [!WARNING] > This item is deprecated! Whether to exclude first-party audiences from use in targeting expansion. This field was deprecated with the launch of [optimized targeting](https://support.google.com/displayvideo/answer/12060859). This field will be set to `false`. If this field is set to `true` when deprecated, all positive first-party audience targeting assigned to this line item will be replaced with negative targeting of the same first-party audiences to ensure the continued exclusion of those audiences. |

## TargetingExpansionLevel

The Optimized targeting setting.

| Enums ||
|---|---|
| `TARGETING_EXPANSION_LEVEL_UNSPECIFIED` | The optimized targeting setting is not specified or is unknown in this version. |
| `NO_EXPANSION` | Optimized targeting is off. |
| `LEAST_EXPANSION` | Optimized targeting is on. |
| `SOME_EXPANSION` | If used, will automatically be set to `LEAST_EXPANSION`. > [!WARNING] > This item is deprecated! |
| `BALANCED_EXPANSION` | If used, will automatically be set to `LEAST_EXPANSION`. > [!WARNING] > This item is deprecated! |
| `MORE_EXPANSION` | If used, will automatically be set to `LEAST_EXPANSION`. > [!WARNING] > This item is deprecated! |
| `MOST_EXPANSION` | If used, will automatically be set to `LEAST_EXPANSION`. > [!WARNING] > This item is deprecated! |

## LineItemWarningMessage

The warning messages generated by a line item. These types of warnings do not block saving a line item, but may block a line item from running.

| Enums ||
|---|---|
| `LINE_ITEM_WARNING_MESSAGE_UNSPECIFIED` | Not specified or is unknown. |
| `INVALID_FLIGHT_DATES` | This line item has invalid flight dates. The line item will not run. |
| `EXPIRED` | This line item's end date is in the past. |
| `PENDING_FLIGHT` | This line item will begin running in the future. |
| `ALL_PARTNER_ENABLED_EXCHANGES_NEGATIVELY_TARGETED` | All partner enabled exchanges are negatively targeted. The line item will not run. |
| `INVALID_INVENTORY_SOURCE` | No active inventory sources are being targeted. The line item will not run. |
| `APP_INVENTORY_INVALID_SITE_TARGETING` | This line item's Apps \& URLs targeting doesn't include any mobile apps. This line item's type requires you to include mobile apps in your channel, sitelist, or apps targeting. The line item will not run. |
| `APP_INVENTORY_INVALID_AUDIENCE_LISTS` | This line item isn't targeting any mobile users. This line item's type requires you to target a user list with mobile users. The line item will not run. |
| `NO_VALID_CREATIVE` | This line item does not contain any valid creative. The line item will not run. |
| `PARENT_INSERTION_ORDER_PAUSED` | The insertion order of this line item is paused. The line item will not run. |
| `PARENT_INSERTION_ORDER_EXPIRED` | The insertion order of this line item has its end date set in the past. The line item will not run. |
| `NO_POSITIVE_AUDIENCE_LIST_TARGETED` | This line item does not target any audience lists, which may result in spending your budget too quickly. |
| `APP_INSTALL_NO_CONVERSION_PIXEL` | This app install line item does not have any conversion pixel set up. |
| `TARGETING_REVOKED_OR_CLOSED_USER_LIST` | This line item targets one or more user lists that are no longer available. In the future, this will prevent the line item from serving, so consider removing these lists from your targeting. |
| `APP_INSTALL_NO_OPTIMAL_BIDDING_STRATEGY` | This app install line item does not have an optimal bidding strategy. |
| `CREATIVE_SIZE_NOT_IN_USE_FOR_TARGETED_DEALS` | Deals targeted by this line item accept creative sizes which are not in use. This may limit the line item's delivery or performance. |
| `NO_CREATIVE_FOR_TARGETED_DEALS` | This line item does not contain any creative for the targeted deals. |
| `TARGETING_DEPRECATED_GEO_TARGET` | This line item targets a geo target that is deprecated. |
| `DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION` | This line item uses the `https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#TargetingExpansionConfig.FIELDS.exclude_first_party_audience` setting, which is deprecated and scheduled to sunset after **March 25, 2023**. Update your API integration to directly exclude any first-party audiences using audience targeting before **March 25, 2023** to account for the sunset of the `https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#TargetingExpansionConfig.FIELDS.exclude_first_party_audience` field. |

## MobileApp

A mobile app promoted by a mobile app install line item.

| JSON representation |
|---|
| ``` { "appId": string, "platform": enum (`https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#Platform`), "displayName": string, "publisher": string } ``` |

| Fields ||
|---|---|
| `appId` | `string` Required. The ID of the app provided by the platform store. Android apps are identified by the bundle ID used by Android's Play store, such as `com.google.android.gm`. iOS apps are identified by a nine-digit app ID used by Apple's App store, such as `422689480`. |
| `platform` | ``enum (`https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#Platform`)`` Output only. The app platform. |
| `displayName` | `string` Output only. The app name. |
| `publisher` | `string` Output only. The app publisher. |

## Platform

Possible mobile app platforms.

| Enums ||
|---|---|
| `PLATFORM_UNSPECIFIED` | Platform is not specified. |
| `IOS` | iOS platform. |
| `ANDROID` | Android platform. |

| ## Methods ||
|---|---|
| ### `https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems/bulkEditLineItemAssignedTargetingOptions` | Bulk edits targeting options under a single line item. |
| ### `https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems/bulkListLineItemAssignedTargetingOptions` | Lists assigned targeting options of a line item across targeting types. |
| ### `https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems/create` | Creates a new line item. |
| ### `https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems/delete` | Deletes a line item. |
| ### `https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems/generateDefault` | Creates a new line item with settings (including targeting) inherited from the insertion order and an `ENTITY_STATUS_DRAFT` `https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#LineItem.FIELDS.entity_status`. |
| ### `https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems/get` | Gets a line item. |
| ### `https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems/list` | Lists line items in an advertiser. |
| ### `https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems/patch` | Updates an existing line item. |