Web Service: ProposalLineItemService

Port type ProposalLineItemServiceInterfaceSource code

1. createMakegoods
   Source code
   Description:
   Creates makegood proposal line items given the specifications provided.
   Operation type:
   Request-response. The endpoint receives a message, and sends a correlated message.
   Input:
   createMakegoodsRequest (wsdlsoap:header, use = literal, part = RequestHeader)Source code
   parameters type createMakegoods

   Creates makegood proposal line items given the specifications provided.

   • makegoodInfos - optional, unbounded; type ProposalLineItemMakegoodInfo
     Makegood info for a {@link ProposalLineItemDto}.
     • originalProposalLineItemId - optional; type long
       The ID of the original proposal line item on which this makegood is based. This attribute is read-only.
     • reason - optional; type string
       The publisher-provided reason why this makegood was initiated. This is free form text.

       The following predefined values can be used to render predefined options in the UI.

       UNDERDELIVERY: 'Impression underdelivery', SECONDARY_DELIVERY_TERMS: 'Did not meet secondary delivery terms ', PERFORMANCE: 'Performance issues',

   Output:
   createMakegoodsResponse (wsdlsoap:header, use = literal, part = ResponseHeader)Source code
   parameters type createMakegoodsResponse

   • rval - optional, unbounded; type ProposalLineItem
     A {@code ProposalLineItem} is added to a programmatic {@link Proposal} and is similar to a delivery {@link LineItem}. It contains delivery details including information like impression goal or quantity, start and end times, and targeting.
     • id - optional; type long
       The unique ID of the {@code ProposalLineItem}. This attribute is read-only.
     • proposalId - optional; type long
       The unique ID of the {@link Proposal}, to which the {@code ProposalLineItem} belongs. This attribute is required for creation and then is readonly. This attribute is required.
     • name - optional; type string
       The name of the {@code ProposalLineItem} which should be unique under the same {@link Proposal}. This attribute has a maximum length of 255 characters. This attribute can be configured as editable after the proposal has been submitted. Please check with your network administrator for editable fields configuration. This attribute is required.
     • startDateTime - optional; type DateTime
       Represents a date combined with the time of day.
       • date - optional; type Date
         Represents a date.
         • year - optional; type int
           Year (e.g., 2009)
         • month - optional; type int
           Month (1..12)
         • day - optional; type int
           Day (1..31)
       • hour - optional; type int
       • minute - optional; type int
       • second - optional; type int
       • timeZoneId - optional; type string
       The date and time at which the line item associated with the {@code ProposalLineItem} is enabled to begin serving. This attribute is optional during creation, but required and must be in the future when it turns into a line item. The {@link DateTime#timeZoneID} is required if start date time is not {@code null}. This attribute becomes readonly once the {@code ProposalLineItem} has started delivering.
     • endDateTime - optional; type DateTime
       Represents a date combined with the time of day.
       • date - optional; type Date
         Represents a date.
         • year - optional; type int
           Year (e.g., 2009)
         • month - optional; type int
           Month (1..12)
         • day - optional; type int
           Day (1..31)
       • hour - optional; type int
       • minute - optional; type int
       • second - optional; type int
       • timeZoneId - optional; type string
       The date and time at which the line item associated with the {@code ProposalLineItem} stops beening served. This attribute is optional during creation, but required and must be after the {@link #startDateTime}. The {@link DateTime#timeZoneID} is required if end date time is not {@code null}.
     • internalNotes - optional; type string
       Provides any additional notes that may annotate the {@code ProposalLineItem}. This attribute is optional and has a maximum length of 65,535 characters. This attribute can be configured as editable after the proposal has been submitted. Please check with your network administrator for editable fields configuration.
     • isArchived - optional; type boolean
       The archival status of the {@code ProposalLineItem}. This attribute is read-only.
     • goal - optional; type Goal
       Defines the criteria a {@link LineItem} needs to satisfy to meet its delivery goal.
       • goalType - optional; type GoalType - type string with restriction - enum { 'NONE', 'LIFETIME', 'DAILY', 'UNKNOWN' }
         The type of the goal for the {@code LineItem}. It defines the period over which the goal for {@code LineItem} should be reached.
       • unitType - optional; type UnitType - type string with restriction - enum { 'IMPRESSIONS', 'CLICKS', 'CLICK_THROUGH_CPA_CONVERSIONS', 'VIEW_THROUGH_CPA_CONVERSIONS', 'TOTAL_CPA_CONVERSIONS', 'VIEWABLE_IMPRESSIONS', 'IN_TARGET_IMPRESSIONS', 'UNKNOWN' }
         The type of the goal unit for the {@code LineItem}.
       • units - optional; type long
         If this is a primary goal, it represents the number or percentage of impressions or clicks that will be reserved for the {@code LineItem}. If the line item is of type {@link LineItemType#SPONSORSHIP}, it represents the percentage of available impressions reserved. If the line item is of type {@link LineItemType#BULK} or {@link LineItemType#PRICE_PRIORITY}, it represents the number of remaining impressions reserved. If the line item is of type {@link LineItemType#NETWORK} or {@link LineItemType#HOUSE}, it represents the percentage of remaining impressions reserved.

         If this is a secondary goal, it represents the number of impressions or conversions that the line item will stop serving at if reached. For valid line item types, see {@link LineItem#secondaryGoals}.

       The goal(i.e. contracted quantity, quantity or limit) that this {@code ProposalLineItem} is associated with, which is used in its pacing and budgeting. {@link Goal#units} must be greater than 0 when the proposal line item turns into a line item, {@link Goal#goalType} and {@link Goal#unitType} are readonly. For a Preferred deal {@code ProposalLineItem}, the goal type can only be {@link GoalType#NONE}. This attribute is required.
     • secondaryGoals - optional, unbounded; type Goal
       Defines the criteria a {@link LineItem} needs to satisfy to meet its delivery goal.
       • goalType - optional; type GoalType - type string with restriction - enum { 'NONE', 'LIFETIME', 'DAILY', 'UNKNOWN' }
         The type of the goal for the {@code LineItem}. It defines the period over which the goal for {@code LineItem} should be reached.
       • unitType - optional; type UnitType - type string with restriction - enum { 'IMPRESSIONS', 'CLICKS', 'CLICK_THROUGH_CPA_CONVERSIONS', 'VIEW_THROUGH_CPA_CONVERSIONS', 'TOTAL_CPA_CONVERSIONS', 'VIEWABLE_IMPRESSIONS', 'IN_TARGET_IMPRESSIONS', 'UNKNOWN' }
         The type of the goal unit for the {@code LineItem}.
       • units - optional; type long
         If this is a primary goal, it represents the number or percentage of impressions or clicks that will be reserved for the {@code LineItem}. If the line item is of type {@link LineItemType#SPONSORSHIP}, it represents the percentage of available impressions reserved. If the line item is of type {@link LineItemType#BULK} or {@link LineItemType#PRICE_PRIORITY}, it represents the number of remaining impressions reserved. If the line item is of type {@link LineItemType#NETWORK} or {@link LineItemType#HOUSE}, it represents the percentage of remaining impressions reserved.

         If this is a secondary goal, it represents the number of impressions or conversions that the line item will stop serving at if reached. For valid line item types, see {@link LineItem#secondaryGoals}.

       The secondary goals that this {@code ProposalLineItem} is associated with. For a programmatic line item with the properties {@link RateType#CPM} and {@link LineItemType#SPONSORSHIP}, this field will have one goal which describes the impressions cap. For other cases, this field is an empty list.
     • contractedUnitsBought - optional; type long
       The contracted number of daily minimum impressions used for {@link LineItemType#SPONSORSHIP} {@code ProposalLineItem} deals with a rate type of {@link RateType#CPD}.

       This attribute is required for percentage-based-goal {@link ProposalLineItem proposal line items}. It does not impact ad-serving and is for reporting purposes only.

     • deliveryRateType - optional; type DeliveryRateType - type string with restriction - enum { 'EVENLY', 'FRONTLOADED', 'AS_FAST_AS_POSSIBLE' }
       The strategy for delivering ads over the course of the {@code ProposalLineItem}'s duration. This attribute is required. For a Preferred deal {@code ProposalLineItem}, the value can only be {@link DeliveryRateType#FRONTLOADED}.
     • roadblockingType - optional; type RoadblockingType - type string with restriction - enum { 'ONLY_ONE', 'ONE_OR_MORE', 'AS_MANY_AS_POSSIBLE', 'ALL_ROADBLOCK', 'CREATIVE_SET' }
       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 during creation and defaults to the {@link Product#roadblockingType product's roadblocking type}, or {@link RoadblockingType#ONE_OR_MORE} if not specified by the product.
     • companionDeliveryOption - optional; type CompanionDeliveryOption - type string with restriction - enum { 'OPTIONAL', 'AT_LEAST_ONE', 'ALL', 'UNKNOWN' }
       The delivery option for companions. This is only valid if the roadblocking type is {@link RoadblockingType#CREATIVE_SET}. The default value for roadblocking creatives is {@link CompanionDeliveryOption#OPTIONAL}. The default value in other cases is {@link CompanionDeliveryOption#UNKNOWN}. Providing something other than {@link CompanionDeliveryOption#UNKNOWN} will cause an error.
     • videoMaxDuration - optional; type long
       The max duration of a video creative associated with this {@code ProposalLineItem} in milliseconds. This attribute is optional, defaults to the {@link Product#videoMaxDuration} on the {@link Product} it was created with, and only meaningful if this is a video proposal line item.
     • videoCreativeSkippableAdType - optional; type SkippableAdType - type string with restriction - enum { 'UNKNOWN', 'DISABLED', 'ENABLED', 'INSTREAM_SELECT', 'ANY' }
       The proposal line item's creatives' skippability. This attribute is optional, only applicable for video proposal line items, and defaults to {@link SkippableAdType#NOT_SKIPPABLE}.
     • frequencyCaps - optional, unbounded; type FrequencyCap
       Represents a limit on the number of times a single viewer can be exposed to the same {@link LineItem} in a specified time period.
       • maxImpressions - optional; type int
         The maximum number of impressions than can be served to a user within a specified time period.
       • numTimeUnits - optional; type int
         The number of {@code FrequencyCap#timeUnit} to represent the total time period.
       • timeUnit - optional; type TimeUnit - type string with restriction - enum { 'MINUTE', 'HOUR', 'DAY', 'WEEK', 'MONTH', 'LIFETIME', 'POD', 'STREAM', 'UNKNOWN' }
         The unit of time for specifying the time period.
       The set of frequency capping units for this {@code ProposalLineItem}. This attribute is optional during creation and defaults to the {@link Product#frequencyCaps product's frequency caps} if {@link Product#allowFrequencyCapsCustomization} is {@code false}.
     • dfpLineItemId - optional; type long
       The unique ID of corresponding {@link LineItem}. This will be {@code null} if the {@link Proposal} has not been pushed to Ad Manager. This attribute is read-only.
     • lineItemType - optional; type LineItemType - type string with restriction - enum { 'SPONSORSHIP', 'STANDARD', 'NETWORK', 'BULK', 'PRICE_PRIORITY', 'HOUSE', 'LEGACY_DFP', 'CLICK_TRACKING', 'ADSENSE', 'AD_EXCHANGE', 'BUMPER', 'ADMOB', 'PREFERRED_DEAL', 'UNKNOWN' }
       The corresponding {@link LineItemType} of the {@code ProposalLineItem}. For a programmatic {@code ProposalLineItem}, the value can only be one of:

       • {@link LineItemType#SPONSORSHIP}
       • {@link LineItemType#STANDARD}
       • {@link LineItemType#PREFERRED_DEAL}

       This attribute is required.
     • lineItemPriority - optional; type int
       The priority for the corresponding {@link LineItem} of the {@code ProposalLineItem}. This attribute is optional during creation and defaults to the default priority of the {@link #lineItemType}. For forecasting, this attribute is optional and has a default value assigned by Google. See {@link LineItem#priority} for more information.
     • rateType - optional; type RateType - type string with restriction - enum { 'CPM', 'CPD', 'VCPM', 'CPM_IN_TARGET', 'UNKNOWN' }
       The method used for billing the {@code ProposalLineItem}. This attribute is read-only. This attribute is required.
     • creativePlaceholders - optional, unbounded; type CreativePlaceholder
       A {@code CreativePlaceholder} describes a slot that a creative is expected to fill. This is used primarily to help in forecasting, and also to validate that the correct creatives are associated with the line item. A {@code CreativePlaceholder} must contain a size, and it can optionally contain companions. Companions are only valid if the line item's environment type is {@link EnvironmentType#VIDEO_PLAYER}.
       • size - optional; type Size
         The dimensions that the creative is expected to have. This attribute is required.
         Represents the dimensions of an {@link AdUnit}, {@link LineItem} or {@link Creative}.

         For interstitial size (out-of-page), native, ignored and fluid size, {@link Size} must be 1x1.

         • width - optional; type int
           The width of the {@link AdUnit}, {@link LineItem} or {@link Creative}.
         • height - optional; type int
           The height of the {@link AdUnit}, {@link LineItem} or {@link Creative}.
         • isAspectRatio - optional; type boolean
           Whether this size represents an aspect ratio.
       • creativeTemplateId - optional; type long
         The native creative template ID.

         This value is only required if {@link #creativeSizeType} is {@link CreativeSizeType#NATIVE}.

       • companions - optional, unbounded; type CreativePlaceholder
         A {@code CreativePlaceholder} describes a slot that a creative is expected to fill. This is used primarily to help in forecasting, and also to validate that the correct creatives are associated with the line item. A {@code CreativePlaceholder} must contain a size, and it can optionally contain companions. Companions are only valid if the line item's environment type is {@link EnvironmentType#VIDEO_PLAYER}.
         • size - optional; type Size
           The dimensions that the creative is expected to have. This attribute is required.
           Represents the dimensions of an {@link AdUnit}, {@link LineItem} or {@link Creative}.

           For interstitial size (out-of-page), native, ignored and fluid size, {@link Size} must be 1x1.

           • width - optional; type int
             The width of the {@link AdUnit}, {@link LineItem} or {@link Creative}.
           • height - optional; type int
             The height of the {@link AdUnit}, {@link LineItem} or {@link Creative}.
           • isAspectRatio - optional; type boolean
             Whether this size represents an aspect ratio.
         • creativeTemplateId - optional; type long
           The native creative template ID.

           This value is only required if {@link #creativeSizeType} is {@link CreativeSizeType#NATIVE}.

         • companions - optional, unbounded; type CreativePlaceholder
           A {@code CreativePlaceholder} describes a slot that a creative is expected to fill. This is used primarily to help in forecasting, and also to validate that the correct creatives are associated with the line item. A {@code CreativePlaceholder} must contain a size, and it can optionally contain companions. Companions are only valid if the line item's environment type is {@link EnvironmentType#VIDEO_PLAYER}.
           • size - optional; type Size
             The dimensions that the creative is expected to have. This attribute is required.
             Represents the dimensions of an {@link AdUnit}, {@link LineItem} or {@link Creative}.

             For interstitial size (out-of-page), native, ignored and fluid size, {@link Size} must be 1x1.

             • width - optional; type int
               The width of the {@link AdUnit}, {@link LineItem} or {@link Creative}.
             • height - optional; type int
               The height of the {@link AdUnit}, {@link LineItem} or {@link Creative}.
             • isAspectRatio - optional; type boolean
               Whether this size represents an aspect ratio.
           • creativeTemplateId - optional; type long
             The native creative template ID.

             This value is only required if {@link #creativeSizeType} is {@link CreativeSizeType#NATIVE}.

           • companions - optional, unbounded; type CreativePlaceholder... is recursive
             The companions that the creative is expected to have. This attribute can only be set if the line item it belongs to has a {@link LineItem#environmentType} of {@link EnvironmentType#VIDEO_PLAYER} or {@link LineItem#roadblockingType} of {@link RoadblockingType#CREATIVE_SET}.
           • appliedLabels - optional, unbounded; type AppliedLabel
             Represents a {@link Label} that can be applied to an entity. To negate an inherited label, create an {@code AppliedLabel} with {@code labelId} as the inherited label's ID and {@code isNegated} set to true.
             • labelId - optional; type long
               The ID of a created {@link Label}.
             • isNegated - optional; type boolean
               {@code isNegated} should be set to {@code true} to negate the effects of {@code labelId}.
             The set of label frequency caps applied directly to this creative placeholder.
           • effectiveAppliedLabels - optional, unbounded; type AppliedLabel
             Represents a {@link Label} that can be applied to an entity. To negate an inherited label, create an {@code AppliedLabel} with {@code labelId} as the inherited label's ID and {@code isNegated} set to true.
             • labelId - optional; type long
               The ID of a created {@link Label}.
             • isNegated - optional; type boolean
               {@code isNegated} should be set to {@code true} to negate the effects of {@code labelId}.
             Contains the set of labels applied directly to this creative placeholder as well as those inherited from the creative template from which this creative placeholder was instantiated. This field is readonly and is assigned by Google.
           • expectedCreativeCount - optional; type int
             Expected number of creatives that will be uploaded corresponding to this creative placeholder. This estimate is used to improve the accuracy of forecasting; for example, if label frequency capping limits the number of times a creative may be served.
           • creativeSizeType - optional; type CreativeSizeType - type string with restriction - enum { 'PIXEL', 'ASPECT_RATIO', 'INTERSTITIAL', 'IGNORED', 'NATIVE', 'AUDIO' }
             Describes the types of sizes a creative can be. By default, the creative's size is {@link CreativeSizeType#PIXEL}, which is a dimension based size (width-height pair).
           • targetingName - optional; type string
             The name of the {@link CreativeTargeting} for creatives this placeholder represents.

             This attribute is optional. Specifying creative targeting here is for forecasting purposes only and has no effect on serving. The same creative targeting should be specified on a {@link LineItemCreativeAssociation} when associating a {@link Creative} with the {@link LineItem}.

           • isAmpOnly - optional; type boolean
             Indicate if the expected creative of this placeholder has an AMP only variant.

             This attribute is optional. It is for forecasting purposes only and has no effect on serving.

           The companions that the creative is expected to have. This attribute can only be set if the line item it belongs to has a {@link LineItem#environmentType} of {@link EnvironmentType#VIDEO_PLAYER} or {@link LineItem#roadblockingType} of {@link RoadblockingType#CREATIVE_SET}.
         • appliedLabels - optional, unbounded; type AppliedLabel
           Represents a {@link Label} that can be applied to an entity. To negate an inherited label, create an {@code AppliedLabel} with {@code labelId} as the inherited label's ID and {@code isNegated} set to true.
           • labelId - optional; type long
             The ID of a created {@link Label}.
           • isNegated - optional; type boolean
             {@code isNegated} should be set to {@code true} to negate the effects of {@code labelId}.
           The set of label frequency caps applied directly to this creative placeholder.
         • effectiveAppliedLabels - optional, unbounded; type AppliedLabel
           Represents a {@link Label} that can be applied to an entity. To negate an inherited label, create an {@code AppliedLabel} with {@code labelId} as the inherited label's ID and {@code isNegated} set to true.
           • labelId - optional; type long
             The ID of a created {@link Label}.
           • isNegated - optional; type boolean
             {@code isNegated} should be set to {@code true} to negate the effects of {@code labelId}.
           Contains the set of labels applied directly to this creative placeholder as well as those inherited from the creative template from which this creative placeholder was instantiated. This field is readonly and is assigned by Google.
         • expectedCreativeCount - optional; type int
           Expected number of creatives that will be uploaded corresponding to this creative placeholder. This estimate is used to improve the accuracy of forecasting; for example, if label frequency capping limits the number of times a creative may be served.
         • creativeSizeType - optional; type CreativeSizeType - type string with restriction - enum { 'PIXEL', 'ASPECT_RATIO', 'INTERSTITIAL', 'IGNORED', 'NATIVE', 'AUDIO' }
           Describes the types of sizes a creative can be. By default, the creative's size is {@link CreativeSizeType#PIXEL}, which is a dimension based size (width-height pair).
         • targetingName - optional; type string
           The name of the {@link CreativeTargeting} for creatives this placeholder represents.

           This attribute is optional. Specifying creative targeting here is for forecasting purposes only and has no effect on serving. The same creative targeting should be specified on a {@link LineItemCreativeAssociation} when associating a {@link Creative} with the {@link LineItem}.

         • isAmpOnly - optional; type boolean
           Indicate if the expected creative of this placeholder has an AMP only variant.

           This attribute is optional. It is for forecasting purposes only and has no effect on serving.

         The companions that the creative is expected to have. This attribute can only be set if the line item it belongs to has a {@link LineItem#environmentType} of {@link EnvironmentType#VIDEO_PLAYER} or {@link LineItem#roadblockingType} of {@link RoadblockingType#CREATIVE_SET}.
       • appliedLabels - optional, unbounded; type AppliedLabel
         Represents a {@link Label} that can be applied to an entity. To negate an inherited label, create an {@code AppliedLabel} with {@code labelId} as the inherited label's ID and {@code isNegated} set to true.
         • labelId - optional; type long
           The ID of a created {@link Label}.
         • isNegated - optional; type boolean
           {@code isNegated} should be set to {@code true} to negate the effects of {@code labelId}.
         The set of label frequency caps applied directly to this creative placeholder.
       • effectiveAppliedLabels - optional, unbounded; type AppliedLabel
         Represents a {@link Label} that can be applied to an entity. To negate an inherited label, create an {@code AppliedLabel} with {@code labelId} as the inherited label's ID and {@code isNegated} set to true.
         • labelId - optional; type long
           The ID of a created {@link Label}.
         • isNegated - optional; type boolean
           {@code isNegated} should be set to {@code true} to negate the effects of {@code labelId}.
         Contains the set of labels applied directly to this creative placeholder as well as those inherited from the creative template from which this creative placeholder was instantiated. This field is readonly and is assigned by Google.
       • expectedCreativeCount - optional; type int
         Expected number of creatives that will be uploaded corresponding to this creative placeholder. This estimate is used to improve the accuracy of forecasting; for example, if label frequency capping limits the number of times a creative may be served.
       • creativeSizeType - optional; type CreativeSizeType - type string with restriction - enum { 'PIXEL', 'ASPECT_RATIO', 'INTERSTITIAL', 'IGNORED', 'NATIVE', 'AUDIO' }
         Describes the types of sizes a creative can be. By default, the creative's size is {@link CreativeSizeType#PIXEL}, which is a dimension based size (width-height pair).
       • targetingName - optional; type string
         The name of the {@link CreativeTargeting} for creatives this placeholder represents.

         This attribute is optional. Specifying creative targeting here is for forecasting purposes only and has no effect on serving. The same creative targeting should be specified on a {@link LineItemCreativeAssociation} when associating a {@link Creative} with the {@link LineItem}.

       • isAmpOnly - optional; type boolean
         Indicate if the expected creative of this placeholder has an AMP only variant.

         This attribute is optional. It is for forecasting purposes only and has no effect on serving.

       Details about the creatives that are expected to serve through the {@code ProposalLineItem}. This attribute is optional during creation and defaults to the {@link Product#creativePlaceholders product's creative placeholders}. This attribute is required.
     • targeting - optional; type Targeting
       Contains the targeting criteria for the {@code ProposalLineItem}. This attribute is required.
       Contains targeting criteria for {@link LineItem} objects. See {@link LineItem#targeting}.
       • geoTargeting - optional; type GeoTargeting
         Provides line items the ability to target geographical locations. By default, line items target all countries and their subdivisions. With geographical targeting, you can target line items to specific countries, regions, metro areas, and cities. You can also exclude the same.

         The following rules apply for geographical targeting:

         • You cannot target and exclude the same location.
         • You cannot target a child whose parent has been excluded. For example, if the state of Illinois has been excluded, then you cannot target Chicago.
         • You must not target a location if you are also targeting its parent. For example, if you are targeting New York City, you must not have the state of New York as one of the targeted locations.
         • You cannot explicitly define inclusions or exclusions that are already implicit. For example, if you explicitly include California, you implicitly exclude all other states. You therefore cannot explicitly exclude Florida, because it is already implicitly excluded. Conversely if you explicitly exclude Florida, you cannot explicitly include California.
         • targetedLocations - optional, unbounded; type Location
           The geographical locations being targeted by the {@link LineItem}.
           A {@link Location} represents a geographical entity that can be targeted. If a location type is not available because of the API version you are using, the location will be represented as just the base class, otherwise it will be sub-classed correctly.
           • id - optional; type long
             Uniquely identifies each {@code Location}.
           • type - optional; type string
             The location type for this geographical entity (ex. "COUNTRY", "CITY", "STATE", "COUNTY", etc.)
           • canonicalParentId - optional; type int
             The nearest location parent's ID for this geographical entity.
           • displayName - optional; type string
             The localized name of the geographical entity.
         • excludedLocations - optional, unbounded; type Location
           The geographical locations being excluded by the {@link LineItem}.
           A {@link Location} represents a geographical entity that can be targeted. If a location type is not available because of the API version you are using, the location will be represented as just the base class, otherwise it will be sub-classed correctly.
           • id - optional; type long
             Uniquely identifies each {@code Location}.
           • type - optional; type string
             The location type for this geographical entity (ex. "COUNTRY", "CITY", "STATE", "COUNTY", etc.)
           • canonicalParentId - optional; type int
             The nearest location parent's ID for this geographical entity.
           • displayName - optional; type string
             The localized name of the geographical entity.
         Specifies what geographical locations are targeted by the {@link LineItem}. This attribute is optional.
       • inventoryTargeting - optional; type InventoryTargeting
         A collection of targeted and excluded ad units and placements.
         • targetedAdUnits - optional, unbounded; type AdUnitTargeting
           Represents targeted or excluded ad units.
           • adUnitId - optional; type string
             Included or excluded ad unit id.
           • includeDescendants - optional; type boolean
             Whether or not all descendants are included (or excluded) as part of including (or excluding) this ad unit. By default, the value is {@code true} which means targeting this ad unit will target all of its descendants.
           A list of targeted {@link AdUnitTargeting}.
         • excludedAdUnits - optional, unbounded; type AdUnitTargeting
           Represents targeted or excluded ad units.
           • adUnitId - optional; type string
             Included or excluded ad unit id.
           • includeDescendants - optional; type boolean
             Whether or not all descendants are included (or excluded) as part of including (or excluding) this ad unit. By default, the value is {@code true} which means targeting this ad unit will target all of its descendants.
           A list of excluded {@link AdUnitTargeting}.
         • targetedPlacementIds - optional, unbounded; type long
           A list of targeted {@link Placement} ids.
         Specifies what inventory is targeted by the {@link LineItem}. This attribute is required. The line item must target at least one ad unit or placement.
       • dayPartTargeting - optional; type DayPartTargeting
         Modify the delivery times of line items for particular days of the week. By default, line items are served at all days and times.
         • dayParts - optional, unbounded; type DayPart
           {@code DayPart} represents a time-period within a day of the week which is targeted by a {@link LineItem}.
           • dayOfWeek - optional; type DayOfWeek - type string with restriction - enum { 'MONDAY', 'TUESDAY', 'WEDNESDAY', 'THURSDAY', 'FRIDAY', 'SATURDAY', 'SUNDAY' }
             Day of the week the target applies to. This field is required.
           • startTime - optional; type TimeOfDay
             Represents the start time of the targeted period (inclusive).
             Represents a specific time in a day.
             • hour - optional; type int
               Hour in 24 hour time (0..24). This field must be between 0 and 24, inclusive. This field is required.
             • minute - optional; type MinuteOfHour - type string with restriction - enum { 'ZERO', 'FIFTEEN', 'THIRTY', 'FORTY_FIVE' }
               Minutes in an hour. Currently, only 0, 15, 30, and 45 are supported. This field is required.
           • endTime - optional; type TimeOfDay
             Represents the end time of the targeted period (exclusive).
             Represents a specific time in a day.
             • hour - optional; type int
               Hour in 24 hour time (0..24). This field must be between 0 and 24, inclusive. This field is required.
             • minute - optional; type MinuteOfHour - type string with restriction - enum { 'ZERO', 'FIFTEEN', 'THIRTY', 'FORTY_FIVE' }
               Minutes in an hour. Currently, only 0, 15, 30, and 45 are supported. This field is required.
           Specifies days of the week and times at which a {@code LineItem} will be delivered.

           If targeting all days and times, this value will be ignored.

         • timeZone - optional; type DeliveryTimeZone - type string with restriction - enum { 'PUBLISHER', 'BROWSER' }
           Specifies the time zone to be used for delivering {@link LineItem} objects. This attribute is optional and defaults to {@link DeliveryTimeZone#BROWSER}.

           Setting this has no effect if targeting all days and times.

         Specifies the days of the week and times that are targeted by the {@link LineItem}. This attribute is optional.
       • dateTimeRangeTargeting - optional; type DateTimeRangeTargeting
         The date time ranges that the line item is eligible to serve.
         • targetedDateTimeRanges - optional, unbounded; type DateTimeRange
           Represents a range of dates (combined with time of day) that has an upper and/or lower bound.
           • startDateTime - optional; type DateTime
             Represents a date combined with the time of day.
             • date - optional; type Date
               Represents a date.
               • year - optional; type int
                 Year (e.g., 2009)
               • month - optional; type int
                 Month (1..12)
               • day - optional; type int
                 Day (1..31)
             • hour - optional; type int
             • minute - optional; type int
             • second - optional; type int
             • timeZoneId - optional; type string
             The start date time of this range. This field is optional and if it is not set then there is no lower bound on the date time range. If this field is not set then {@code endDateTime} must be specified.
           • endDateTime - optional; type DateTime
             Represents a date combined with the time of day.
             • date - optional; type Date
               Represents a date.
               • year - optional; type int
                 Year (e.g., 2009)
               • month - optional; type int
                 Month (1..12)
               • day - optional; type int
                 Day (1..31)
             • hour - optional; type int
             • minute - optional; type int
             • second - optional; type int
             • timeZoneId - optional; type string
             The end date time of this range. This field is optional and if it is not set then there is no upper bound on the date time range. If this field is not set then {@code startDateTime} must be specified.
         Specifies the dates and time ranges that are targeted by the {@link LineItem}. This attribute is optional.
       • technologyTargeting - optional; type TechnologyTargeting
         Provides {@link LineItem} objects the ability to target or exclude technologies.
         • bandwidthGroupTargeting - optional; type BandwidthGroupTargeting
           The bandwidth groups being targeted by the {@link LineItem}.
           Represents bandwidth groups that are being targeted or excluded by the {@link LineItem}.
           • isTargeted - optional; type boolean
             Indicates whether bandwidth groups should be targeted or excluded. This attribute is optional and defaults to {@code true}.
           • bandwidthGroups - optional, unbounded; type Technology
             The bandwidth groups that are being targeted or excluded by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
         • browserTargeting - optional; type BrowserTargeting
           The browsers being targeted by the {@link LineItem}.
           Represents browsers that are being targeted or excluded by the {@link LineItem}.
           • isTargeted - optional; type boolean
             Indicates whether browsers should be targeted or excluded. This attribute is optional and defaults to {@code true}.
           • browsers - optional, unbounded; type Technology
             Browsers that are being targeted or excluded by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
         • browserLanguageTargeting - optional; type BrowserLanguageTargeting
           The languages of browsers being targeted by the {@link LineItem}.
           Represents browser languages that are being targeted or excluded by the {@link LineItem}.
           • isTargeted - optional; type boolean
             Indicates whether browsers languages should be targeted or excluded. This attribute is optional and defaults to {@code true}.
           • browserLanguages - optional, unbounded; type Technology
             Browser languages that are being targeted or excluded by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
         • deviceCapabilityTargeting - optional; type DeviceCapabilityTargeting
           The device capabilities being targeted by the {@link LineItem}.
           Represents device capabilities that are being targeted or excluded by the {@link LineItem}.
           • targetedDeviceCapabilities - optional, unbounded; type Technology
             Device capabilities that are being targeted by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
           • excludedDeviceCapabilities - optional, unbounded; type Technology
             Device capabilities that are being excluded by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
         • deviceCategoryTargeting - optional; type DeviceCategoryTargeting
           The device categories being targeted by the {@link LineItem}.
           Represents device categories that are being targeted or excluded by the {@link LineItem}.
           • targetedDeviceCategories - optional, unbounded; type Technology
             Device categories that are being targeted by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
           • excludedDeviceCategories - optional, unbounded; type Technology
             Device categories that are being excluded by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
         • deviceManufacturerTargeting - optional; type DeviceManufacturerTargeting
           The device manufacturers being targeted by the {@link LineItem}.
           Represents device manufacturer that are being targeted or excluded by the {@link LineItem}.
           • isTargeted - optional; type boolean
             Indicates whether device manufacturers should be targeted or excluded. This attribute is optional and defaults to {@code true}.
           • deviceManufacturers - optional, unbounded; type Technology
             Device manufacturers that are being targeted or excluded by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
         • mobileCarrierTargeting - optional; type MobileCarrierTargeting
           The mobile carriers being targeted by the {@link LineItem}.
           Represents mobile carriers that are being targeted or excluded by the {@link LineItem}.
           • isTargeted - optional; type boolean
             Indicates whether mobile carriers should be targeted or excluded. This attribute is optional and defaults to {@code true}.
           • mobileCarriers - optional, unbounded; type Technology
             Mobile carriers that are being targeted or excluded by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
         • mobileDeviceTargeting - optional; type MobileDeviceTargeting
           The mobile devices being targeted by the {@link LineItem}.
           Represents mobile devices that are being targeted or excluded by the {@link LineItem}.
           • targetedMobileDevices - optional, unbounded; type Technology
             Mobile devices that are being targeted by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
           • excludedMobileDevices - optional, unbounded; type Technology
             Mobile devices that are being excluded by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
         • mobileDeviceSubmodelTargeting - optional; type MobileDeviceSubmodelTargeting
           The mobile device submodels being targeted by the {@link LineItem}.
           Represents mobile devices that are being targeted or excluded by the {@link LineItem}.
           • targetedMobileDeviceSubmodels - optional, unbounded; type Technology
             Mobile device submodels that are being targeted by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
           • excludedMobileDeviceSubmodels - optional, unbounded; type Technology
             Mobile device submodels that are being excluded by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
         • operatingSystemTargeting - optional; type OperatingSystemTargeting
           The operating systems being targeted by the {@link LineItem}.
           Represents operating systems that are being targeted or excluded by the {@link LineItem}.
           • isTargeted - optional; type boolean
             Indicates whether operating systems should be targeted or excluded. This attribute is optional and defaults to {@code true}.
           • operatingSystems - optional, unbounded; type Technology
             Operating systems that are being targeted or excluded by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
         • operatingSystemVersionTargeting - optional; type OperatingSystemVersionTargeting
           The operating system versions being targeted by the {@link LineItem}.
           Represents operating system versions that are being targeted or excluded by the {@link LineItem}.
           • targetedOperatingSystemVersions - optional, unbounded; type Technology
             Operating system versions that are being targeted by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
           • excludedOperatingSystemVersions - optional, unbounded; type Technology
             Operating system versions that are being excluded by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
         Specifies the browsing technologies that are targeted by the {@link LineItem}. This attribute is optional.
       • customTargeting - optional; type CustomCriteriaSet - extension of abstract type CustomCriteriaNode
         A {@link CustomCriteriaSet} comprises of a set of {@link CustomCriteriaNode} objects combined by the {@link CustomCriteriaSet.LogicalOperator#logicalOperator}. The custom criteria targeting tree is subject to the rules defined on {@link Targeting#customTargeting}.
         A {@link CustomCriteriaNode} is a node in the custom targeting tree. A custom criteria node can either be a {@link CustomCriteriaSet} (a non-leaf node) or a {@link CustomCriteria} (a leaf node). The custom criteria targeting tree is subject to the rules defined on {@link Targeting#customTargeting}.
         • logicalOperator - optional; type CustomCriteriaSet.LogicalOperator - type string with restriction - enum { 'AND', 'OR' }
           The logical operator to be applied to {@link CustomCriteriaSet#children}. This attribute is required. This attribute is required.
         • children - optional, unbounded; type CustomCriteriaNode
           The custom criteria. This attribute is required.
           A {@link CustomCriteriaNode} is a node in the custom targeting tree. A custom criteria node can either be a {@link CustomCriteriaSet} (a non-leaf node) or a {@link CustomCriteria} (a leaf node). The custom criteria targeting tree is subject to the rules defined on {@link Targeting#customTargeting}.
           Specifies the collection of custom criteria that is targeted by the {@link LineItem}.

           Once the {@link LineItem} is updated or modified with custom targeting, the server may return a normalized, but equivalent representation of the custom targeting expression.

           {@code customTargeting} will have up to three levels of expressions including itself.

           The top level {@code CustomCriteriaSet} i.e. the {@code customTargeting} object can only contain a {@link CustomCriteriaSet.LogicalOperator#OR} of all its children.

           The second level of {@code CustomCriteriaSet} objects can only contain {@link CustomCriteriaSet.LogicalOperator#AND} of all their children. If a {@link CustomCriteria} is placed on this level, the server will wrap it in a {@link CustomCriteriaSet}.

           The third level can only comprise of {@link CustomCriteria} objects.

           The resulting custom targeting tree would be of the form:
           

         • userDomainTargeting - optional; type UserDomainTargeting
           Specifies the domains or subdomains that are targeted or excluded by the {@link LineItem}. Users visiting from an IP address associated with those domains will be targeted or excluded. This attribute is optional.
           Provides line items the ability to target or exclude users visiting their websites from a list of domains or subdomains.
           • domains - optional, unbounded; type string
             The domains or subdomains that are being targeted or excluded by the {@link LineItem}. This attribute is required and the maximum length of each domain is 67 characters.
           • targeted - optional; type boolean
             Indicates whether domains should be targeted or excluded. This attribute is optional and defaults to {@code true}.
         • contentTargeting - optional; type ContentTargeting
           Used to target {@link LineItem}s to specific videos on a publisher's site.
           • targetedContentIds - optional, unbounded; type long
             The IDs of content being targeted by the {@code LineItem}.
           • excludedContentIds - optional, unbounded; type long
             The IDs of content being excluded by the {@code LineItem}.
           • targetedVideoContentBundleIds - optional, unbounded; type long
             A list of video content bundles, represented by {@link ContentBundle} IDs, that are being targeted by the {@code LineItem}.
           • excludedVideoContentBundleIds - optional, unbounded; type long
             A list of video content bundles, represented by {@link ContentBundle} IDs, that are being excluded by the {@code LineItem}.
           Specifies the video categories and individual videos targeted by the {@link LineItem}.
         • videoPositionTargeting - optional; type VideoPositionTargeting
           Specifies targeting against video position types.
           Represents positions within and around a video where ads can be targeted to.

           Example positions could be {@code pre-roll} (before the video plays), {@code post-roll} (after a video has completed playback) and {@code mid-roll} (during video playback).

           Empty video position targeting means that all video positions are allowed. If a bumper line item has empty video position targeting it will be updated to target all bumper positions.

           • targetedPositions - optional, unbounded; type VideoPositionTarget
             The {@link VideoTargetingPosition} objects being targeted by the video {@link LineItem}.
             Represents the options for targetable positions within a video.
             • videoPosition - optional; type VideoPosition
               Represents a targetable position within a video. A video ad can be targeted to a position (pre-roll, all mid-rolls, or post-roll), or to a specific mid-roll index.
               • positionType - optional; type VideoPosition.Type - type string with restriction - enum { 'UNKNOWN', 'ALL', 'PREROLL', 'MIDROLL', 'POSTROLL' }
                 The type of video position (pre-roll, mid-roll, or post-roll).
               • midrollIndex - optional; type int
                 The index of the mid-roll to target. Only valid if the {@link positionType} is {@link VideoPositionType#MIDROLL}, otherwise this field will be ignored.
               The video position to target. This attribute is required.
             • videoBumperType - optional; type VideoBumperType - type string with restriction - enum { 'BEFORE', 'AFTER' }
               The video bumper type to target. To target a video position or a pod position, this value must be null. To target a bumper position this value must be populated and the line item must have a bumper type. To target a custom ad spot, this value must be null.
             • videoPositionWithinPod - optional; type VideoPositionWithinPod
               Represents a targetable position within a pod within a video stream. A video ad can be targeted to any position in the pod (first, second, third ... last). If there is only 1 ad in a pod, either first or last will target that position.
               • index - optional; type int
                 The specific index of the pod. The index is defined as:

                 • 1 = first
                 • 2 = second
                 • 3 = third
                 • ....
                 • 100 = last

                 100 will always be the last position. For example, for a pod with 5 positions, 100 would target position 5. Multiple targets against the index 100 can exist.
                 Positions over 100 are not supported.
               The video position within a pod to target. To target a video position or a bumper position, this value must be null. To target a position within a pod this value must be populated. To target a custom ad spot, this value must be null.
             • adSpotId - optional; type long
               A custom spot {@link AdSpot} to target. To target a video position, a bumper type or a video position within a pod this value must be null.
         • mobileApplicationTargeting - optional; type MobileApplicationTargeting
           Provides the ability to target or exclude users' mobile applications.
           • mobileApplicationIds - optional, unbounded; type long
             The {@link MobileApplication#id IDs} that are being targeted or excluded.
           • isTargeted - optional; type boolean
             Indicates whether mobile apps should be targeted or excluded. This attribute is optional and defaults to {@code true}.
           Specifies targeting against mobile applications.
         • buyerUserListTargeting - optional; type BuyerUserListTargeting
           The {@code BuyerUserListTargeting} associated with a programmatic {@link LineItem} or {@link ProposalLineItem} object.
           • hasBuyerUserListTargeting - optional; type boolean
             Whether the programmatic {@code LineItem} or {@code ProposalLineItem} object has buyer user list targeting.
           Specifies whether buyer user lists are targeted on a programmatic {@link LineItem} or {@link ProposalLineItem}. This attribute is readonly and is populated by Google.
         • inventoryUrlTargeting - optional; type InventoryUrlTargeting
           A collection of targeted inventory urls.
           • targetedUrls - optional, unbounded; type InventoryUrl
             The representation of an inventory Url that is used in targeting.
             • id - optional; type long
           • excludedUrls - optional, unbounded; type InventoryUrl
             The representation of an inventory Url that is used in targeting.
             • id - optional; type long
           Specifies the URLs that are targeted by the entity. This is currently only supported by {@link YieldGroup}.
         • verticalTargeting - optional; type VerticalTargeting
           Specifies the verticals that are targeted by the entity. The IDs listed here correspond to the IDs in the AD_CATEGORY table of type VERTICAL.
           Vertical targeting information.
           • targetedVerticalIds - optional, unbounded; type long
           • excludedVerticalIds - optional, unbounded; type long
         • contentLabelTargeting - optional; type ContentLabelTargeting
           Content label targeting information.
           • excludedContentLabelIds - optional, unbounded; type long
           Specifies the content labels that are excluded by the entity. The IDs listed here correspond to the IDs in the CONTENT_LABEL table.
         • requestPlatformTargeting - optional; type RequestPlatformTargeting
           Provides line items the ability to target the platform that requests and renders the ad.

           The following rules apply for {@link RequestPlatformTargeting}

           • {@link RequestPlatformTargeting} must be specified for {@link ProposalLineItem}s.
           • {@link RequestPlatformTargeting} must be specified for video line items. Empty values for {@link RequestPlatformTargeting#targetedRequestPlatforms} mean that all request platforms will be targeted.
           • {@link RequestPlatformTargeting} is read-only and assigned by Google for non-video line items.
           • {@link RequestPlatformTargeting} is read-only and assigned by Google for line items generated from proposal line items.
           • targetedRequestPlatforms - optional, unbounded; type RequestPlatform - type string with restriction - enum { 'UNKNOWN', 'BROWSER', 'MOBILE_APP', 'VIDEO_PLAYER' }
           Specifies the request platforms that are targeted by the {@link LineItem}. This attribute is required for video line items and for {@link ProposalLineItem}.

           This value is modifiable for video line items, but read-only for non-video line items.

           This value is read-only for video line items generated from proposal line items.

         • inventorySizeTargeting - optional; type InventorySizeTargeting
           Represents a collection of targeted and excluded inventory sizes. This is currently only available on {@link YieldGroup} and {@link TrafficDataRequest}.
           • isTargeted - optional; type boolean
             Whether the inventory sizes should be targeted or excluded.
           • targetedSizes - optional, unbounded; type TargetedSize
             A list of {@link TargetedSizeDto}s.
             A size that is targeted on a request.
             • size - optional; type Size
               Represents the dimensions of an {@link AdUnit}, {@link LineItem} or {@link Creative}.

               For interstitial size (out-of-page), native, ignored and fluid size, {@link Size} must be 1x1.

               • width - optional; type int
                 The width of the {@link AdUnit}, {@link LineItem} or {@link Creative}.
               • height - optional; type int
                 The height of the {@link AdUnit}, {@link LineItem} or {@link Creative}.
               • isAspectRatio - optional; type boolean
                 Whether this size represents an aspect ratio.
           Specifies the sizes that are targeted by the entity. This is currently only supported on {@link YieldGroup} and {@link TrafficDataRequest}.
         • customFieldValues - optional, unbounded; type BaseCustomFieldValue
           The value of a {@link CustomField} for a particular entity.
           • customFieldId - optional; type long
             Id of the {@code CustomField} to which this value belongs. This attribute is required.
           The values of the custom fields associated with the {@code ProposalLineItem}. This attribute is optional. This attribute can be configured as editable after the proposal has been submitted. Please check with your network administrator for editable fields configuration.
         • appliedLabels - optional, unbounded; type AppliedLabel
           Represents a {@link Label} that can be applied to an entity. To negate an inherited label, create an {@code AppliedLabel} with {@code labelId} as the inherited label's ID and {@code isNegated} set to true.
           • labelId - optional; type long
             The ID of a created {@link Label}.
           • isNegated - optional; type boolean
             {@code isNegated} should be set to {@code true} to negate the effects of {@code labelId}.
           The set of labels applied directly to the {@code ProposalLineItem}. This attribute is optional.
         • effectiveAppliedLabels - optional, unbounded; type AppliedLabel
           Represents a {@link Label} that can be applied to an entity. To negate an inherited label, create an {@code AppliedLabel} with {@code labelId} as the inherited label's ID and {@code isNegated} set to true.
           • labelId - optional; type long
             The ID of a created {@link Label}.
           • isNegated - optional; type boolean
             {@code isNegated} should be set to {@code true} to negate the effects of {@code labelId}.
           Contains the set of labels applied directly to the proposal as well as those inherited ones. If a label has been negated, only the negated label is returned. This attribute is read-only.
         • disableSameAdvertiserCompetitiveExclusion - optional; type 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 {@code true} will allow line items from the same advertiser to serve regardless of the other competitive exclusion labels being applied.

           This attribute is optional and defaults to false.

         • isSold - optional; type boolean
           Indicates whether this {@code ProposalLineItem} has been sold. This attribute is read-only.
         • netRate - optional; type Money
           Represents a money amount.
           • currencyCode - optional; type string
             Three letter currency code in string format.
           • microAmount - optional; type long
             Money values are always specified in terms of micros which are a millionth of the fundamental currency unit. For US dollars, $1 is 1,000,000 micros.
           The amount of money to spend per impression or click in proposal currency. It supports precision of 4 decimal places in terms of the fundamental currency unit, so the {@link Money#getAmountInMicros} must be multiples of 100. It doesn't include agency commission.

           For example, if {@link Proposal#currencyCode} is 'USD', then $123.4567 could be represented as 123456700, but further precision is not supported.

           The field {@link ProposalLineItem#netRate} is required, and used to calculate {@link ProposalLineItem#netCost} if unspecified.

         • netCost - optional; type Money
           Represents a money amount.
           • currencyCode - optional; type string
             Three letter currency code in string format.
           • microAmount - optional; type long
             Money values are always specified in terms of micros which are a millionth of the fundamental currency unit. For US dollars, $1 is 1,000,000 micros.
           The cost of the {@code ProposalLineItem} in proposal currency. It supports precision of 2 decimal places in terms of the fundamental currency unit, so the {@link Money#getAmountInMicros} must be multiples of 10000. It doesn't include agency commission.

           For example, if {@link Proposal#currencyCode} is 'USD', then $123.45 could be represented as 123450000, but further precision is not supported.

           The field {@link ProposalLineItem#netRate} is required, and used to calculate {@link ProposalLineItem#netCost} if unspecified.

         • deliveryIndicator - optional; type DeliveryIndicator
           Indicates the delivery performance of the {@link LineItem}.
           • expectedDeliveryPercentage - optional; type double
             How much the {@code LineItem} was expected to deliver as a percentage of {@link LineItem#primaryGoal}.
           • actualDeliveryPercentage - optional; type double
             How much the line item actually delivered as a percentage of {@link LineItem#primaryGoal}.
           Indicates how well the line item generated from this proposal line item has been performing. This will be {@code null} if the delivery indicator information is not available due to one of the following reasons:

           1. The proposal line item has not pushed to Ad Manager.
           2. The line item is not delivering.
           3. The line item has an unlimited goal or cap.
           4. The line item has a percentage based goal or cap.

           This attribute is read-only.
         • deliveryData - optional; type DeliveryData
           Holds the number of clicks or impressions, determined by {@link LineItem#costType}, delivered for a single line item for the last 7 days
           • units - optional, unbounded; type long
             Clicks or impressions delivered for the last 7 days.
           Delivery data provides the number of clicks or impressions delivered for the {@link LineItem} generated from this proposal line item in the last 7 days. This will be {@code null} if the delivery data cannot be computed due to one of the following reasons:

           1. The proposal line item has not pushed to Ad Manager.
           2. The line item is not deliverable.
           3. The line item has completed delivering more than 7 days ago.
           4. The line item has an absolute-based goal. {@link ProposalLineItem#deliveryIndicator} should be used to track its progress in this case. This attribute is read-only.
         • computedStatus - optional; type ComputedStatus - type string with restriction - enum { 'DELIVERY_EXTENDED', 'DELIVERING', 'READY', 'PAUSED', 'INACTIVE', 'PAUSED_INVENTORY_RELEASED', 'PENDING_APPROVAL', 'COMPLETED', 'DISAPPROVED', 'DRAFT', 'CANCELED' }
           The status of the {@link LineItem} generated from this proposal line item. This will be {@code null} if the proposal line item has not pushed to Ad Manager. This attribute is read-only.
         • lastModifiedDateTime - optional; type DateTime
           Represents a date combined with the time of day.
           • date - optional; type Date
             Represents a date.
             • year - optional; type int
               Year (e.g., 2009)
             • month - optional; type int
               Month (1..12)
             • day - optional; type int
               Day (1..31)
           • hour - optional; type int
           • minute - optional; type int
           • second - optional; type int
           • timeZoneId - optional; type string
           The date and time this {@code ProposalLineItem} was last modified.

           This attribute is assigned by Google when a {@code ProposalLineItem} is updated. This attribute is read-only.

         • reservationStatus - optional; type ReservationStatus - type string with restriction - enum { 'RESERVED', 'NOT_RESERVED', 'RELEASED', 'CHECK_LINE_ITEM_RESERVATION_STATUS', 'UNKNOWN' }
           The reservation status of the {@link ProposalLineItem}. This attribute is read-only.
         • lastReservationDateTime - optional; type DateTime
           Represents a date combined with the time of day.
           • date - optional; type Date
             Represents a date.
             • year - optional; type int
               Year (e.g., 2009)
             • month - optional; type int
               Month (1..12)
             • day - optional; type int
               Day (1..31)
           • hour - optional; type int
           • minute - optional; type int
           • second - optional; type int
           • timeZoneId - optional; type string
           The last {@link DateTime} when the {@link ProposalLineItem} reserved inventory. This attribute is read-only.
         • environmentType - optional; type EnvironmentType - type string with restriction - enum { 'BROWSER', 'VIDEO_PLAYER' }
           The environment that the {@code ProposalLineItem} is targeting. The default value is {@link EnvironmentType#BROWSER}. If this value is {@link EnvironmentType#VIDEO_PLAYER}, then this {@code ProposalLineItem} can only target {@link AdUnit ad units} that have {@link AdUnitSize sizes} whose {@link AdUnitSize#environmentType} is also {@link EnvironmentType#VIDEO_PLAYER}.

           This field is read-only and set to {@link Product#environmentType} of the product this proposal line item was created from.

         • allowedFormats - optional, unbounded; type AllowedFormats - type string with restriction - enum { 'AUDIO', 'UNKNOWN' }
           The set of {@link AllowedFormats} that this proposal line item can have. If the set is empty, this proposal line item allows all formats.
         • additionalTerms - optional; type string
           Additional terms shown to the buyer in Marketplace.
         • programmaticCreativeSource - optional; type ProgrammaticCreativeSource - type string with restriction - enum { 'PUBLISHER', 'ADVERTISER', 'UNKNOWN' }
           Indicates the {@link ProgrammaticCreativeSource} of the programmatic line item.
         • grpSettings - optional; type GrpSettings
           {@code GrpSettings} contains information for a line item that will have a target demographic when serving. This information will be used to set up tracking and enable reporting on the demographic information.
           • minTargetAge - optional; type long
             Specifies the minimum target age (in years) of the {@link LineItem}. This field is only applicable if {@link #provider} is not null.
           • maxTargetAge - optional; type long
             Specifies the maximum target age (in years) of the {@link LineItem}. This field is only applicable if {@link #provider} is not null.
           • targetGender - optional; type GrpTargetGender - type string with restriction - enum { 'UNKNOWN', 'MALE', 'FEMALE', 'BOTH' }
             Specifies the target gender of the {@link LineItem}. This field is only applicable if {@link #provider} is not null.
           • provider - optional; type GrpProvider - type string with restriction - enum { 'UNKNOWN', 'NIELSEN' }
             Specifies the GRP provider of the {@link LineItem}.
           • inTargetRatioEstimateMilliPercent - optional; type long
             Estimate for the in-target ratio given the line item's audience targeting. This field is only applicable if {@link #provider} is Nielsen, {@link LineItem#primaryGoal#unitType} is in-target impressions, and {@link LineItem#CostType} is in-target CPM. This field determines the in-target ratio to use for pacing Nielsen line items before Nielsen reporting data is available. Represented as a milli percent, so 55.7% becomes 55700.
           • nielsenCtvPacingType - optional; type NielsenCtvPacingType - type string with restriction - enum { 'UNKNOWN', 'NONE', 'COVIEW', 'STRICT_COVIEW' }
             Specifies which pacing computation to apply in pacing to impressions from connected devices. This field is required if {@code enableNielsenCoViewingSupport} is true.
           • pacingDeviceCategorizationType - optional; type PacingDeviceCategorizationType - type string with restriction - enum { 'UNKNOWN', 'GOOGLE', 'NIELSEN' }
             Specifies whether to use Google or Nielsen device breakdown in Nielsen Line Item auto pacing.
           • applyTrueCoview - optional; type boolean
             Specifies whether to apply true coviewing in Nielsen Line Item auto pacing. This field can only be true if NielsenCtvPacingType is not NONE.
           Contains the information for a proposal line item which has a target GRP demographic.
         • estimatedMinimumImpressions - optional; type long
           The estimated minimum impressions that should be delivered for a proposal line item.
         • thirdPartyMeasurementSettings - optional; type ThirdPartyMeasurementSettings
           Contains third party measurement settings for cross-sell Partners
           Contains third party auto-pixeling settings for cross-sell Partners.
           • viewabilityPartner - optional; type ThirdPartyViewabilityIntegrationPartner - type string with restriction - enum { 'NONE', 'MOAT', 'DOUBLE_VERIFY', 'INTEGRAL_AD_SCIENCE', 'COMSCORE', 'TELEMETRY', 'UNKNOWN' }
             A field to determine the type of ThirdPartyViewabilityIntegrationPartner. This field default is NONE.
           • viewabilityClientId - optional; type string
             The third party partner id for YouTube viewability verification.
           • viewabilityReportingId - optional; type string
             The reporting id that maps viewability partner data with a campaign (or a group of related campaigns) specific data.
           • publisherViewabilityPartner - optional; type ThirdPartyViewabilityIntegrationPartner - type string with restriction - enum { 'NONE', 'MOAT', 'DOUBLE_VERIFY', 'INTEGRAL_AD_SCIENCE', 'COMSCORE', 'TELEMETRY', 'UNKNOWN' }
             A field to determine the type of publisher's viewability partner. This field default is NONE.
           • publisherViewabilityClientId - optional; type string
             The third party partner id for YouTube viewability verification for publisher.
           • publisherViewabilityReportingId - optional; type string
             The reporting id that maps viewability partner data with a campaign (or a group of related campaigns) specific data for publisher.
           • brandLiftPartner - optional; type ThirdPartyBrandLiftIntegrationPartner - type string with restriction - enum { 'UNKNOWN', 'NONE', 'KANTAR_MILLWARD_BROWN', 'DYNATA', 'INTAGE', 'MACROMILL' }
             A field to determine the type of ThirdPartyBrandLiftIntegrationPartner. This field default is NONE.
           • brandLiftClientId - optional; type string
             The third party partner id for YouTube brand lift verification.
           • brandLiftReportingId - optional; type string
             The reporting id that maps brand lift partner data with a campaign (or a group of related campaigns) specific data.
           • reachPartner - optional; type ThirdPartyReachIntegrationPartner - type string with restriction - enum { 'NONE', 'COMSCORE', 'NIELSEN', 'KANTAR_MILLWARD_BROWN', 'VIDEO_RESEARCH', 'GEMIUS', 'VIDEO_AMP', 'ISPOT_TV', 'AUDIENCE_PROJECT', 'UNKNOWN' }
             A field to determine the type of advertiser's ThirdPartyReachIntegrationPartner. This field default is UNKNOWN.
           • reachClientId - optional; type string
             The third party partner id for YouTube reach verification for advertiser.
           • reachReportingId - optional; type string
             The reporting id that maps reach partner data with a campaign (or a group of related campaigns) specific data for advertiser.
           • publisherReachPartner - optional; type ThirdPartyReachIntegrationPartner - type string with restriction - enum { 'NONE', 'COMSCORE', 'NIELSEN', 'KANTAR_MILLWARD_BROWN', 'VIDEO_RESEARCH', 'GEMIUS', 'VIDEO_AMP', 'ISPOT_TV', 'AUDIENCE_PROJECT', 'UNKNOWN' }
             A field to determine the type of publisher's ThirdPartyReachIntegrationPartner. This field default is UNKNOWN.
           • publisherReachClientId - optional; type string
             The third party partner id for YouTube reach verification for publisher.
           • publisherReachReportingId - optional; type string
             The reporting id that maps reach partner data with a campaign (or a group of related campaigns) specific data for publisher.
         • makegoodInfo - optional; type ProposalLineItemMakegoodInfo
           Makegood info for this proposal line item. Immutable once created.

           Null if this proposal line item is not a makegood.

           Makegood info for a {@link ProposalLineItemDto}.
           • originalProposalLineItemId - optional; type long
             The ID of the original proposal line item on which this makegood is based. This attribute is read-only.
           • reason - optional; type string
             The publisher-provided reason why this makegood was initiated. This is free form text.

             The following predefined values can be used to render predefined options in the UI.

             UNDERDELIVERY: 'Impression underdelivery', SECONDARY_DELIVERY_TERMS: 'Did not meet secondary delivery terms ', PERFORMANCE: 'Performance issues',

         • hasMakegood - optional; type boolean
           Whether this proposal line item has an associated makegood. This attribute is read-only.
         • canCreateMakegood - optional; type boolean
           Whether a new makegood associated with this line item can be created. This attribute is read-only.
         • pauseRole - optional; type NegotiationRole - type string with restriction - enum { 'BUYER', 'SELLER', 'UNKNOWN' }
           The {@link NegotiationRole} that paused the proposal line item, i.e. {@link NegotiationRole#seller} or {@link NegotiationRole#buyer}, or {@code null} when the proposal is not paused. This attribute is read-only.
         • pauseReason - optional; type string
           The reason for pausing the {@link ProposalLineItem}, provided by the {@link pauseRole}. It is {@code null} when the {@link ProposalLineItem} is not paused. This attribute is read-only.
   Fault:
   ApiException (wsdlsoap:fault, use = literal)Source code
   ApiException type ApiExceptionFault

   Exception class for holding a list of service errors.

   Base class for exceptions.

   • message - optional; type string
     Error message.

   • errors - optional, unbounded; type ApiError
     The API error base class that provides details about an error that occurred while processing a service request.

     The OGNL field path is provided for parsers to identify the request data element that may have caused the error.

     • fieldPath - optional; type string
       The OGNL field path to identify cause of error.
     • fieldPathElements - optional, unbounded; type FieldPathElement
       A parsed copy of the field path. For example, the field path "operations[1].operand" corresponds to this list: {FieldPathElement(field = "operations", index = 1), FieldPathElement(field = "operand", index = null)}.
       A segment of a field path. Each dot in a field path defines a new segment.
       • field - optional; type string
         The name of a field in lower camelcase. (e.g. "biddingStrategy")
       • index - optional; type int
         For list fields, this is a 0-indexed position in the list. Null for non-list fields.
     • trigger - optional; type string
       The data that caused the error.
     • errorString - optional; type string
       A simple string representation of the error and reason.
     List of errors.

   A fault element of type ApiException.
2. createProposalLineItems
   Source code
   Description:
   Creates new {@link ProposalLineItem} objects.
   Operation type:
   Request-response. The endpoint receives a message, and sends a correlated message.
   Input:
   createProposalLineItemsRequest (wsdlsoap:header, use = literal, part = RequestHeader)Source code
   parameters type createProposalLineItems

   Creates new {@link ProposalLineItem} objects.

   • proposalLineItems - optional, unbounded; type ProposalLineItem
     A {@code ProposalLineItem} is added to a programmatic {@link Proposal} and is similar to a delivery {@link LineItem}. It contains delivery details including information like impression goal or quantity, start and end times, and targeting.
     • id - optional; type long
       The unique ID of the {@code ProposalLineItem}. This attribute is read-only.
     • proposalId - optional; type long
       The unique ID of the {@link Proposal}, to which the {@code ProposalLineItem} belongs. This attribute is required for creation and then is readonly. This attribute is required.
     • name - optional; type string
       The name of the {@code ProposalLineItem} which should be unique under the same {@link Proposal}. This attribute has a maximum length of 255 characters. This attribute can be configured as editable after the proposal has been submitted. Please check with your network administrator for editable fields configuration. This attribute is required.
     • startDateTime - optional; type DateTime
       Represents a date combined with the time of day.
       • date - optional; type Date
         Represents a date.
         • year - optional; type int
           Year (e.g., 2009)
         • month - optional; type int
           Month (1..12)
         • day - optional; type int
           Day (1..31)
       • hour - optional; type int
       • minute - optional; type int
       • second - optional; type int
       • timeZoneId - optional; type string
       The date and time at which the line item associated with the {@code ProposalLineItem} is enabled to begin serving. This attribute is optional during creation, but required and must be in the future when it turns into a line item. The {@link DateTime#timeZoneID} is required if start date time is not {@code null}. This attribute becomes readonly once the {@code ProposalLineItem} has started delivering.
     • endDateTime - optional; type DateTime
       Represents a date combined with the time of day.
       • date - optional; type Date
         Represents a date.
         • year - optional; type int
           Year (e.g., 2009)
         • month - optional; type int
           Month (1..12)
         • day - optional; type int
           Day (1..31)
       • hour - optional; type int
       • minute - optional; type int
       • second - optional; type int
       • timeZoneId - optional; type string
       The date and time at which the line item associated with the {@code ProposalLineItem} stops beening served. This attribute is optional during creation, but required and must be after the {@link #startDateTime}. The {@link DateTime#timeZoneID} is required if end date time is not {@code null}.
     • internalNotes - optional; type string
       Provides any additional notes that may annotate the {@code ProposalLineItem}. This attribute is optional and has a maximum length of 65,535 characters. This attribute can be configured as editable after the proposal has been submitted. Please check with your network administrator for editable fields configuration.
     • isArchived - optional; type boolean
       The archival status of the {@code ProposalLineItem}. This attribute is read-only.
     • goal - optional; type Goal
       Defines the criteria a {@link LineItem} needs to satisfy to meet its delivery goal.
       • goalType - optional; type GoalType - type string with restriction - enum { 'NONE', 'LIFETIME', 'DAILY', 'UNKNOWN' }
         The type of the goal for the {@code LineItem}. It defines the period over which the goal for {@code LineItem} should be reached.
       • unitType - optional; type UnitType - type string with restriction - enum { 'IMPRESSIONS', 'CLICKS', 'CLICK_THROUGH_CPA_CONVERSIONS', 'VIEW_THROUGH_CPA_CONVERSIONS', 'TOTAL_CPA_CONVERSIONS', 'VIEWABLE_IMPRESSIONS', 'IN_TARGET_IMPRESSIONS', 'UNKNOWN' }
         The type of the goal unit for the {@code LineItem}.
       • units - optional; type long
         If this is a primary goal, it represents the number or percentage of impressions or clicks that will be reserved for the {@code LineItem}. If the line item is of type {@link LineItemType#SPONSORSHIP}, it represents the percentage of available impressions reserved. If the line item is of type {@link LineItemType#BULK} or {@link LineItemType#PRICE_PRIORITY}, it represents the number of remaining impressions reserved. If the line item is of type {@link LineItemType#NETWORK} or {@link LineItemType#HOUSE}, it represents the percentage of remaining impressions reserved.

         If this is a secondary goal, it represents the number of impressions or conversions that the line item will stop serving at if reached. For valid line item types, see {@link LineItem#secondaryGoals}.

       The goal(i.e. contracted quantity, quantity or limit) that this {@code ProposalLineItem} is associated with, which is used in its pacing and budgeting. {@link Goal#units} must be greater than 0 when the proposal line item turns into a line item, {@link Goal#goalType} and {@link Goal#unitType} are readonly. For a Preferred deal {@code ProposalLineItem}, the goal type can only be {@link GoalType#NONE}. This attribute is required.
     • secondaryGoals - optional, unbounded; type Goal
       Defines the criteria a {@link LineItem} needs to satisfy to meet its delivery goal.
       • goalType - optional; type GoalType - type string with restriction - enum { 'NONE', 'LIFETIME', 'DAILY', 'UNKNOWN' }
         The type of the goal for the {@code LineItem}. It defines the period over which the goal for {@code LineItem} should be reached.
       • unitType - optional; type UnitType - type string with restriction - enum { 'IMPRESSIONS', 'CLICKS', 'CLICK_THROUGH_CPA_CONVERSIONS', 'VIEW_THROUGH_CPA_CONVERSIONS', 'TOTAL_CPA_CONVERSIONS', 'VIEWABLE_IMPRESSIONS', 'IN_TARGET_IMPRESSIONS', 'UNKNOWN' }
         The type of the goal unit for the {@code LineItem}.
       • units - optional; type long
         If this is a primary goal, it represents the number or percentage of impressions or clicks that will be reserved for the {@code LineItem}. If the line item is of type {@link LineItemType#SPONSORSHIP}, it represents the percentage of available impressions reserved. If the line item is of type {@link LineItemType#BULK} or {@link LineItemType#PRICE_PRIORITY}, it represents the number of remaining impressions reserved. If the line item is of type {@link LineItemType#NETWORK} or {@link LineItemType#HOUSE}, it represents the percentage of remaining impressions reserved.

         If this is a secondary goal, it represents the number of impressions or conversions that the line item will stop serving at if reached. For valid line item types, see {@link LineItem#secondaryGoals}.

       The secondary goals that this {@code ProposalLineItem} is associated with. For a programmatic line item with the properties {@link RateType#CPM} and {@link LineItemType#SPONSORSHIP}, this field will have one goal which describes the impressions cap. For other cases, this field is an empty list.
     • contractedUnitsBought - optional; type long
       The contracted number of daily minimum impressions used for {@link LineItemType#SPONSORSHIP} {@code ProposalLineItem} deals with a rate type of {@link RateType#CPD}.

       This attribute is required for percentage-based-goal {@link ProposalLineItem proposal line items}. It does not impact ad-serving and is for reporting purposes only.

     • deliveryRateType - optional; type DeliveryRateType - type string with restriction - enum { 'EVENLY', 'FRONTLOADED', 'AS_FAST_AS_POSSIBLE' }
       The strategy for delivering ads over the course of the {@code ProposalLineItem}'s duration. This attribute is required. For a Preferred deal {@code ProposalLineItem}, the value can only be {@link DeliveryRateType#FRONTLOADED}.
     • roadblockingType - optional; type RoadblockingType - type string with restriction - enum { 'ONLY_ONE', 'ONE_OR_MORE', 'AS_MANY_AS_POSSIBLE', 'ALL_ROADBLOCK', 'CREATIVE_SET' }
       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 during creation and defaults to the {@link Product#roadblockingType product's roadblocking type}, or {@link RoadblockingType#ONE_OR_MORE} if not specified by the product.
     • companionDeliveryOption - optional; type CompanionDeliveryOption - type string with restriction - enum { 'OPTIONAL', 'AT_LEAST_ONE', 'ALL', 'UNKNOWN' }
       The delivery option for companions. This is only valid if the roadblocking type is {@link RoadblockingType#CREATIVE_SET}. The default value for roadblocking creatives is {@link CompanionDeliveryOption#OPTIONAL}. The default value in other cases is {@link CompanionDeliveryOption#UNKNOWN}. Providing something other than {@link CompanionDeliveryOption#UNKNOWN} will cause an error.
     • videoMaxDuration - optional; type long
       The max duration of a video creative associated with this {@code ProposalLineItem} in milliseconds. This attribute is optional, defaults to the {@link Product#videoMaxDuration} on the {@link Product} it was created with, and only meaningful if this is a video proposal line item.
     • videoCreativeSkippableAdType - optional; type SkippableAdType - type string with restriction - enum { 'UNKNOWN', 'DISABLED', 'ENABLED', 'INSTREAM_SELECT', 'ANY' }
       The proposal line item's creatives' skippability. This attribute is optional, only applicable for video proposal line items, and defaults to {@link SkippableAdType#NOT_SKIPPABLE}.
     • frequencyCaps - optional, unbounded; type FrequencyCap
       Represents a limit on the number of times a single viewer can be exposed to the same {@link LineItem} in a specified time period.
       • maxImpressions - optional; type int
         The maximum number of impressions than can be served to a user within a specified time period.
       • numTimeUnits - optional; type int
         The number of {@code FrequencyCap#timeUnit} to represent the total time period.
       • timeUnit - optional; type TimeUnit - type string with restriction - enum { 'MINUTE', 'HOUR', 'DAY', 'WEEK', 'MONTH', 'LIFETIME', 'POD', 'STREAM', 'UNKNOWN' }
         The unit of time for specifying the time period.
       The set of frequency capping units for this {@code ProposalLineItem}. This attribute is optional during creation and defaults to the {@link Product#frequencyCaps product's frequency caps} if {@link Product#allowFrequencyCapsCustomization} is {@code false}.
     • dfpLineItemId - optional; type long
       The unique ID of corresponding {@link LineItem}. This will be {@code null} if the {@link Proposal} has not been pushed to Ad Manager. This attribute is read-only.
     • lineItemType - optional; type LineItemType - type string with restriction - enum { 'SPONSORSHIP', 'STANDARD', 'NETWORK', 'BULK', 'PRICE_PRIORITY', 'HOUSE', 'LEGACY_DFP', 'CLICK_TRACKING', 'ADSENSE', 'AD_EXCHANGE', 'BUMPER', 'ADMOB', 'PREFERRED_DEAL', 'UNKNOWN' }
       The corresponding {@link LineItemType} of the {@code ProposalLineItem}. For a programmatic {@code ProposalLineItem}, the value can only be one of:

       • {@link LineItemType#SPONSORSHIP}
       • {@link LineItemType#STANDARD}
       • {@link LineItemType#PREFERRED_DEAL}

       This attribute is required.
     • lineItemPriority - optional; type int
       The priority for the corresponding {@link LineItem} of the {@code ProposalLineItem}. This attribute is optional during creation and defaults to the default priority of the {@link #lineItemType}. For forecasting, this attribute is optional and has a default value assigned by Google. See {@link LineItem#priority} for more information.
     • rateType - optional; type RateType - type string with restriction - enum { 'CPM', 'CPD', 'VCPM', 'CPM_IN_TARGET', 'UNKNOWN' }
       The method used for billing the {@code ProposalLineItem}. This attribute is read-only. This attribute is required.
     • creativePlaceholders - optional, unbounded; type CreativePlaceholder
       A {@code CreativePlaceholder} describes a slot that a creative is expected to fill. This is used primarily to help in forecasting, and also to validate that the correct creatives are associated with the line item. A {@code CreativePlaceholder} must contain a size, and it can optionally contain companions. Companions are only valid if the line item's environment type is {@link EnvironmentType#VIDEO_PLAYER}.
       • size - optional; type Size
         The dimensions that the creative is expected to have. This attribute is required.
         Represents the dimensions of an {@link AdUnit}, {@link LineItem} or {@link Creative}.

         For interstitial size (out-of-page), native, ignored and fluid size, {@link Size} must be 1x1.

         • width - optional; type int
           The width of the {@link AdUnit}, {@link LineItem} or {@link Creative}.
         • height - optional; type int
           The height of the {@link AdUnit}, {@link LineItem} or {@link Creative}.
         • isAspectRatio - optional; type boolean
           Whether this size represents an aspect ratio.
       • creativeTemplateId - optional; type long
         The native creative template ID.

         This value is only required if {@link #creativeSizeType} is {@link CreativeSizeType#NATIVE}.

       • companions - optional, unbounded; type CreativePlaceholder
         A {@code CreativePlaceholder} describes a slot that a creative is expected to fill. This is used primarily to help in forecasting, and also to validate that the correct creatives are associated with the line item. A {@code CreativePlaceholder} must contain a size, and it can optionally contain companions. Companions are only valid if the line item's environment type is {@link EnvironmentType#VIDEO_PLAYER}.
         • size - optional; type Size
           The dimensions that the creative is expected to have. This attribute is required.
           Represents the dimensions of an {@link AdUnit}, {@link LineItem} or {@link Creative}.

           For interstitial size (out-of-page), native, ignored and fluid size, {@link Size} must be 1x1.

           • width - optional; type int
             The width of the {@link AdUnit}, {@link LineItem} or {@link Creative}.
           • height - optional; type int
             The height of the {@link AdUnit}, {@link LineItem} or {@link Creative}.
           • isAspectRatio - optional; type boolean
             Whether this size represents an aspect ratio.
         • creativeTemplateId - optional; type long
           The native creative template ID.

           This value is only required if {@link #creativeSizeType} is {@link CreativeSizeType#NATIVE}.

         • companions - optional, unbounded; type CreativePlaceholder
           A {@code CreativePlaceholder} describes a slot that a creative is expected to fill. This is used primarily to help in forecasting, and also to validate that the correct creatives are associated with the line item. A {@code CreativePlaceholder} must contain a size, and it can optionally contain companions. Companions are only valid if the line item's environment type is {@link EnvironmentType#VIDEO_PLAYER}.
           • size - optional; type Size
             The dimensions that the creative is expected to have. This attribute is required.
             Represents the dimensions of an {@link AdUnit}, {@link LineItem} or {@link Creative}.

             For interstitial size (out-of-page), native, ignored and fluid size, {@link Size} must be 1x1.

             • width - optional; type int
               The width of the {@link AdUnit}, {@link LineItem} or {@link Creative}.
             • height - optional; type int
               The height of the {@link AdUnit}, {@link LineItem} or {@link Creative}.
             • isAspectRatio - optional; type boolean
               Whether this size represents an aspect ratio.
           • creativeTemplateId - optional; type long
             The native creative template ID.

             This value is only required if {@link #creativeSizeType} is {@link CreativeSizeType#NATIVE}.

           • companions - optional, unbounded; type CreativePlaceholder... is recursive
             The companions that the creative is expected to have. This attribute can only be set if the line item it belongs to has a {@link LineItem#environmentType} of {@link EnvironmentType#VIDEO_PLAYER} or {@link LineItem#roadblockingType} of {@link RoadblockingType#CREATIVE_SET}.
           • appliedLabels - optional, unbounded; type AppliedLabel
             Represents a {@link Label} that can be applied to an entity. To negate an inherited label, create an {@code AppliedLabel} with {@code labelId} as the inherited label's ID and {@code isNegated} set to true.
             • labelId - optional; type long
               The ID of a created {@link Label}.
             • isNegated - optional; type boolean
               {@code isNegated} should be set to {@code true} to negate the effects of {@code labelId}.
             The set of label frequency caps applied directly to this creative placeholder.
           • effectiveAppliedLabels - optional, unbounded; type AppliedLabel
             Represents a {@link Label} that can be applied to an entity. To negate an inherited label, create an {@code AppliedLabel} with {@code labelId} as the inherited label's ID and {@code isNegated} set to true.
             • labelId - optional; type long
               The ID of a created {@link Label}.
             • isNegated - optional; type boolean
               {@code isNegated} should be set to {@code true} to negate the effects of {@code labelId}.
             Contains the set of labels applied directly to this creative placeholder as well as those inherited from the creative template from which this creative placeholder was instantiated. This field is readonly and is assigned by Google.
           • expectedCreativeCount - optional; type int
             Expected number of creatives that will be uploaded corresponding to this creative placeholder. This estimate is used to improve the accuracy of forecasting; for example, if label frequency capping limits the number of times a creative may be served.
           • creativeSizeType - optional; type CreativeSizeType - type string with restriction - enum { 'PIXEL', 'ASPECT_RATIO', 'INTERSTITIAL', 'IGNORED', 'NATIVE', 'AUDIO' }
             Describes the types of sizes a creative can be. By default, the creative's size is {@link CreativeSizeType#PIXEL}, which is a dimension based size (width-height pair).
           • targetingName - optional; type string
             The name of the {@link CreativeTargeting} for creatives this placeholder represents.

             This attribute is optional. Specifying creative targeting here is for forecasting purposes only and has no effect on serving. The same creative targeting should be specified on a {@link LineItemCreativeAssociation} when associating a {@link Creative} with the {@link LineItem}.

           • isAmpOnly - optional; type boolean
             Indicate if the expected creative of this placeholder has an AMP only variant.

             This attribute is optional. It is for forecasting purposes only and has no effect on serving.

           The companions that the creative is expected to have. This attribute can only be set if the line item it belongs to has a {@link LineItem#environmentType} of {@link EnvironmentType#VIDEO_PLAYER} or {@link LineItem#roadblockingType} of {@link RoadblockingType#CREATIVE_SET}.
         • appliedLabels - optional, unbounded; type AppliedLabel
           Represents a {@link Label} that can be applied to an entity. To negate an inherited label, create an {@code AppliedLabel} with {@code labelId} as the inherited label's ID and {@code isNegated} set to true.
           • labelId - optional; type long
             The ID of a created {@link Label}.
           • isNegated - optional; type boolean
             {@code isNegated} should be set to {@code true} to negate the effects of {@code labelId}.
           The set of label frequency caps applied directly to this creative placeholder.
         • effectiveAppliedLabels - optional, unbounded; type AppliedLabel
           Represents a {@link Label} that can be applied to an entity. To negate an inherited label, create an {@code AppliedLabel} with {@code labelId} as the inherited label's ID and {@code isNegated} set to true.
           • labelId - optional; type long
             The ID of a created {@link Label}.
           • isNegated - optional; type boolean
             {@code isNegated} should be set to {@code true} to negate the effects of {@code labelId}.
           Contains the set of labels applied directly to this creative placeholder as well as those inherited from the creative template from which this creative placeholder was instantiated. This field is readonly and is assigned by Google.
         • expectedCreativeCount - optional; type int
           Expected number of creatives that will be uploaded corresponding to this creative placeholder. This estimate is used to improve the accuracy of forecasting; for example, if label frequency capping limits the number of times a creative may be served.
         • creativeSizeType - optional; type CreativeSizeType - type string with restriction - enum { 'PIXEL', 'ASPECT_RATIO', 'INTERSTITIAL', 'IGNORED', 'NATIVE', 'AUDIO' }
           Describes the types of sizes a creative can be. By default, the creative's size is {@link CreativeSizeType#PIXEL}, which is a dimension based size (width-height pair).
         • targetingName - optional; type string
           The name of the {@link CreativeTargeting} for creatives this placeholder represents.

           This attribute is optional. Specifying creative targeting here is for forecasting purposes only and has no effect on serving. The same creative targeting should be specified on a {@link LineItemCreativeAssociation} when associating a {@link Creative} with the {@link LineItem}.

         • isAmpOnly - optional; type boolean
           Indicate if the expected creative of this placeholder has an AMP only variant.

           This attribute is optional. It is for forecasting purposes only and has no effect on serving.

         The companions that the creative is expected to have. This attribute can only be set if the line item it belongs to has a {@link LineItem#environmentType} of {@link EnvironmentType#VIDEO_PLAYER} or {@link LineItem#roadblockingType} of {@link RoadblockingType#CREATIVE_SET}.
       • appliedLabels - optional, unbounded; type AppliedLabel
         Represents a {@link Label} that can be applied to an entity. To negate an inherited label, create an {@code AppliedLabel} with {@code labelId} as the inherited label's ID and {@code isNegated} set to true.
         • labelId - optional; type long
           The ID of a created {@link Label}.
         • isNegated - optional; type boolean
           {@code isNegated} should be set to {@code true} to negate the effects of {@code labelId}.
         The set of label frequency caps applied directly to this creative placeholder.
       • effectiveAppliedLabels - optional, unbounded; type AppliedLabel
         Represents a {@link Label} that can be applied to an entity. To negate an inherited label, create an {@code AppliedLabel} with {@code labelId} as the inherited label's ID and {@code isNegated} set to true.
         • labelId - optional; type long
           The ID of a created {@link Label}.
         • isNegated - optional; type boolean
           {@code isNegated} should be set to {@code true} to negate the effects of {@code labelId}.
         Contains the set of labels applied directly to this creative placeholder as well as those inherited from the creative template from which this creative placeholder was instantiated. This field is readonly and is assigned by Google.
       • expectedCreativeCount - optional; type int
         Expected number of creatives that will be uploaded corresponding to this creative placeholder. This estimate is used to improve the accuracy of forecasting; for example, if label frequency capping limits the number of times a creative may be served.
       • creativeSizeType - optional; type CreativeSizeType - type string with restriction - enum { 'PIXEL', 'ASPECT_RATIO', 'INTERSTITIAL', 'IGNORED', 'NATIVE', 'AUDIO' }
         Describes the types of sizes a creative can be. By default, the creative's size is {@link CreativeSizeType#PIXEL}, which is a dimension based size (width-height pair).
       • targetingName - optional; type string
         The name of the {@link CreativeTargeting} for creatives this placeholder represents.

         This attribute is optional. Specifying creative targeting here is for forecasting purposes only and has no effect on serving. The same creative targeting should be specified on a {@link LineItemCreativeAssociation} when associating a {@link Creative} with the {@link LineItem}.

       • isAmpOnly - optional; type boolean
         Indicate if the expected creative of this placeholder has an AMP only variant.

         This attribute is optional. It is for forecasting purposes only and has no effect on serving.

       Details about the creatives that are expected to serve through the {@code ProposalLineItem}. This attribute is optional during creation and defaults to the {@link Product#creativePlaceholders product's creative placeholders}. This attribute is required.
     • targeting - optional; type Targeting
       Contains the targeting criteria for the {@code ProposalLineItem}. This attribute is required.
       Contains targeting criteria for {@link LineItem} objects. See {@link LineItem#targeting}.
       • geoTargeting - optional; type GeoTargeting
         Provides line items the ability to target geographical locations. By default, line items target all countries and their subdivisions. With geographical targeting, you can target line items to specific countries, regions, metro areas, and cities. You can also exclude the same.

         The following rules apply for geographical targeting:

         • You cannot target and exclude the same location.
         • You cannot target a child whose parent has been excluded. For example, if the state of Illinois has been excluded, then you cannot target Chicago.
         • You must not target a location if you are also targeting its parent. For example, if you are targeting New York City, you must not have the state of New York as one of the targeted locations.
         • You cannot explicitly define inclusions or exclusions that are already implicit. For example, if you explicitly include California, you implicitly exclude all other states. You therefore cannot explicitly exclude Florida, because it is already implicitly excluded. Conversely if you explicitly exclude Florida, you cannot explicitly include California.
         • targetedLocations - optional, unbounded; type Location
           The geographical locations being targeted by the {@link LineItem}.
           A {@link Location} represents a geographical entity that can be targeted. If a location type is not available because of the API version you are using, the location will be represented as just the base class, otherwise it will be sub-classed correctly.
           • id - optional; type long
             Uniquely identifies each {@code Location}.
           • type - optional; type string
             The location type for this geographical entity (ex. "COUNTRY", "CITY", "STATE", "COUNTY", etc.)
           • canonicalParentId - optional; type int
             The nearest location parent's ID for this geographical entity.
           • displayName - optional; type string
             The localized name of the geographical entity.
         • excludedLocations - optional, unbounded; type Location
           The geographical locations being excluded by the {@link LineItem}.
           A {@link Location} represents a geographical entity that can be targeted. If a location type is not available because of the API version you are using, the location will be represented as just the base class, otherwise it will be sub-classed correctly.
           • id - optional; type long
             Uniquely identifies each {@code Location}.
           • type - optional; type string
             The location type for this geographical entity (ex. "COUNTRY", "CITY", "STATE", "COUNTY", etc.)
           • canonicalParentId - optional; type int
             The nearest location parent's ID for this geographical entity.
           • displayName - optional; type string
             The localized name of the geographical entity.
         Specifies what geographical locations are targeted by the {@link LineItem}. This attribute is optional.
       • inventoryTargeting - optional; type InventoryTargeting
         A collection of targeted and excluded ad units and placements.
         • targetedAdUnits - optional, unbounded; type AdUnitTargeting
           Represents targeted or excluded ad units.
           • adUnitId - optional; type string
             Included or excluded ad unit id.
           • includeDescendants - optional; type boolean
             Whether or not all descendants are included (or excluded) as part of including (or excluding) this ad unit. By default, the value is {@code true} which means targeting this ad unit will target all of its descendants.
           A list of targeted {@link AdUnitTargeting}.
         • excludedAdUnits - optional, unbounded; type AdUnitTargeting
           Represents targeted or excluded ad units.
           • adUnitId - optional; type string
             Included or excluded ad unit id.
           • includeDescendants - optional; type boolean
             Whether or not all descendants are included (or excluded) as part of including (or excluding) this ad unit. By default, the value is {@code true} which means targeting this ad unit will target all of its descendants.
           A list of excluded {@link AdUnitTargeting}.
         • targetedPlacementIds - optional, unbounded; type long
           A list of targeted {@link Placement} ids.
         Specifies what inventory is targeted by the {@link LineItem}. This attribute is required. The line item must target at least one ad unit or placement.
       • dayPartTargeting - optional; type DayPartTargeting
         Modify the delivery times of line items for particular days of the week. By default, line items are served at all days and times.
         • dayParts - optional, unbounded; type DayPart
           {@code DayPart} represents a time-period within a day of the week which is targeted by a {@link LineItem}.
           • dayOfWeek - optional; type DayOfWeek - type string with restriction - enum { 'MONDAY', 'TUESDAY', 'WEDNESDAY', 'THURSDAY', 'FRIDAY', 'SATURDAY', 'SUNDAY' }
             Day of the week the target applies to. This field is required.
           • startTime - optional; type TimeOfDay
             Represents the start time of the targeted period (inclusive).
             Represents a specific time in a day.
             • hour - optional; type int
               Hour in 24 hour time (0..24). This field must be between 0 and 24, inclusive. This field is required.
             • minute - optional; type MinuteOfHour - type string with restriction - enum { 'ZERO', 'FIFTEEN', 'THIRTY', 'FORTY_FIVE' }
               Minutes in an hour. Currently, only 0, 15, 30, and 45 are supported. This field is required.
           • endTime - optional; type TimeOfDay
             Represents the end time of the targeted period (exclusive).
             Represents a specific time in a day.
             • hour - optional; type int
               Hour in 24 hour time (0..24). This field must be between 0 and 24, inclusive. This field is required.
             • minute - optional; type MinuteOfHour - type string with restriction - enum { 'ZERO', 'FIFTEEN', 'THIRTY', 'FORTY_FIVE' }
               Minutes in an hour. Currently, only 0, 15, 30, and 45 are supported. This field is required.
           Specifies days of the week and times at which a {@code LineItem} will be delivered.

           If targeting all days and times, this value will be ignored.

         • timeZone - optional; type DeliveryTimeZone - type string with restriction - enum { 'PUBLISHER', 'BROWSER' }
           Specifies the time zone to be used for delivering {@link LineItem} objects. This attribute is optional and defaults to {@link DeliveryTimeZone#BROWSER}.

           Setting this has no effect if targeting all days and times.

         Specifies the days of the week and times that are targeted by the {@link LineItem}. This attribute is optional.
       • dateTimeRangeTargeting - optional; type DateTimeRangeTargeting
         The date time ranges that the line item is eligible to serve.
         • targetedDateTimeRanges - optional, unbounded; type DateTimeRange
           Represents a range of dates (combined with time of day) that has an upper and/or lower bound.
           • startDateTime - optional; type DateTime
             Represents a date combined with the time of day.
             • date - optional; type Date
               Represents a date.
               • year - optional; type int
                 Year (e.g., 2009)
               • month - optional; type int
                 Month (1..12)
               • day - optional; type int
                 Day (1..31)
             • hour - optional; type int
             • minute - optional; type int
             • second - optional; type int
             • timeZoneId - optional; type string
             The start date time of this range. This field is optional and if it is not set then there is no lower bound on the date time range. If this field is not set then {@code endDateTime} must be specified.
           • endDateTime - optional; type DateTime
             Represents a date combined with the time of day.
             • date - optional; type Date
               Represents a date.
               • year - optional; type int
                 Year (e.g., 2009)
               • month - optional; type int
                 Month (1..12)
               • day - optional; type int
                 Day (1..31)
             • hour - optional; type int
             • minute - optional; type int
             • second - optional; type int
             • timeZoneId - optional; type string
             The end date time of this range. This field is optional and if it is not set then there is no upper bound on the date time range. If this field is not set then {@code startDateTime} must be specified.
         Specifies the dates and time ranges that are targeted by the {@link LineItem}. This attribute is optional.
       • technologyTargeting - optional; type TechnologyTargeting
         Provides {@link LineItem} objects the ability to target or exclude technologies.
         • bandwidthGroupTargeting - optional; type BandwidthGroupTargeting
           The bandwidth groups being targeted by the {@link LineItem}.
           Represents bandwidth groups that are being targeted or excluded by the {@link LineItem}.
           • isTargeted - optional; type boolean
             Indicates whether bandwidth groups should be targeted or excluded. This attribute is optional and defaults to {@code true}.
           • bandwidthGroups - optional, unbounded; type Technology
             The bandwidth groups that are being targeted or excluded by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
         • browserTargeting - optional; type BrowserTargeting
           The browsers being targeted by the {@link LineItem}.
           Represents browsers that are being targeted or excluded by the {@link LineItem}.
           • isTargeted - optional; type boolean
             Indicates whether browsers should be targeted or excluded. This attribute is optional and defaults to {@code true}.
           • browsers - optional, unbounded; type Technology
             Browsers that are being targeted or excluded by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
         • browserLanguageTargeting - optional; type BrowserLanguageTargeting
           The languages of browsers being targeted by the {@link LineItem}.
           Represents browser languages that are being targeted or excluded by the {@link LineItem}.
           • isTargeted - optional; type boolean
             Indicates whether browsers languages should be targeted or excluded. This attribute is optional and defaults to {@code true}.
           • browserLanguages - optional, unbounded; type Technology
             Browser languages that are being targeted or excluded by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
         • deviceCapabilityTargeting - optional; type DeviceCapabilityTargeting
           The device capabilities being targeted by the {@link LineItem}.
           Represents device capabilities that are being targeted or excluded by the {@link LineItem}.
           • targetedDeviceCapabilities - optional, unbounded; type Technology
             Device capabilities that are being targeted by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
           • excludedDeviceCapabilities - optional, unbounded; type Technology
             Device capabilities that are being excluded by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
         • deviceCategoryTargeting - optional; type DeviceCategoryTargeting
           The device categories being targeted by the {@link LineItem}.
           Represents device categories that are being targeted or excluded by the {@link LineItem}.
           • targetedDeviceCategories - optional, unbounded; type Technology
             Device categories that are being targeted by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
           • excludedDeviceCategories - optional, unbounded; type Technology
             Device categories that are being excluded by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
         • deviceManufacturerTargeting - optional; type DeviceManufacturerTargeting
           The device manufacturers being targeted by the {@link LineItem}.
           Represents device manufacturer that are being targeted or excluded by the {@link LineItem}.
           • isTargeted - optional; type boolean
             Indicates whether device manufacturers should be targeted or excluded. This attribute is optional and defaults to {@code true}.
           • deviceManufacturers - optional, unbounded; type Technology
             Device manufacturers that are being targeted or excluded by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
         • mobileCarrierTargeting - optional; type MobileCarrierTargeting
           The mobile carriers being targeted by the {@link LineItem}.
           Represents mobile carriers that are being targeted or excluded by the {@link LineItem}.
           • isTargeted - optional; type boolean
             Indicates whether mobile carriers should be targeted or excluded. This attribute is optional and defaults to {@code true}.
           • mobileCarriers - optional, unbounded; type Technology
             Mobile carriers that are being targeted or excluded by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
         • mobileDeviceTargeting - optional; type MobileDeviceTargeting
           The mobile devices being targeted by the {@link LineItem}.
           Represents mobile devices that are being targeted or excluded by the {@link LineItem}.
           • targetedMobileDevices - optional, unbounded; type Technology
             Mobile devices that are being targeted by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
           • excludedMobileDevices - optional, unbounded; type Technology
             Mobile devices that are being excluded by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
         • mobileDeviceSubmodelTargeting - optional; type MobileDeviceSubmodelTargeting
           The mobile device submodels being targeted by the {@link LineItem}.
           Represents mobile devices that are being targeted or excluded by the {@link LineItem}.
           • targetedMobileDeviceSubmodels - optional, unbounded; type Technology
             Mobile device submodels that are being targeted by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
           • excludedMobileDeviceSubmodels - optional, unbounded; type Technology
             Mobile device submodels that are being excluded by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
         • operatingSystemTargeting - optional; type OperatingSystemTargeting
           The operating systems being targeted by the {@link LineItem}.
           Represents operating systems that are being targeted or excluded by the {@link LineItem}.
           • isTargeted - optional; type boolean
             Indicates whether operating systems should be targeted or excluded. This attribute is optional and defaults to {@code true}.
           • operatingSystems - optional, unbounded; type Technology
             Operating systems that are being targeted or excluded by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
         • operatingSystemVersionTargeting - optional; type OperatingSystemVersionTargeting
           The operating system versions being targeted by the {@link LineItem}.
           Represents operating system versions that are being targeted or excluded by the {@link LineItem}.
           • targetedOperatingSystemVersions - optional, unbounded; type Technology
             Operating system versions that are being targeted by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
           • excludedOperatingSystemVersions - optional, unbounded; type Technology
             Operating system versions that are being excluded by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
         Specifies the browsing technologies that are targeted by the {@link LineItem}. This attribute is optional.
       • customTargeting - optional; type CustomCriteriaSet - extension of abstract type CustomCriteriaNode
         A {@link CustomCriteriaSet} comprises of a set of {@link CustomCriteriaNode} objects combined by the {@link CustomCriteriaSet.LogicalOperator#logicalOperator}. The custom criteria targeting tree is subject to the rules defined on {@link Targeting#customTargeting}.
         A {@link CustomCriteriaNode} is a node in the custom targeting tree. A custom criteria node can either be a {@link CustomCriteriaSet} (a non-leaf node) or a {@link CustomCriteria} (a leaf node). The custom criteria targeting tree is subject to the rules defined on {@link Targeting#customTargeting}.
         • logicalOperator - optional; type CustomCriteriaSet.LogicalOperator - type string with restriction - enum { 'AND', 'OR' }
           The logical operator to be applied to {@link CustomCriteriaSet#children}. This attribute is required. This attribute is required.
         • children - optional, unbounded; type CustomCriteriaNode
           The custom criteria. This attribute is required.
           A {@link CustomCriteriaNode} is a node in the custom targeting tree. A custom criteria node can either be a {@link CustomCriteriaSet} (a non-leaf node) or a {@link CustomCriteria} (a leaf node). The custom criteria targeting tree is subject to the rules defined on {@link Targeting#customTargeting}.
           Specifies the collection of custom criteria that is targeted by the {@link LineItem}.

           Once the {@link LineItem} is updated or modified with custom targeting, the server may return a normalized, but equivalent representation of the custom targeting expression.

           {@code customTargeting} will have up to three levels of expressions including itself.

           The top level {@code CustomCriteriaSet} i.e. the {@code customTargeting} object can only contain a {@link CustomCriteriaSet.LogicalOperator#OR} of all its children.

           The second level of {@code CustomCriteriaSet} objects can only contain {@link CustomCriteriaSet.LogicalOperator#AND} of all their children. If a {@link CustomCriteria} is placed on this level, the server will wrap it in a {@link CustomCriteriaSet}.

           The third level can only comprise of {@link CustomCriteria} objects.

           The resulting custom targeting tree would be of the form:
           

         • userDomainTargeting - optional; type UserDomainTargeting
           Specifies the domains or subdomains that are targeted or excluded by the {@link LineItem}. Users visiting from an IP address associated with those domains will be targeted or excluded. This attribute is optional.
           Provides line items the ability to target or exclude users visiting their websites from a list of domains or subdomains.
           • domains - optional, unbounded; type string
             The domains or subdomains that are being targeted or excluded by the {@link LineItem}. This attribute is required and the maximum length of each domain is 67 characters.
           • targeted - optional; type boolean
             Indicates whether domains should be targeted or excluded. This attribute is optional and defaults to {@code true}.
         • contentTargeting - optional; type ContentTargeting
           Used to target {@link LineItem}s to specific videos on a publisher's site.
           • targetedContentIds - optional, unbounded; type long
             The IDs of content being targeted by the {@code LineItem}.
           • excludedContentIds - optional, unbounded; type long
             The IDs of content being excluded by the {@code LineItem}.
           • targetedVideoContentBundleIds - optional, unbounded; type long
             A list of video content bundles, represented by {@link ContentBundle} IDs, that are being targeted by the {@code LineItem}.
           • excludedVideoContentBundleIds - optional, unbounded; type long
             A list of video content bundles, represented by {@link ContentBundle} IDs, that are being excluded by the {@code LineItem}.
           Specifies the video categories and individual videos targeted by the {@link LineItem}.
         • videoPositionTargeting - optional; type VideoPositionTargeting
           Specifies targeting against video position types.
           Represents positions within and around a video where ads can be targeted to.

           Example positions could be {@code pre-roll} (before the video plays), {@code post-roll} (after a video has completed playback) and {@code mid-roll} (during video playback).

           Empty video position targeting means that all video positions are allowed. If a bumper line item has empty video position targeting it will be updated to target all bumper positions.

           • targetedPositions - optional, unbounded; type VideoPositionTarget
             The {@link VideoTargetingPosition} objects being targeted by the video {@link LineItem}.
             Represents the options for targetable positions within a video.
             • videoPosition - optional; type VideoPosition
               Represents a targetable position within a video. A video ad can be targeted to a position (pre-roll, all mid-rolls, or post-roll), or to a specific mid-roll index.
               • positionType - optional; type VideoPosition.Type - type string with restriction - enum { 'UNKNOWN', 'ALL', 'PREROLL', 'MIDROLL', 'POSTROLL' }
                 The type of video position (pre-roll, mid-roll, or post-roll).
               • midrollIndex - optional; type int
                 The index of the mid-roll to target. Only valid if the {@link positionType} is {@link VideoPositionType#MIDROLL}, otherwise this field will be ignored.
               The video position to target. This attribute is required.
             • videoBumperType - optional; type VideoBumperType - type string with restriction - enum { 'BEFORE', 'AFTER' }
               The video bumper type to target. To target a video position or a pod position, this value must be null. To target a bumper position this value must be populated and the line item must have a bumper type. To target a custom ad spot, this value must be null.
             • videoPositionWithinPod - optional; type VideoPositionWithinPod
               Represents a targetable position within a pod within a video stream. A video ad can be targeted to any position in the pod (first, second, third ... last). If there is only 1 ad in a pod, either first or last will target that position.
               • index - optional; type int
                 The specific index of the pod. The index is defined as:

                 • 1 = first
                 • 2 = second
                 • 3 = third
                 • ....
                 • 100 = last

                 100 will always be the last position. For example, for a pod with 5 positions, 100 would target position 5. Multiple targets against the index 100 can exist.
                 Positions over 100 are not supported.
               The video position within a pod to target. To target a video position or a bumper position, this value must be null. To target a position within a pod this value must be populated. To target a custom ad spot, this value must be null.
             • adSpotId - optional; type long
               A custom spot {@link AdSpot} to target. To target a video position, a bumper type or a video position within a pod this value must be null.
         • mobileApplicationTargeting - optional; type MobileApplicationTargeting
           Provides the ability to target or exclude users' mobile applications.
           • mobileApplicationIds - optional, unbounded; type long
             The {@link MobileApplication#id IDs} that are being targeted or excluded.
           • isTargeted - optional; type boolean
             Indicates whether mobile apps should be targeted or excluded. This attribute is optional and defaults to {@code true}.
           Specifies targeting against mobile applications.
         • buyerUserListTargeting - optional; type BuyerUserListTargeting
           The {@code BuyerUserListTargeting} associated with a programmatic {@link LineItem} or {@link ProposalLineItem} object.
           • hasBuyerUserListTargeting - optional; type boolean
             Whether the programmatic {@code LineItem} or {@code ProposalLineItem} object has buyer user list targeting.
           Specifies whether buyer user lists are targeted on a programmatic {@link LineItem} or {@link ProposalLineItem}. This attribute is readonly and is populated by Google.
         • inventoryUrlTargeting - optional; type InventoryUrlTargeting
           A collection of targeted inventory urls.
           • targetedUrls - optional, unbounded; type InventoryUrl
             The representation of an inventory Url that is used in targeting.
             • id - optional; type long
           • excludedUrls - optional, unbounded; type InventoryUrl
             The representation of an inventory Url that is used in targeting.
             • id - optional; type long
           Specifies the URLs that are targeted by the entity. This is currently only supported by {@link YieldGroup}.
         • verticalTargeting - optional; type VerticalTargeting
           Specifies the verticals that are targeted by the entity. The IDs listed here correspond to the IDs in the AD_CATEGORY table of type VERTICAL.
           Vertical targeting information.
           • targetedVerticalIds - optional, unbounded; type long
           • excludedVerticalIds - optional, unbounded; type long
         • contentLabelTargeting - optional; type ContentLabelTargeting
           Content label targeting information.
           • excludedContentLabelIds - optional, unbounded; type long
           Specifies the content labels that are excluded by the entity. The IDs listed here correspond to the IDs in the CONTENT_LABEL table.
         • requestPlatformTargeting - optional; type RequestPlatformTargeting
           Provides line items the ability to target the platform that requests and renders the ad.

           The following rules apply for {@link RequestPlatformTargeting}

           • {@link RequestPlatformTargeting} must be specified for {@link ProposalLineItem}s.
           • {@link RequestPlatformTargeting} must be specified for video line items. Empty values for {@link RequestPlatformTargeting#targetedRequestPlatforms} mean that all request platforms will be targeted.
           • {@link RequestPlatformTargeting} is read-only and assigned by Google for non-video line items.
           • {@link RequestPlatformTargeting} is read-only and assigned by Google for line items generated from proposal line items.
           • targetedRequestPlatforms - optional, unbounded; type RequestPlatform - type string with restriction - enum { 'UNKNOWN', 'BROWSER', 'MOBILE_APP', 'VIDEO_PLAYER' }
           Specifies the request platforms that are targeted by the {@link LineItem}. This attribute is required for video line items and for {@link ProposalLineItem}.

           This value is modifiable for video line items, but read-only for non-video line items.

           This value is read-only for video line items generated from proposal line items.

         • inventorySizeTargeting - optional; type InventorySizeTargeting
           Represents a collection of targeted and excluded inventory sizes. This is currently only available on {@link YieldGroup} and {@link TrafficDataRequest}.
           • isTargeted - optional; type boolean
             Whether the inventory sizes should be targeted or excluded.
           • targetedSizes - optional, unbounded; type TargetedSize
             A list of {@link TargetedSizeDto}s.
             A size that is targeted on a request.
             • size - optional; type Size
               Represents the dimensions of an {@link AdUnit}, {@link LineItem} or {@link Creative}.

               For interstitial size (out-of-page), native, ignored and fluid size, {@link Size} must be 1x1.

               • width - optional; type int
                 The width of the {@link AdUnit}, {@link LineItem} or {@link Creative}.
               • height - optional; type int
                 The height of the {@link AdUnit}, {@link LineItem} or {@link Creative}.
               • isAspectRatio - optional; type boolean
                 Whether this size represents an aspect ratio.
           Specifies the sizes that are targeted by the entity. This is currently only supported on {@link YieldGroup} and {@link TrafficDataRequest}.
         • customFieldValues - optional, unbounded; type BaseCustomFieldValue
           The value of a {@link CustomField} for a particular entity.
           • customFieldId - optional; type long
             Id of the {@code CustomField} to which this value belongs. This attribute is required.
           The values of the custom fields associated with the {@code ProposalLineItem}. This attribute is optional. This attribute can be configured as editable after the proposal has been submitted. Please check with your network administrator for editable fields configuration.
         • appliedLabels - optional, unbounded; type AppliedLabel
           Represents a {@link Label} that can be applied to an entity. To negate an inherited label, create an {@code AppliedLabel} with {@code labelId} as the inherited label's ID and {@code isNegated} set to true.
           • labelId - optional; type long
             The ID of a created {@link Label}.
           • isNegated - optional; type boolean
             {@code isNegated} should be set to {@code true} to negate the effects of {@code labelId}.
           The set of labels applied directly to the {@code ProposalLineItem}. This attribute is optional.
         • effectiveAppliedLabels - optional, unbounded; type AppliedLabel
           Represents a {@link Label} that can be applied to an entity. To negate an inherited label, create an {@code AppliedLabel} with {@code labelId} as the inherited label's ID and {@code isNegated} set to true.
           • labelId - optional; type long
             The ID of a created {@link Label}.
           • isNegated - optional; type boolean
             {@code isNegated} should be set to {@code true} to negate the effects of {@code labelId}.
           Contains the set of labels applied directly to the proposal as well as those inherited ones. If a label has been negated, only the negated label is returned. This attribute is read-only.
         • disableSameAdvertiserCompetitiveExclusion - optional; type 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 {@code true} will allow line items from the same advertiser to serve regardless of the other competitive exclusion labels being applied.

           This attribute is optional and defaults to false.

         • isSold - optional; type boolean
           Indicates whether this {@code ProposalLineItem} has been sold. This attribute is read-only.
         • netRate - optional; type Money
           Represents a money amount.
           • currencyCode - optional; type string
             Three letter currency code in string format.
           • microAmount - optional; type long
             Money values are always specified in terms of micros which are a millionth of the fundamental currency unit. For US dollars, $1 is 1,000,000 micros.
           The amount of money to spend per impression or click in proposal currency. It supports precision of 4 decimal places in terms of the fundamental currency unit, so the {@link Money#getAmountInMicros} must be multiples of 100. It doesn't include agency commission.

           For example, if {@link Proposal#currencyCode} is 'USD', then $123.4567 could be represented as 123456700, but further precision is not supported.

           The field {@link ProposalLineItem#netRate} is required, and used to calculate {@link ProposalLineItem#netCost} if unspecified.

         • netCost - optional; type Money
           Represents a money amount.
           • currencyCode - optional; type string
             Three letter currency code in string format.
           • microAmount - optional; type long
             Money values are always specified in terms of micros which are a millionth of the fundamental currency unit. For US dollars, $1 is 1,000,000 micros.
           The cost of the {@code ProposalLineItem} in proposal currency. It supports precision of 2 decimal places in terms of the fundamental currency unit, so the {@link Money#getAmountInMicros} must be multiples of 10000. It doesn't include agency commission.

           For example, if {@link Proposal#currencyCode} is 'USD', then $123.45 could be represented as 123450000, but further precision is not supported.

           The field {@link ProposalLineItem#netRate} is required, and used to calculate {@link ProposalLineItem#netCost} if unspecified.

         • deliveryIndicator - optional; type DeliveryIndicator
           Indicates the delivery performance of the {@link LineItem}.
           • expectedDeliveryPercentage - optional; type double
             How much the {@code LineItem} was expected to deliver as a percentage of {@link LineItem#primaryGoal}.
           • actualDeliveryPercentage - optional; type double
             How much the line item actually delivered as a percentage of {@link LineItem#primaryGoal}.
           Indicates how well the line item generated from this proposal line item has been performing. This will be {@code null} if the delivery indicator information is not available due to one of the following reasons:

           1. The proposal line item has not pushed to Ad Manager.
           2. The line item is not delivering.
           3. The line item has an unlimited goal or cap.
           4. The line item has a percentage based goal or cap.

           This attribute is read-only.
         • deliveryData - optional; type DeliveryData
           Holds the number of clicks or impressions, determined by {@link LineItem#costType}, delivered for a single line item for the last 7 days
           • units - optional, unbounded; type long
             Clicks or impressions delivered for the last 7 days.
           Delivery data provides the number of clicks or impressions delivered for the {@link LineItem} generated from this proposal line item in the last 7 days. This will be {@code null} if the delivery data cannot be computed due to one of the following reasons:

           1. The proposal line item has not pushed to Ad Manager.
           2. The line item is not deliverable.
           3. The line item has completed delivering more than 7 days ago.
           4. The line item has an absolute-based goal. {@link ProposalLineItem#deliveryIndicator} should be used to track its progress in this case. This attribute is read-only.
         • computedStatus - optional; type ComputedStatus - type string with restriction - enum { 'DELIVERY_EXTENDED', 'DELIVERING', 'READY', 'PAUSED', 'INACTIVE', 'PAUSED_INVENTORY_RELEASED', 'PENDING_APPROVAL', 'COMPLETED', 'DISAPPROVED', 'DRAFT', 'CANCELED' }
           The status of the {@link LineItem} generated from this proposal line item. This will be {@code null} if the proposal line item has not pushed to Ad Manager. This attribute is read-only.
         • lastModifiedDateTime - optional; type DateTime
           Represents a date combined with the time of day.
           • date - optional; type Date
             Represents a date.
             • year - optional; type int
               Year (e.g., 2009)
             • month - optional; type int
               Month (1..12)
             • day - optional; type int
               Day (1..31)
           • hour - optional; type int
           • minute - optional; type int
           • second - optional; type int
           • timeZoneId - optional; type string
           The date and time this {@code ProposalLineItem} was last modified.

           This attribute is assigned by Google when a {@code ProposalLineItem} is updated. This attribute is read-only.

         • reservationStatus - optional; type ReservationStatus - type string with restriction - enum { 'RESERVED', 'NOT_RESERVED', 'RELEASED', 'CHECK_LINE_ITEM_RESERVATION_STATUS', 'UNKNOWN' }
           The reservation status of the {@link ProposalLineItem}. This attribute is read-only.
         • lastReservationDateTime - optional; type DateTime
           Represents a date combined with the time of day.
           • date - optional; type Date
             Represents a date.
             • year - optional; type int
               Year (e.g., 2009)
             • month - optional; type int
               Month (1..12)
             • day - optional; type int
               Day (1..31)
           • hour - optional; type int
           • minute - optional; type int
           • second - optional; type int
           • timeZoneId - optional; type string
           The last {@link DateTime} when the {@link ProposalLineItem} reserved inventory. This attribute is read-only.
         • environmentType - optional; type EnvironmentType - type string with restriction - enum { 'BROWSER', 'VIDEO_PLAYER' }
           The environment that the {@code ProposalLineItem} is targeting. The default value is {@link EnvironmentType#BROWSER}. If this value is {@link EnvironmentType#VIDEO_PLAYER}, then this {@code ProposalLineItem} can only target {@link AdUnit ad units} that have {@link AdUnitSize sizes} whose {@link AdUnitSize#environmentType} is also {@link EnvironmentType#VIDEO_PLAYER}.

           This field is read-only and set to {@link Product#environmentType} of the product this proposal line item was created from.

         • allowedFormats - optional, unbounded; type AllowedFormats - type string with restriction - enum { 'AUDIO', 'UNKNOWN' }
           The set of {@link AllowedFormats} that this proposal line item can have. If the set is empty, this proposal line item allows all formats.
         • additionalTerms - optional; type string
           Additional terms shown to the buyer in Marketplace.
         • programmaticCreativeSource - optional; type ProgrammaticCreativeSource - type string with restriction - enum { 'PUBLISHER', 'ADVERTISER', 'UNKNOWN' }
           Indicates the {@link ProgrammaticCreativeSource} of the programmatic line item.
         • grpSettings - optional; type GrpSettings
           {@code GrpSettings} contains information for a line item that will have a target demographic when serving. This information will be used to set up tracking and enable reporting on the demographic information.
           • minTargetAge - optional; type long
             Specifies the minimum target age (in years) of the {@link LineItem}. This field is only applicable if {@link #provider} is not null.
           • maxTargetAge - optional; type long
             Specifies the maximum target age (in years) of the {@link LineItem}. This field is only applicable if {@link #provider} is not null.
           • targetGender - optional; type GrpTargetGender - type string with restriction - enum { 'UNKNOWN', 'MALE', 'FEMALE', 'BOTH' }
             Specifies the target gender of the {@link LineItem}. This field is only applicable if {@link #provider} is not null.
           • provider - optional; type GrpProvider - type string with restriction - enum { 'UNKNOWN', 'NIELSEN' }
             Specifies the GRP provider of the {@link LineItem}.
           • inTargetRatioEstimateMilliPercent - optional; type long
             Estimate for the in-target ratio given the line item's audience targeting. This field is only applicable if {@link #provider} is Nielsen, {@link LineItem#primaryGoal#unitType} is in-target impressions, and {@link LineItem#CostType} is in-target CPM. This field determines the in-target ratio to use for pacing Nielsen line items before Nielsen reporting data is available. Represented as a milli percent, so 55.7% becomes 55700.
           • nielsenCtvPacingType - optional; type NielsenCtvPacingType - type string with restriction - enum { 'UNKNOWN', 'NONE', 'COVIEW', 'STRICT_COVIEW' }
             Specifies which pacing computation to apply in pacing to impressions from connected devices. This field is required if {@code enableNielsenCoViewingSupport} is true.
           • pacingDeviceCategorizationType - optional; type PacingDeviceCategorizationType - type string with restriction - enum { 'UNKNOWN', 'GOOGLE', 'NIELSEN' }
             Specifies whether to use Google or Nielsen device breakdown in Nielsen Line Item auto pacing.
           • applyTrueCoview - optional; type boolean
             Specifies whether to apply true coviewing in Nielsen Line Item auto pacing. This field can only be true if NielsenCtvPacingType is not NONE.
           Contains the information for a proposal line item which has a target GRP demographic.
         • estimatedMinimumImpressions - optional; type long
           The estimated minimum impressions that should be delivered for a proposal line item.
         • thirdPartyMeasurementSettings - optional; type ThirdPartyMeasurementSettings
           Contains third party measurement settings for cross-sell Partners
           Contains third party auto-pixeling settings for cross-sell Partners.
           • viewabilityPartner - optional; type ThirdPartyViewabilityIntegrationPartner - type string with restriction - enum { 'NONE', 'MOAT', 'DOUBLE_VERIFY', 'INTEGRAL_AD_SCIENCE', 'COMSCORE', 'TELEMETRY', 'UNKNOWN' }
             A field to determine the type of ThirdPartyViewabilityIntegrationPartner. This field default is NONE.
           • viewabilityClientId - optional; type string
             The third party partner id for YouTube viewability verification.
           • viewabilityReportingId - optional; type string
             The reporting id that maps viewability partner data with a campaign (or a group of related campaigns) specific data.
           • publisherViewabilityPartner - optional; type ThirdPartyViewabilityIntegrationPartner - type string with restriction - enum { 'NONE', 'MOAT', 'DOUBLE_VERIFY', 'INTEGRAL_AD_SCIENCE', 'COMSCORE', 'TELEMETRY', 'UNKNOWN' }
             A field to determine the type of publisher's viewability partner. This field default is NONE.
           • publisherViewabilityClientId - optional; type string
             The third party partner id for YouTube viewability verification for publisher.
           • publisherViewabilityReportingId - optional; type string
             The reporting id that maps viewability partner data with a campaign (or a group of related campaigns) specific data for publisher.
           • brandLiftPartner - optional; type ThirdPartyBrandLiftIntegrationPartner - type string with restriction - enum { 'UNKNOWN', 'NONE', 'KANTAR_MILLWARD_BROWN', 'DYNATA', 'INTAGE', 'MACROMILL' }
             A field to determine the type of ThirdPartyBrandLiftIntegrationPartner. This field default is NONE.
           • brandLiftClientId - optional; type string
             The third party partner id for YouTube brand lift verification.
           • brandLiftReportingId - optional; type string
             The reporting id that maps brand lift partner data with a campaign (or a group of related campaigns) specific data.
           • reachPartner - optional; type ThirdPartyReachIntegrationPartner - type string with restriction - enum { 'NONE', 'COMSCORE', 'NIELSEN', 'KANTAR_MILLWARD_BROWN', 'VIDEO_RESEARCH', 'GEMIUS', 'VIDEO_AMP', 'ISPOT_TV', 'AUDIENCE_PROJECT', 'UNKNOWN' }
             A field to determine the type of advertiser's ThirdPartyReachIntegrationPartner. This field default is UNKNOWN.
           • reachClientId - optional; type string
             The third party partner id for YouTube reach verification for advertiser.
           • reachReportingId - optional; type string
             The reporting id that maps reach partner data with a campaign (or a group of related campaigns) specific data for advertiser.
           • publisherReachPartner - optional; type ThirdPartyReachIntegrationPartner - type string with restriction - enum { 'NONE', 'COMSCORE', 'NIELSEN', 'KANTAR_MILLWARD_BROWN', 'VIDEO_RESEARCH', 'GEMIUS', 'VIDEO_AMP', 'ISPOT_TV', 'AUDIENCE_PROJECT', 'UNKNOWN' }
             A field to determine the type of publisher's ThirdPartyReachIntegrationPartner. This field default is UNKNOWN.
           • publisherReachClientId - optional; type string
             The third party partner id for YouTube reach verification for publisher.
           • publisherReachReportingId - optional; type string
             The reporting id that maps reach partner data with a campaign (or a group of related campaigns) specific data for publisher.
         • makegoodInfo - optional; type ProposalLineItemMakegoodInfo
           Makegood info for this proposal line item. Immutable once created.

           Null if this proposal line item is not a makegood.

           Makegood info for a {@link ProposalLineItemDto}.
           • originalProposalLineItemId - optional; type long
             The ID of the original proposal line item on which this makegood is based. This attribute is read-only.
           • reason - optional; type string
             The publisher-provided reason why this makegood was initiated. This is free form text.

             The following predefined values can be used to render predefined options in the UI.

             UNDERDELIVERY: 'Impression underdelivery', SECONDARY_DELIVERY_TERMS: 'Did not meet secondary delivery terms ', PERFORMANCE: 'Performance issues',

         • hasMakegood - optional; type boolean
           Whether this proposal line item has an associated makegood. This attribute is read-only.
         • canCreateMakegood - optional; type boolean
           Whether a new makegood associated with this line item can be created. This attribute is read-only.
         • pauseRole - optional; type NegotiationRole - type string with restriction - enum { 'BUYER', 'SELLER', 'UNKNOWN' }
           The {@link NegotiationRole} that paused the proposal line item, i.e. {@link NegotiationRole#seller} or {@link NegotiationRole#buyer}, or {@code null} when the proposal is not paused. This attribute is read-only.
         • pauseReason - optional; type string
           The reason for pausing the {@link ProposalLineItem}, provided by the {@link pauseRole}. It is {@code null} when the {@link ProposalLineItem} is not paused. This attribute is read-only.
   Output:
   createProposalLineItemsResponse (wsdlsoap:header, use = literal, part = ResponseHeader)Source code
   parameters type createProposalLineItemsResponse

   • rval - optional, unbounded; type ProposalLineItem
     A {@code ProposalLineItem} is added to a programmatic {@link Proposal} and is similar to a delivery {@link LineItem}. It contains delivery details including information like impression goal or quantity, start and end times, and targeting.
     • id - optional; type long
       The unique ID of the {@code ProposalLineItem}. This attribute is read-only.
     • proposalId - optional; type long
       The unique ID of the {@link Proposal}, to which the {@code ProposalLineItem} belongs. This attribute is required for creation and then is readonly. This attribute is required.
     • name - optional; type string
       The name of the {@code ProposalLineItem} which should be unique under the same {@link Proposal}. This attribute has a maximum length of 255 characters. This attribute can be configured as editable after the proposal has been submitted. Please check with your network administrator for editable fields configuration. This attribute is required.
     • startDateTime - optional; type DateTime
       Represents a date combined with the time of day.
       • date - optional; type Date
         Represents a date.
         • year - optional; type int
           Year (e.g., 2009)
         • month - optional; type int
           Month (1..12)
         • day - optional; type int
           Day (1..31)
       • hour - optional; type int
       • minute - optional; type int
       • second - optional; type int
       • timeZoneId - optional; type string
       The date and time at which the line item associated with the {@code ProposalLineItem} is enabled to begin serving. This attribute is optional during creation, but required and must be in the future when it turns into a line item. The {@link DateTime#timeZoneID} is required if start date time is not {@code null}. This attribute becomes readonly once the {@code ProposalLineItem} has started delivering.
     • endDateTime - optional; type DateTime
       Represents a date combined with the time of day.
       • date - optional; type Date
         Represents a date.
         • year - optional; type int
           Year (e.g., 2009)
         • month - optional; type int
           Month (1..12)
         • day - optional; type int
           Day (1..31)
       • hour - optional; type int
       • minute - optional; type int
       • second - optional; type int
       • timeZoneId - optional; type string
       The date and time at which the line item associated with the {@code ProposalLineItem} stops beening served. This attribute is optional during creation, but required and must be after the {@link #startDateTime}. The {@link DateTime#timeZoneID} is required if end date time is not {@code null}.
     • internalNotes - optional; type string
       Provides any additional notes that may annotate the {@code ProposalLineItem}. This attribute is optional and has a maximum length of 65,535 characters. This attribute can be configured as editable after the proposal has been submitted. Please check with your network administrator for editable fields configuration.
     • isArchived - optional; type boolean
       The archival status of the {@code ProposalLineItem}. This attribute is read-only.
     • goal - optional; type Goal
       Defines the criteria a {@link LineItem} needs to satisfy to meet its delivery goal.
       • goalType - optional; type GoalType - type string with restriction - enum { 'NONE', 'LIFETIME', 'DAILY', 'UNKNOWN' }
         The type of the goal for the {@code LineItem}. It defines the period over which the goal for {@code LineItem} should be reached.
       • unitType - optional; type UnitType - type string with restriction - enum { 'IMPRESSIONS', 'CLICKS', 'CLICK_THROUGH_CPA_CONVERSIONS', 'VIEW_THROUGH_CPA_CONVERSIONS', 'TOTAL_CPA_CONVERSIONS', 'VIEWABLE_IMPRESSIONS', 'IN_TARGET_IMPRESSIONS', 'UNKNOWN' }
         The type of the goal unit for the {@code LineItem}.
       • units - optional; type long
         If this is a primary goal, it represents the number or percentage of impressions or clicks that will be reserved for the {@code LineItem}. If the line item is of type {@link LineItemType#SPONSORSHIP}, it represents the percentage of available impressions reserved. If the line item is of type {@link LineItemType#BULK} or {@link LineItemType#PRICE_PRIORITY}, it represents the number of remaining impressions reserved. If the line item is of type {@link LineItemType#NETWORK} or {@link LineItemType#HOUSE}, it represents the percentage of remaining impressions reserved.

         If this is a secondary goal, it represents the number of impressions or conversions that the line item will stop serving at if reached. For valid line item types, see {@link LineItem#secondaryGoals}.

       The goal(i.e. contracted quantity, quantity or limit) that this {@code ProposalLineItem} is associated with, which is used in its pacing and budgeting. {@link Goal#units} must be greater than 0 when the proposal line item turns into a line item, {@link Goal#goalType} and {@link Goal#unitType} are readonly. For a Preferred deal {@code ProposalLineItem}, the goal type can only be {@link GoalType#NONE}. This attribute is required.
     • secondaryGoals - optional, unbounded; type Goal
       Defines the criteria a {@link LineItem} needs to satisfy to meet its delivery goal.
       • goalType - optional; type GoalType - type string with restriction - enum { 'NONE', 'LIFETIME', 'DAILY', 'UNKNOWN' }
         The type of the goal for the {@code LineItem}. It defines the period over which the goal for {@code LineItem} should be reached.
       • unitType - optional; type UnitType - type string with restriction - enum { 'IMPRESSIONS', 'CLICKS', 'CLICK_THROUGH_CPA_CONVERSIONS', 'VIEW_THROUGH_CPA_CONVERSIONS', 'TOTAL_CPA_CONVERSIONS', 'VIEWABLE_IMPRESSIONS', 'IN_TARGET_IMPRESSIONS', 'UNKNOWN' }
         The type of the goal unit for the {@code LineItem}.
       • units - optional; type long
         If this is a primary goal, it represents the number or percentage of impressions or clicks that will be reserved for the {@code LineItem}. If the line item is of type {@link LineItemType#SPONSORSHIP}, it represents the percentage of available impressions reserved. If the line item is of type {@link LineItemType#BULK} or {@link LineItemType#PRICE_PRIORITY}, it represents the number of remaining impressions reserved. If the line item is of type {@link LineItemType#NETWORK} or {@link LineItemType#HOUSE}, it represents the percentage of remaining impressions reserved.

         If this is a secondary goal, it represents the number of impressions or conversions that the line item will stop serving at if reached. For valid line item types, see {@link LineItem#secondaryGoals}.

       The secondary goals that this {@code ProposalLineItem} is associated with. For a programmatic line item with the properties {@link RateType#CPM} and {@link LineItemType#SPONSORSHIP}, this field will have one goal which describes the impressions cap. For other cases, this field is an empty list.
     • contractedUnitsBought - optional; type long
       The contracted number of daily minimum impressions used for {@link LineItemType#SPONSORSHIP} {@code ProposalLineItem} deals with a rate type of {@link RateType#CPD}.

       This attribute is required for percentage-based-goal {@link ProposalLineItem proposal line items}. It does not impact ad-serving and is for reporting purposes only.

     • deliveryRateType - optional; type DeliveryRateType - type string with restriction - enum { 'EVENLY', 'FRONTLOADED', 'AS_FAST_AS_POSSIBLE' }
       The strategy for delivering ads over the course of the {@code ProposalLineItem}'s duration. This attribute is required. For a Preferred deal {@code ProposalLineItem}, the value can only be {@link DeliveryRateType#FRONTLOADED}.
     • roadblockingType - optional; type RoadblockingType - type string with restriction - enum { 'ONLY_ONE', 'ONE_OR_MORE', 'AS_MANY_AS_POSSIBLE', 'ALL_ROADBLOCK', 'CREATIVE_SET' }
       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 during creation and defaults to the {@link Product#roadblockingType product's roadblocking type}, or {@link RoadblockingType#ONE_OR_MORE} if not specified by the product.
     • companionDeliveryOption - optional; type CompanionDeliveryOption - type string with restriction - enum { 'OPTIONAL', 'AT_LEAST_ONE', 'ALL', 'UNKNOWN' }
       The delivery option for companions. This is only valid if the roadblocking type is {@link RoadblockingType#CREATIVE_SET}. The default value for roadblocking creatives is {@link CompanionDeliveryOption#OPTIONAL}. The default value in other cases is {@link CompanionDeliveryOption#UNKNOWN}. Providing something other than {@link CompanionDeliveryOption#UNKNOWN} will cause an error.
     • videoMaxDuration - optional; type long
       The max duration of a video creative associated with this {@code ProposalLineItem} in milliseconds. This attribute is optional, defaults to the {@link Product#videoMaxDuration} on the {@link Product} it was created with, and only meaningful if this is a video proposal line item.
     • videoCreativeSkippableAdType - optional; type SkippableAdType - type string with restriction - enum { 'UNKNOWN', 'DISABLED', 'ENABLED', 'INSTREAM_SELECT', 'ANY' }
       The proposal line item's creatives' skippability. This attribute is optional, only applicable for video proposal line items, and defaults to {@link SkippableAdType#NOT_SKIPPABLE}.
     • frequencyCaps - optional, unbounded; type FrequencyCap
       Represents a limit on the number of times a single viewer can be exposed to the same {@link LineItem} in a specified time period.
       • maxImpressions - optional; type int
         The maximum number of impressions than can be served to a user within a specified time period.
       • numTimeUnits - optional; type int
         The number of {@code FrequencyCap#timeUnit} to represent the total time period.
       • timeUnit - optional; type TimeUnit - type string with restriction - enum { 'MINUTE', 'HOUR', 'DAY', 'WEEK', 'MONTH', 'LIFETIME', 'POD', 'STREAM', 'UNKNOWN' }
         The unit of time for specifying the time period.
       The set of frequency capping units for this {@code ProposalLineItem}. This attribute is optional during creation and defaults to the {@link Product#frequencyCaps product's frequency caps} if {@link Product#allowFrequencyCapsCustomization} is {@code false}.
     • dfpLineItemId - optional; type long
       The unique ID of corresponding {@link LineItem}. This will be {@code null} if the {@link Proposal} has not been pushed to Ad Manager. This attribute is read-only.
     • lineItemType - optional; type LineItemType - type string with restriction - enum { 'SPONSORSHIP', 'STANDARD', 'NETWORK', 'BULK', 'PRICE_PRIORITY', 'HOUSE', 'LEGACY_DFP', 'CLICK_TRACKING', 'ADSENSE', 'AD_EXCHANGE', 'BUMPER', 'ADMOB', 'PREFERRED_DEAL', 'UNKNOWN' }
       The corresponding {@link LineItemType} of the {@code ProposalLineItem}. For a programmatic {@code ProposalLineItem}, the value can only be one of:

       • {@link LineItemType#SPONSORSHIP}
       • {@link LineItemType#STANDARD}
       • {@link LineItemType#PREFERRED_DEAL}

       This attribute is required.
     • lineItemPriority - optional; type int
       The priority for the corresponding {@link LineItem} of the {@code ProposalLineItem}. This attribute is optional during creation and defaults to the default priority of the {@link #lineItemType}. For forecasting, this attribute is optional and has a default value assigned by Google. See {@link LineItem#priority} for more information.
     • rateType - optional; type RateType - type string with restriction - enum { 'CPM', 'CPD', 'VCPM', 'CPM_IN_TARGET', 'UNKNOWN' }
       The method used for billing the {@code ProposalLineItem}. This attribute is read-only. This attribute is required.
     • creativePlaceholders - optional, unbounded; type CreativePlaceholder
       A {@code CreativePlaceholder} describes a slot that a creative is expected to fill. This is used primarily to help in forecasting, and also to validate that the correct creatives are associated with the line item. A {@code CreativePlaceholder} must contain a size, and it can optionally contain companions. Companions are only valid if the line item's environment type is {@link EnvironmentType#VIDEO_PLAYER}.
       • size - optional; type Size
         The dimensions that the creative is expected to have. This attribute is required.
         Represents the dimensions of an {@link AdUnit}, {@link LineItem} or {@link Creative}.

         For interstitial size (out-of-page), native, ignored and fluid size, {@link Size} must be 1x1.

         • width - optional; type int
           The width of the {@link AdUnit}, {@link LineItem} or {@link Creative}.
         • height - optional; type int
           The height of the {@link AdUnit}, {@link LineItem} or {@link Creative}.
         • isAspectRatio - optional; type boolean
           Whether this size represents an aspect ratio.
       • creativeTemplateId - optional; type long
         The native creative template ID.

         This value is only required if {@link #creativeSizeType} is {@link CreativeSizeType#NATIVE}.

       • companions - optional, unbounded; type CreativePlaceholder
         A {@code CreativePlaceholder} describes a slot that a creative is expected to fill. This is used primarily to help in forecasting, and also to validate that the correct creatives are associated with the line item. A {@code CreativePlaceholder} must contain a size, and it can optionally contain companions. Companions are only valid if the line item's environment type is {@link EnvironmentType#VIDEO_PLAYER}.
         • size - optional; type Size
           The dimensions that the creative is expected to have. This attribute is required.
           Represents the dimensions of an {@link AdUnit}, {@link LineItem} or {@link Creative}.

           For interstitial size (out-of-page), native, ignored and fluid size, {@link Size} must be 1x1.

           • width - optional; type int
             The width of the {@link AdUnit}, {@link LineItem} or {@link Creative}.
           • height - optional; type int
             The height of the {@link AdUnit}, {@link LineItem} or {@link Creative}.
           • isAspectRatio - optional; type boolean
             Whether this size represents an aspect ratio.
         • creativeTemplateId - optional; type long
           The native creative template ID.

           This value is only required if {@link #creativeSizeType} is {@link CreativeSizeType#NATIVE}.

         • companions - optional, unbounded; type CreativePlaceholder
           A {@code CreativePlaceholder} describes a slot that a creative is expected to fill. This is used primarily to help in forecasting, and also to validate that the correct creatives are associated with the line item. A {@code CreativePlaceholder} must contain a size, and it can optionally contain companions. Companions are only valid if the line item's environment type is {@link EnvironmentType#VIDEO_PLAYER}.
           • size - optional; type Size
             The dimensions that the creative is expected to have. This attribute is required.
             Represents the dimensions of an {@link AdUnit}, {@link LineItem} or {@link Creative}.

             For interstitial size (out-of-page), native, ignored and fluid size, {@link Size} must be 1x1.

             • width - optional; type int
               The width of the {@link AdUnit}, {@link LineItem} or {@link Creative}.
             • height - optional; type int
               The height of the {@link AdUnit}, {@link LineItem} or {@link Creative}.
             • isAspectRatio - optional; type boolean
               Whether this size represents an aspect ratio.
           • creativeTemplateId - optional; type long
             The native creative template ID.

             This value is only required if {@link #creativeSizeType} is {@link CreativeSizeType#NATIVE}.

           • companions - optional, unbounded; type CreativePlaceholder... is recursive
             The companions that the creative is expected to have. This attribute can only be set if the line item it belongs to has a {@link LineItem#environmentType} of {@link EnvironmentType#VIDEO_PLAYER} or {@link LineItem#roadblockingType} of {@link RoadblockingType#CREATIVE_SET}.
           • appliedLabels - optional, unbounded; type AppliedLabel
             Represents a {@link Label} that can be applied to an entity. To negate an inherited label, create an {@code AppliedLabel} with {@code labelId} as the inherited label's ID and {@code isNegated} set to true.
             • labelId - optional; type long
               The ID of a created {@link Label}.
             • isNegated - optional; type boolean
               {@code isNegated} should be set to {@code true} to negate the effects of {@code labelId}.
             The set of label frequency caps applied directly to this creative placeholder.
           • effectiveAppliedLabels - optional, unbounded; type AppliedLabel
             Represents a {@link Label} that can be applied to an entity. To negate an inherited label, create an {@code AppliedLabel} with {@code labelId} as the inherited label's ID and {@code isNegated} set to true.
             • labelId - optional; type long
               The ID of a created {@link Label}.
             • isNegated - optional; type boolean
               {@code isNegated} should be set to {@code true} to negate the effects of {@code labelId}.
             Contains the set of labels applied directly to this creative placeholder as well as those inherited from the creative template from which this creative placeholder was instantiated. This field is readonly and is assigned by Google.
           • expectedCreativeCount - optional; type int
             Expected number of creatives that will be uploaded corresponding to this creative placeholder. This estimate is used to improve the accuracy of forecasting; for example, if label frequency capping limits the number of times a creative may be served.
           • creativeSizeType - optional; type CreativeSizeType - type string with restriction - enum { 'PIXEL', 'ASPECT_RATIO', 'INTERSTITIAL', 'IGNORED', 'NATIVE', 'AUDIO' }
             Describes the types of sizes a creative can be. By default, the creative's size is {@link CreativeSizeType#PIXEL}, which is a dimension based size (width-height pair).
           • targetingName - optional; type string
             The name of the {@link CreativeTargeting} for creatives this placeholder represents.

             This attribute is optional. Specifying creative targeting here is for forecasting purposes only and has no effect on serving. The same creative targeting should be specified on a {@link LineItemCreativeAssociation} when associating a {@link Creative} with the {@link LineItem}.

           • isAmpOnly - optional; type boolean
             Indicate if the expected creative of this placeholder has an AMP only variant.

             This attribute is optional. It is for forecasting purposes only and has no effect on serving.

           The companions that the creative is expected to have. This attribute can only be set if the line item it belongs to has a {@link LineItem#environmentType} of {@link EnvironmentType#VIDEO_PLAYER} or {@link LineItem#roadblockingType} of {@link RoadblockingType#CREATIVE_SET}.
         • appliedLabels - optional, unbounded; type AppliedLabel
           Represents a {@link Label} that can be applied to an entity. To negate an inherited label, create an {@code AppliedLabel} with {@code labelId} as the inherited label's ID and {@code isNegated} set to true.
           • labelId - optional; type long
             The ID of a created {@link Label}.
           • isNegated - optional; type boolean
             {@code isNegated} should be set to {@code true} to negate the effects of {@code labelId}.
           The set of label frequency caps applied directly to this creative placeholder.
         • effectiveAppliedLabels - optional, unbounded; type AppliedLabel
           Represents a {@link Label} that can be applied to an entity. To negate an inherited label, create an {@code AppliedLabel} with {@code labelId} as the inherited label's ID and {@code isNegated} set to true.
           • labelId - optional; type long
             The ID of a created {@link Label}.
           • isNegated - optional; type boolean
             {@code isNegated} should be set to {@code true} to negate the effects of {@code labelId}.
           Contains the set of labels applied directly to this creative placeholder as well as those inherited from the creative template from which this creative placeholder was instantiated. This field is readonly and is assigned by Google.
         • expectedCreativeCount - optional; type int
           Expected number of creatives that will be uploaded corresponding to this creative placeholder. This estimate is used to improve the accuracy of forecasting; for example, if label frequency capping limits the number of times a creative may be served.
         • creativeSizeType - optional; type CreativeSizeType - type string with restriction - enum { 'PIXEL', 'ASPECT_RATIO', 'INTERSTITIAL', 'IGNORED', 'NATIVE', 'AUDIO' }
           Describes the types of sizes a creative can be. By default, the creative's size is {@link CreativeSizeType#PIXEL}, which is a dimension based size (width-height pair).
         • targetingName - optional; type string
           The name of the {@link CreativeTargeting} for creatives this placeholder represents.

           This attribute is optional. Specifying creative targeting here is for forecasting purposes only and has no effect on serving. The same creative targeting should be specified on a {@link LineItemCreativeAssociation} when associating a {@link Creative} with the {@link LineItem}.

         • isAmpOnly - optional; type boolean
           Indicate if the expected creative of this placeholder has an AMP only variant.

           This attribute is optional. It is for forecasting purposes only and has no effect on serving.

         The companions that the creative is expected to have. This attribute can only be set if the line item it belongs to has a {@link LineItem#environmentType} of {@link EnvironmentType#VIDEO_PLAYER} or {@link LineItem#roadblockingType} of {@link RoadblockingType#CREATIVE_SET}.
       • appliedLabels - optional, unbounded; type AppliedLabel
         Represents a {@link Label} that can be applied to an entity. To negate an inherited label, create an {@code AppliedLabel} with {@code labelId} as the inherited label's ID and {@code isNegated} set to true.
         • labelId - optional; type long
           The ID of a created {@link Label}.
         • isNegated - optional; type boolean
           {@code isNegated} should be set to {@code true} to negate the effects of {@code labelId}.
         The set of label frequency caps applied directly to this creative placeholder.
       • effectiveAppliedLabels - optional, unbounded; type AppliedLabel
         Represents a {@link Label} that can be applied to an entity. To negate an inherited label, create an {@code AppliedLabel} with {@code labelId} as the inherited label's ID and {@code isNegated} set to true.
         • labelId - optional; type long
           The ID of a created {@link Label}.
         • isNegated - optional; type boolean
           {@code isNegated} should be set to {@code true} to negate the effects of {@code labelId}.
         Contains the set of labels applied directly to this creative placeholder as well as those inherited from the creative template from which this creative placeholder was instantiated. This field is readonly and is assigned by Google.
       • expectedCreativeCount - optional; type int
         Expected number of creatives that will be uploaded corresponding to this creative placeholder. This estimate is used to improve the accuracy of forecasting; for example, if label frequency capping limits the number of times a creative may be served.
       • creativeSizeType - optional; type CreativeSizeType - type string with restriction - enum { 'PIXEL', 'ASPECT_RATIO', 'INTERSTITIAL', 'IGNORED', 'NATIVE', 'AUDIO' }
         Describes the types of sizes a creative can be. By default, the creative's size is {@link CreativeSizeType#PIXEL}, which is a dimension based size (width-height pair).
       • targetingName - optional; type string
         The name of the {@link CreativeTargeting} for creatives this placeholder represents.

         This attribute is optional. Specifying creative targeting here is for forecasting purposes only and has no effect on serving. The same creative targeting should be specified on a {@link LineItemCreativeAssociation} when associating a {@link Creative} with the {@link LineItem}.

       • isAmpOnly - optional; type boolean
         Indicate if the expected creative of this placeholder has an AMP only variant.

         This attribute is optional. It is for forecasting purposes only and has no effect on serving.

       Details about the creatives that are expected to serve through the {@code ProposalLineItem}. This attribute is optional during creation and defaults to the {@link Product#creativePlaceholders product's creative placeholders}. This attribute is required.
     • targeting - optional; type Targeting
       Contains the targeting criteria for the {@code ProposalLineItem}. This attribute is required.
       Contains targeting criteria for {@link LineItem} objects. See {@link LineItem#targeting}.
       • geoTargeting - optional; type GeoTargeting
         Provides line items the ability to target geographical locations. By default, line items target all countries and their subdivisions. With geographical targeting, you can target line items to specific countries, regions, metro areas, and cities. You can also exclude the same.

         The following rules apply for geographical targeting:

         • You cannot target and exclude the same location.
         • You cannot target a child whose parent has been excluded. For example, if the state of Illinois has been excluded, then you cannot target Chicago.
         • You must not target a location if you are also targeting its parent. For example, if you are targeting New York City, you must not have the state of New York as one of the targeted locations.
         • You cannot explicitly define inclusions or exclusions that are already implicit. For example, if you explicitly include California, you implicitly exclude all other states. You therefore cannot explicitly exclude Florida, because it is already implicitly excluded. Conversely if you explicitly exclude Florida, you cannot explicitly include California.
         • targetedLocations - optional, unbounded; type Location
           The geographical locations being targeted by the {@link LineItem}.
           A {@link Location} represents a geographical entity that can be targeted. If a location type is not available because of the API version you are using, the location will be represented as just the base class, otherwise it will be sub-classed correctly.
           • id - optional; type long
             Uniquely identifies each {@code Location}.
           • type - optional; type string
             The location type for this geographical entity (ex. "COUNTRY", "CITY", "STATE", "COUNTY", etc.)
           • canonicalParentId - optional; type int
             The nearest location parent's ID for this geographical entity.
           • displayName - optional; type string
             The localized name of the geographical entity.
         • excludedLocations - optional, unbounded; type Location
           The geographical locations being excluded by the {@link LineItem}.
           A {@link Location} represents a geographical entity that can be targeted. If a location type is not available because of the API version you are using, the location will be represented as just the base class, otherwise it will be sub-classed correctly.
           • id - optional; type long
             Uniquely identifies each {@code Location}.
           • type - optional; type string
             The location type for this geographical entity (ex. "COUNTRY", "CITY", "STATE", "COUNTY", etc.)
           • canonicalParentId - optional; type int
             The nearest location parent's ID for this geographical entity.
           • displayName - optional; type string
             The localized name of the geographical entity.
         Specifies what geographical locations are targeted by the {@link LineItem}. This attribute is optional.
       • inventoryTargeting - optional; type InventoryTargeting
         A collection of targeted and excluded ad units and placements.
         • targetedAdUnits - optional, unbounded; type AdUnitTargeting
           Represents targeted or excluded ad units.
           • adUnitId - optional; type string
             Included or excluded ad unit id.
           • includeDescendants - optional; type boolean
             Whether or not all descendants are included (or excluded) as part of including (or excluding) this ad unit. By default, the value is {@code true} which means targeting this ad unit will target all of its descendants.
           A list of targeted {@link AdUnitTargeting}.
         • excludedAdUnits - optional, unbounded; type AdUnitTargeting
           Represents targeted or excluded ad units.
           • adUnitId - optional; type string
             Included or excluded ad unit id.
           • includeDescendants - optional; type boolean
             Whether or not all descendants are included (or excluded) as part of including (or excluding) this ad unit. By default, the value is {@code true} which means targeting this ad unit will target all of its descendants.
           A list of excluded {@link AdUnitTargeting}.
         • targetedPlacementIds - optional, unbounded; type long
           A list of targeted {@link Placement} ids.
         Specifies what inventory is targeted by the {@link LineItem}. This attribute is required. The line item must target at least one ad unit or placement.
       • dayPartTargeting - optional; type DayPartTargeting
         Modify the delivery times of line items for particular days of the week. By default, line items are served at all days and times.
         • dayParts - optional, unbounded; type DayPart
           {@code DayPart} represents a time-period within a day of the week which is targeted by a {@link LineItem}.
           • dayOfWeek - optional; type DayOfWeek - type string with restriction - enum { 'MONDAY', 'TUESDAY', 'WEDNESDAY', 'THURSDAY', 'FRIDAY', 'SATURDAY', 'SUNDAY' }
             Day of the week the target applies to. This field is required.
           • startTime - optional; type TimeOfDay
             Represents the start time of the targeted period (inclusive).
             Represents a specific time in a day.
             • hour - optional; type int
               Hour in 24 hour time (0..24). This field must be between 0 and 24, inclusive. This field is required.
             • minute - optional; type MinuteOfHour - type string with restriction - enum { 'ZERO', 'FIFTEEN', 'THIRTY', 'FORTY_FIVE' }
               Minutes in an hour. Currently, only 0, 15, 30, and 45 are supported. This field is required.
           • endTime - optional; type TimeOfDay
             Represents the end time of the targeted period (exclusive).
             Represents a specific time in a day.
             • hour - optional; type int
               Hour in 24 hour time (0..24). This field must be between 0 and 24, inclusive. This field is required.
             • minute - optional; type MinuteOfHour - type string with restriction - enum { 'ZERO', 'FIFTEEN', 'THIRTY', 'FORTY_FIVE' }
               Minutes in an hour. Currently, only 0, 15, 30, and 45 are supported. This field is required.
           Specifies days of the week and times at which a {@code LineItem} will be delivered.

           If targeting all days and times, this value will be ignored.

         • timeZone - optional; type DeliveryTimeZone - type string with restriction - enum { 'PUBLISHER', 'BROWSER' }
           Specifies the time zone to be used for delivering {@link LineItem} objects. This attribute is optional and defaults to {@link DeliveryTimeZone#BROWSER}.

           Setting this has no effect if targeting all days and times.

         Specifies the days of the week and times that are targeted by the {@link LineItem}. This attribute is optional.
       • dateTimeRangeTargeting - optional; type DateTimeRangeTargeting
         The date time ranges that the line item is eligible to serve.
         • targetedDateTimeRanges - optional, unbounded; type DateTimeRange
           Represents a range of dates (combined with time of day) that has an upper and/or lower bound.
           • startDateTime - optional; type DateTime
             Represents a date combined with the time of day.
             • date - optional; type Date
               Represents a date.
               • year - optional; type int
                 Year (e.g., 2009)
               • month - optional; type int
                 Month (1..12)
               • day - optional; type int
                 Day (1..31)
             • hour - optional; type int
             • minute - optional; type int
             • second - optional; type int
             • timeZoneId - optional; type string
             The start date time of this range. This field is optional and if it is not set then there is no lower bound on the date time range. If this field is not set then {@code endDateTime} must be specified.
           • endDateTime - optional; type DateTime
             Represents a date combined with the time of day.
             • date - optional; type Date
               Represents a date.
               • year - optional; type int
                 Year (e.g., 2009)
               • month - optional; type int
                 Month (1..12)
               • day - optional; type int
                 Day (1..31)
             • hour - optional; type int
             • minute - optional; type int
             • second - optional; type int
             • timeZoneId - optional; type string
             The end date time of this range. This field is optional and if it is not set then there is no upper bound on the date time range. If this field is not set then {@code startDateTime} must be specified.
         Specifies the dates and time ranges that are targeted by the {@link LineItem}. This attribute is optional.
       • technologyTargeting - optional; type TechnologyTargeting
         Provides {@link LineItem} objects the ability to target or exclude technologies.
         • bandwidthGroupTargeting - optional; type BandwidthGroupTargeting
           The bandwidth groups being targeted by the {@link LineItem}.
           Represents bandwidth groups that are being targeted or excluded by the {@link LineItem}.
           • isTargeted - optional; type boolean
             Indicates whether bandwidth groups should be targeted or excluded. This attribute is optional and defaults to {@code true}.
           • bandwidthGroups - optional, unbounded; type Technology
             The bandwidth groups that are being targeted or excluded by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
         • browserTargeting - optional; type BrowserTargeting
           The browsers being targeted by the {@link LineItem}.
           Represents browsers that are being targeted or excluded by the {@link LineItem}.
           • isTargeted - optional; type boolean
             Indicates whether browsers should be targeted or excluded. This attribute is optional and defaults to {@code true}.
           • browsers - optional, unbounded; type Technology
             Browsers that are being targeted or excluded by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
         • browserLanguageTargeting - optional; type BrowserLanguageTargeting
           The languages of browsers being targeted by the {@link LineItem}.
           Represents browser languages that are being targeted or excluded by the {@link LineItem}.
           • isTargeted - optional; type boolean
             Indicates whether browsers languages should be targeted or excluded. This attribute is optional and defaults to {@code true}.
           • browserLanguages - optional, unbounded; type Technology
             Browser languages that are being targeted or excluded by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
         • deviceCapabilityTargeting - optional; type DeviceCapabilityTargeting
           The device capabilities being targeted by the {@link LineItem}.
           Represents device capabilities that are being targeted or excluded by the {@link LineItem}.
           • targetedDeviceCapabilities - optional, unbounded; type Technology
             Device capabilities that are being targeted by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
           • excludedDeviceCapabilities - optional, unbounded; type Technology
             Device capabilities that are being excluded by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
         • deviceCategoryTargeting - optional; type DeviceCategoryTargeting
           The device categories being targeted by the {@link LineItem}.
           Represents device categories that are being targeted or excluded by the {@link LineItem}.
           • targetedDeviceCategories - optional, unbounded; type Technology
             Device categories that are being targeted by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
           • excludedDeviceCategories - optional, unbounded; type Technology
             Device categories that are being excluded by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
         • deviceManufacturerTargeting - optional; type DeviceManufacturerTargeting
           The device manufacturers being targeted by the {@link LineItem}.
           Represents device manufacturer that are being targeted or excluded by the {@link LineItem}.
           • isTargeted - optional; type boolean
             Indicates whether device manufacturers should be targeted or excluded. This attribute is optional and defaults to {@code true}.
           • deviceManufacturers - optional, unbounded; type Technology
             Device manufacturers that are being targeted or excluded by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
         • mobileCarrierTargeting - optional; type MobileCarrierTargeting
           The mobile carriers being targeted by the {@link LineItem}.
           Represents mobile carriers that are being targeted or excluded by the {@link LineItem}.
           • isTargeted - optional; type boolean
             Indicates whether mobile carriers should be targeted or excluded. This attribute is optional and defaults to {@code true}.
           • mobileCarriers - optional, unbounded; type Technology
             Mobile carriers that are being targeted or excluded by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
         • mobileDeviceTargeting - optional; type MobileDeviceTargeting
           The mobile devices being targeted by the {@link LineItem}.
           Represents mobile devices that are being targeted or excluded by the {@link LineItem}.
           • targetedMobileDevices - optional, unbounded; type Technology
             Mobile devices that are being targeted by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
           • excludedMobileDevices - optional, unbounded; type Technology
             Mobile devices that are being excluded by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
         • mobileDeviceSubmodelTargeting - optional; type MobileDeviceSubmodelTargeting
           The mobile device submodels being targeted by the {@link LineItem}.
           Represents mobile devices that are being targeted or excluded by the {@link LineItem}.
           • targetedMobileDeviceSubmodels - optional, unbounded; type Technology
             Mobile device submodels that are being targeted by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
           • excludedMobileDeviceSubmodels - optional, unbounded; type Technology
             Mobile device submodels that are being excluded by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
         • operatingSystemTargeting - optional; type OperatingSystemTargeting
           The operating systems being targeted by the {@link LineItem}.
           Represents operating systems that are being targeted or excluded by the {@link LineItem}.
           • isTargeted - optional; type boolean
             Indicates whether operating systems should be targeted or excluded. This attribute is optional and defaults to {@code true}.
           • operatingSystems - optional, unbounded; type Technology
             Operating systems that are being targeted or excluded by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
         • operatingSystemVersionTargeting - optional; type OperatingSystemVersionTargeting
           The operating system versions being targeted by the {@link LineItem}.
           Represents operating system versions that are being targeted or excluded by the {@link LineItem}.
           • targetedOperatingSystemVersions - optional, unbounded; type Technology
             Operating system versions that are being targeted by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
           • excludedOperatingSystemVersions - optional, unbounded; type Technology
             Operating system versions that are being excluded by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
         Specifies the browsing technologies that are targeted by the {@link LineItem}. This attribute is optional.
       • customTargeting - optional; type CustomCriteriaSet - extension of abstract type CustomCriteriaNode
         A {@link CustomCriteriaSet} comprises of a set of {@link CustomCriteriaNode} objects combined by the {@link CustomCriteriaSet.LogicalOperator#logicalOperator}. The custom criteria targeting tree is subject to the rules defined on {@link Targeting#customTargeting}.
         A {@link CustomCriteriaNode} is a node in the custom targeting tree. A custom criteria node can either be a {@link CustomCriteriaSet} (a non-leaf node) or a {@link CustomCriteria} (a leaf node). The custom criteria targeting tree is subject to the rules defined on {@link Targeting#customTargeting}.
         • logicalOperator - optional; type CustomCriteriaSet.LogicalOperator - type string with restriction - enum { 'AND', 'OR' }
           The logical operator to be applied to {@link CustomCriteriaSet#children}. This attribute is required. This attribute is required.
         • children - optional, unbounded; type CustomCriteriaNode
           The custom criteria. This attribute is required.
           A {@link CustomCriteriaNode} is a node in the custom targeting tree. A custom criteria node can either be a {@link CustomCriteriaSet} (a non-leaf node) or a {@link CustomCriteria} (a leaf node). The custom criteria targeting tree is subject to the rules defined on {@link Targeting#customTargeting}.
           Specifies the collection of custom criteria that is targeted by the {@link LineItem}.

           Once the {@link LineItem} is updated or modified with custom targeting, the server may return a normalized, but equivalent representation of the custom targeting expression.

           {@code customTargeting} will have up to three levels of expressions including itself.

           The top level {@code CustomCriteriaSet} i.e. the {@code customTargeting} object can only contain a {@link CustomCriteriaSet.LogicalOperator#OR} of all its children.

           The second level of {@code CustomCriteriaSet} objects can only contain {@link CustomCriteriaSet.LogicalOperator#AND} of all their children. If a {@link CustomCriteria} is placed on this level, the server will wrap it in a {@link CustomCriteriaSet}.

           The third level can only comprise of {@link CustomCriteria} objects.

           The resulting custom targeting tree would be of the form:
           

         • userDomainTargeting - optional; type UserDomainTargeting
           Specifies the domains or subdomains that are targeted or excluded by the {@link LineItem}. Users visiting from an IP address associated with those domains will be targeted or excluded. This attribute is optional.
           Provides line items the ability to target or exclude users visiting their websites from a list of domains or subdomains.
           • domains - optional, unbounded; type string
             The domains or subdomains that are being targeted or excluded by the {@link LineItem}. This attribute is required and the maximum length of each domain is 67 characters.
           • targeted - optional; type boolean
             Indicates whether domains should be targeted or excluded. This attribute is optional and defaults to {@code true}.
         • contentTargeting - optional; type ContentTargeting
           Used to target {@link LineItem}s to specific videos on a publisher's site.
           • targetedContentIds - optional, unbounded; type long
             The IDs of content being targeted by the {@code LineItem}.
           • excludedContentIds - optional, unbounded; type long
             The IDs of content being excluded by the {@code LineItem}.
           • targetedVideoContentBundleIds - optional, unbounded; type long
             A list of video content bundles, represented by {@link ContentBundle} IDs, that are being targeted by the {@code LineItem}.
           • excludedVideoContentBundleIds - optional, unbounded; type long
             A list of video content bundles, represented by {@link ContentBundle} IDs, that are being excluded by the {@code LineItem}.
           Specifies the video categories and individual videos targeted by the {@link LineItem}.
         • videoPositionTargeting - optional; type VideoPositionTargeting
           Specifies targeting against video position types.
           Represents positions within and around a video where ads can be targeted to.

           Example positions could be {@code pre-roll} (before the video plays), {@code post-roll} (after a video has completed playback) and {@code mid-roll} (during video playback).

           Empty video position targeting means that all video positions are allowed. If a bumper line item has empty video position targeting it will be updated to target all bumper positions.

           • targetedPositions - optional, unbounded; type VideoPositionTarget
             The {@link VideoTargetingPosition} objects being targeted by the video {@link LineItem}.
             Represents the options for targetable positions within a video.
             • videoPosition - optional; type VideoPosition
               Represents a targetable position within a video. A video ad can be targeted to a position (pre-roll, all mid-rolls, or post-roll), or to a specific mid-roll index.
               • positionType - optional; type VideoPosition.Type - type string with restriction - enum { 'UNKNOWN', 'ALL', 'PREROLL', 'MIDROLL', 'POSTROLL' }
                 The type of video position (pre-roll, mid-roll, or post-roll).
               • midrollIndex - optional; type int
                 The index of the mid-roll to target. Only valid if the {@link positionType} is {@link VideoPositionType#MIDROLL}, otherwise this field will be ignored.
               The video position to target. This attribute is required.
             • videoBumperType - optional; type VideoBumperType - type string with restriction - enum { 'BEFORE', 'AFTER' }
               The video bumper type to target. To target a video position or a pod position, this value must be null. To target a bumper position this value must be populated and the line item must have a bumper type. To target a custom ad spot, this value must be null.
             • videoPositionWithinPod - optional; type VideoPositionWithinPod
               Represents a targetable position within a pod within a video stream. A video ad can be targeted to any position in the pod (first, second, third ... last). If there is only 1 ad in a pod, either first or last will target that position.
               • index - optional; type int
                 The specific index of the pod. The index is defined as:

                 • 1 = first
                 • 2 = second
                 • 3 = third
                 • ....
                 • 100 = last

                 100 will always be the last position. For example, for a pod with 5 positions, 100 would target position 5. Multiple targets against the index 100 can exist.
                 Positions over 100 are not supported.
               The video position within a pod to target. To target a video position or a bumper position, this value must be null. To target a position within a pod this value must be populated. To target a custom ad spot, this value must be null.
             • adSpotId - optional; type long
               A custom spot {@link AdSpot} to target. To target a video position, a bumper type or a video position within a pod this value must be null.
         • mobileApplicationTargeting - optional; type MobileApplicationTargeting
           Provides the ability to target or exclude users' mobile applications.
           • mobileApplicationIds - optional, unbounded; type long
             The {@link MobileApplication#id IDs} that are being targeted or excluded.
           • isTargeted - optional; type boolean
             Indicates whether mobile apps should be targeted or excluded. This attribute is optional and defaults to {@code true}.
           Specifies targeting against mobile applications.
         • buyerUserListTargeting - optional; type BuyerUserListTargeting
           The {@code BuyerUserListTargeting} associated with a programmatic {@link LineItem} or {@link ProposalLineItem} object.
           • hasBuyerUserListTargeting - optional; type boolean
             Whether the programmatic {@code LineItem} or {@code ProposalLineItem} object has buyer user list targeting.
           Specifies whether buyer user lists are targeted on a programmatic {@link LineItem} or {@link ProposalLineItem}. This attribute is readonly and is populated by Google.
         • inventoryUrlTargeting - optional; type InventoryUrlTargeting
           A collection of targeted inventory urls.
           • targetedUrls - optional, unbounded; type InventoryUrl
             The representation of an inventory Url that is used in targeting.
             • id - optional; type long
           • excludedUrls - optional, unbounded; type InventoryUrl
             The representation of an inventory Url that is used in targeting.
             • id - optional; type long
           Specifies the URLs that are targeted by the entity. This is currently only supported by {@link YieldGroup}.
         • verticalTargeting - optional; type VerticalTargeting
           Specifies the verticals that are targeted by the entity. The IDs listed here correspond to the IDs in the AD_CATEGORY table of type VERTICAL.
           Vertical targeting information.
           • targetedVerticalIds - optional, unbounded; type long
           • excludedVerticalIds - optional, unbounded; type long
         • contentLabelTargeting - optional; type ContentLabelTargeting
           Content label targeting information.
           • excludedContentLabelIds - optional, unbounded; type long
           Specifies the content labels that are excluded by the entity. The IDs listed here correspond to the IDs in the CONTENT_LABEL table.
         • requestPlatformTargeting - optional; type RequestPlatformTargeting
           Provides line items the ability to target the platform that requests and renders the ad.

           The following rules apply for {@link RequestPlatformTargeting}

           • {@link RequestPlatformTargeting} must be specified for {@link ProposalLineItem}s.
           • {@link RequestPlatformTargeting} must be specified for video line items. Empty values for {@link RequestPlatformTargeting#targetedRequestPlatforms} mean that all request platforms will be targeted.
           • {@link RequestPlatformTargeting} is read-only and assigned by Google for non-video line items.
           • {@link RequestPlatformTargeting} is read-only and assigned by Google for line items generated from proposal line items.
           • targetedRequestPlatforms - optional, unbounded; type RequestPlatform - type string with restriction - enum { 'UNKNOWN', 'BROWSER', 'MOBILE_APP', 'VIDEO_PLAYER' }
           Specifies the request platforms that are targeted by the {@link LineItem}. This attribute is required for video line items and for {@link ProposalLineItem}.

           This value is modifiable for video line items, but read-only for non-video line items.

           This value is read-only for video line items generated from proposal line items.

         • inventorySizeTargeting - optional; type InventorySizeTargeting
           Represents a collection of targeted and excluded inventory sizes. This is currently only available on {@link YieldGroup} and {@link TrafficDataRequest}.
           • isTargeted - optional; type boolean
             Whether the inventory sizes should be targeted or excluded.
           • targetedSizes - optional, unbounded; type TargetedSize
             A list of {@link TargetedSizeDto}s.
             A size that is targeted on a request.
             • size - optional; type Size
               Represents the dimensions of an {@link AdUnit}, {@link LineItem} or {@link Creative}.

               For interstitial size (out-of-page), native, ignored and fluid size, {@link Size} must be 1x1.

               • width - optional; type int
                 The width of the {@link AdUnit}, {@link LineItem} or {@link Creative}.
               • height - optional; type int
                 The height of the {@link AdUnit}, {@link LineItem} or {@link Creative}.
               • isAspectRatio - optional; type boolean
                 Whether this size represents an aspect ratio.
           Specifies the sizes that are targeted by the entity. This is currently only supported on {@link YieldGroup} and {@link TrafficDataRequest}.
         • customFieldValues - optional, unbounded; type BaseCustomFieldValue
           The value of a {@link CustomField} for a particular entity.
           • customFieldId - optional; type long
             Id of the {@code CustomField} to which this value belongs. This attribute is required.
           The values of the custom fields associated with the {@code ProposalLineItem}. This attribute is optional. This attribute can be configured as editable after the proposal has been submitted. Please check with your network administrator for editable fields configuration.
         • appliedLabels - optional, unbounded; type AppliedLabel
           Represents a {@link Label} that can be applied to an entity. To negate an inherited label, create an {@code AppliedLabel} with {@code labelId} as the inherited label's ID and {@code isNegated} set to true.
           • labelId - optional; type long
             The ID of a created {@link Label}.
           • isNegated - optional; type boolean
             {@code isNegated} should be set to {@code true} to negate the effects of {@code labelId}.
           The set of labels applied directly to the {@code ProposalLineItem}. This attribute is optional.
         • effectiveAppliedLabels - optional, unbounded; type AppliedLabel
           Represents a {@link Label} that can be applied to an entity. To negate an inherited label, create an {@code AppliedLabel} with {@code labelId} as the inherited label's ID and {@code isNegated} set to true.
           • labelId - optional; type long
             The ID of a created {@link Label}.
           • isNegated - optional; type boolean
             {@code isNegated} should be set to {@code true} to negate the effects of {@code labelId}.
           Contains the set of labels applied directly to the proposal as well as those inherited ones. If a label has been negated, only the negated label is returned. This attribute is read-only.
         • disableSameAdvertiserCompetitiveExclusion - optional; type 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 {@code true} will allow line items from the same advertiser to serve regardless of the other competitive exclusion labels being applied.

           This attribute is optional and defaults to false.

         • isSold - optional; type boolean
           Indicates whether this {@code ProposalLineItem} has been sold. This attribute is read-only.
         • netRate - optional; type Money
           Represents a money amount.
           • currencyCode - optional; type string
             Three letter currency code in string format.
           • microAmount - optional; type long
             Money values are always specified in terms of micros which are a millionth of the fundamental currency unit. For US dollars, $1 is 1,000,000 micros.
           The amount of money to spend per impression or click in proposal currency. It supports precision of 4 decimal places in terms of the fundamental currency unit, so the {@link Money#getAmountInMicros} must be multiples of 100. It doesn't include agency commission.

           For example, if {@link Proposal#currencyCode} is 'USD', then $123.4567 could be represented as 123456700, but further precision is not supported.

           The field {@link ProposalLineItem#netRate} is required, and used to calculate {@link ProposalLineItem#netCost} if unspecified.

         • netCost - optional; type Money
           Represents a money amount.
           • currencyCode - optional; type string
             Three letter currency code in string format.
           • microAmount - optional; type long
             Money values are always specified in terms of micros which are a millionth of the fundamental currency unit. For US dollars, $1 is 1,000,000 micros.
           The cost of the {@code ProposalLineItem} in proposal currency. It supports precision of 2 decimal places in terms of the fundamental currency unit, so the {@link Money#getAmountInMicros} must be multiples of 10000. It doesn't include agency commission.

           For example, if {@link Proposal#currencyCode} is 'USD', then $123.45 could be represented as 123450000, but further precision is not supported.

           The field {@link ProposalLineItem#netRate} is required, and used to calculate {@link ProposalLineItem#netCost} if unspecified.

         • deliveryIndicator - optional; type DeliveryIndicator
           Indicates the delivery performance of the {@link LineItem}.
           • expectedDeliveryPercentage - optional; type double
             How much the {@code LineItem} was expected to deliver as a percentage of {@link LineItem#primaryGoal}.
           • actualDeliveryPercentage - optional; type double
             How much the line item actually delivered as a percentage of {@link LineItem#primaryGoal}.
           Indicates how well the line item generated from this proposal line item has been performing. This will be {@code null} if the delivery indicator information is not available due to one of the following reasons:

           1. The proposal line item has not pushed to Ad Manager.
           2. The line item is not delivering.
           3. The line item has an unlimited goal or cap.
           4. The line item has a percentage based goal or cap.

           This attribute is read-only.
         • deliveryData - optional; type DeliveryData
           Holds the number of clicks or impressions, determined by {@link LineItem#costType}, delivered for a single line item for the last 7 days
           • units - optional, unbounded; type long
             Clicks or impressions delivered for the last 7 days.
           Delivery data provides the number of clicks or impressions delivered for the {@link LineItem} generated from this proposal line item in the last 7 days. This will be {@code null} if the delivery data cannot be computed due to one of the following reasons:

           1. The proposal line item has not pushed to Ad Manager.
           2. The line item is not deliverable.
           3. The line item has completed delivering more than 7 days ago.
           4. The line item has an absolute-based goal. {@link ProposalLineItem#deliveryIndicator} should be used to track its progress in this case. This attribute is read-only.
         • computedStatus - optional; type ComputedStatus - type string with restriction - enum { 'DELIVERY_EXTENDED', 'DELIVERING', 'READY', 'PAUSED', 'INACTIVE', 'PAUSED_INVENTORY_RELEASED', 'PENDING_APPROVAL', 'COMPLETED', 'DISAPPROVED', 'DRAFT', 'CANCELED' }
           The status of the {@link LineItem} generated from this proposal line item. This will be {@code null} if the proposal line item has not pushed to Ad Manager. This attribute is read-only.
         • lastModifiedDateTime - optional; type DateTime
           Represents a date combined with the time of day.
           • date - optional; type Date
             Represents a date.
             • year - optional; type int
               Year (e.g., 2009)
             • month - optional; type int
               Month (1..12)
             • day - optional; type int
               Day (1..31)
           • hour - optional; type int
           • minute - optional; type int
           • second - optional; type int
           • timeZoneId - optional; type string
           The date and time this {@code ProposalLineItem} was last modified.

           This attribute is assigned by Google when a {@code ProposalLineItem} is updated. This attribute is read-only.

         • reservationStatus - optional; type ReservationStatus - type string with restriction - enum { 'RESERVED', 'NOT_RESERVED', 'RELEASED', 'CHECK_LINE_ITEM_RESERVATION_STATUS', 'UNKNOWN' }
           The reservation status of the {@link ProposalLineItem}. This attribute is read-only.
         • lastReservationDateTime - optional; type DateTime
           Represents a date combined with the time of day.
           • date - optional; type Date
             Represents a date.
             • year - optional; type int
               Year (e.g., 2009)
             • month - optional; type int
               Month (1..12)
             • day - optional; type int
               Day (1..31)
           • hour - optional; type int
           • minute - optional; type int
           • second - optional; type int
           • timeZoneId - optional; type string
           The last {@link DateTime} when the {@link ProposalLineItem} reserved inventory. This attribute is read-only.
         • environmentType - optional; type EnvironmentType - type string with restriction - enum { 'BROWSER', 'VIDEO_PLAYER' }
           The environment that the {@code ProposalLineItem} is targeting. The default value is {@link EnvironmentType#BROWSER}. If this value is {@link EnvironmentType#VIDEO_PLAYER}, then this {@code ProposalLineItem} can only target {@link AdUnit ad units} that have {@link AdUnitSize sizes} whose {@link AdUnitSize#environmentType} is also {@link EnvironmentType#VIDEO_PLAYER}.

           This field is read-only and set to {@link Product#environmentType} of the product this proposal line item was created from.

         • allowedFormats - optional, unbounded; type AllowedFormats - type string with restriction - enum { 'AUDIO', 'UNKNOWN' }
           The set of {@link AllowedFormats} that this proposal line item can have. If the set is empty, this proposal line item allows all formats.
         • additionalTerms - optional; type string
           Additional terms shown to the buyer in Marketplace.
         • programmaticCreativeSource - optional; type ProgrammaticCreativeSource - type string with restriction - enum { 'PUBLISHER', 'ADVERTISER', 'UNKNOWN' }
           Indicates the {@link ProgrammaticCreativeSource} of the programmatic line item.
         • grpSettings - optional; type GrpSettings
           {@code GrpSettings} contains information for a line item that will have a target demographic when serving. This information will be used to set up tracking and enable reporting on the demographic information.
           • minTargetAge - optional; type long
             Specifies the minimum target age (in years) of the {@link LineItem}. This field is only applicable if {@link #provider} is not null.
           • maxTargetAge - optional; type long
             Specifies the maximum target age (in years) of the {@link LineItem}. This field is only applicable if {@link #provider} is not null.
           • targetGender - optional; type GrpTargetGender - type string with restriction - enum { 'UNKNOWN', 'MALE', 'FEMALE', 'BOTH' }
             Specifies the target gender of the {@link LineItem}. This field is only applicable if {@link #provider} is not null.
           • provider - optional; type GrpProvider - type string with restriction - enum { 'UNKNOWN', 'NIELSEN' }
             Specifies the GRP provider of the {@link LineItem}.
           • inTargetRatioEstimateMilliPercent - optional; type long
             Estimate for the in-target ratio given the line item's audience targeting. This field is only applicable if {@link #provider} is Nielsen, {@link LineItem#primaryGoal#unitType} is in-target impressions, and {@link LineItem#CostType} is in-target CPM. This field determines the in-target ratio to use for pacing Nielsen line items before Nielsen reporting data is available. Represented as a milli percent, so 55.7% becomes 55700.
           • nielsenCtvPacingType - optional; type NielsenCtvPacingType - type string with restriction - enum { 'UNKNOWN', 'NONE', 'COVIEW', 'STRICT_COVIEW' }
             Specifies which pacing computation to apply in pacing to impressions from connected devices. This field is required if {@code enableNielsenCoViewingSupport} is true.
           • pacingDeviceCategorizationType - optional; type PacingDeviceCategorizationType - type string with restriction - enum { 'UNKNOWN', 'GOOGLE', 'NIELSEN' }
             Specifies whether to use Google or Nielsen device breakdown in Nielsen Line Item auto pacing.
           • applyTrueCoview - optional; type boolean
             Specifies whether to apply true coviewing in Nielsen Line Item auto pacing. This field can only be true if NielsenCtvPacingType is not NONE.
           Contains the information for a proposal line item which has a target GRP demographic.
         • estimatedMinimumImpressions - optional; type long
           The estimated minimum impressions that should be delivered for a proposal line item.
         • thirdPartyMeasurementSettings - optional; type ThirdPartyMeasurementSettings
           Contains third party measurement settings for cross-sell Partners
           Contains third party auto-pixeling settings for cross-sell Partners.
           • viewabilityPartner - optional; type ThirdPartyViewabilityIntegrationPartner - type string with restriction - enum { 'NONE', 'MOAT', 'DOUBLE_VERIFY', 'INTEGRAL_AD_SCIENCE', 'COMSCORE', 'TELEMETRY', 'UNKNOWN' }
             A field to determine the type of ThirdPartyViewabilityIntegrationPartner. This field default is NONE.
           • viewabilityClientId - optional; type string
             The third party partner id for YouTube viewability verification.
           • viewabilityReportingId - optional; type string
             The reporting id that maps viewability partner data with a campaign (or a group of related campaigns) specific data.
           • publisherViewabilityPartner - optional; type ThirdPartyViewabilityIntegrationPartner - type string with restriction - enum { 'NONE', 'MOAT', 'DOUBLE_VERIFY', 'INTEGRAL_AD_SCIENCE', 'COMSCORE', 'TELEMETRY', 'UNKNOWN' }
             A field to determine the type of publisher's viewability partner. This field default is NONE.
           • publisherViewabilityClientId - optional; type string
             The third party partner id for YouTube viewability verification for publisher.
           • publisherViewabilityReportingId - optional; type string
             The reporting id that maps viewability partner data with a campaign (or a group of related campaigns) specific data for publisher.
           • brandLiftPartner - optional; type ThirdPartyBrandLiftIntegrationPartner - type string with restriction - enum { 'UNKNOWN', 'NONE', 'KANTAR_MILLWARD_BROWN', 'DYNATA', 'INTAGE', 'MACROMILL' }
             A field to determine the type of ThirdPartyBrandLiftIntegrationPartner. This field default is NONE.
           • brandLiftClientId - optional; type string
             The third party partner id for YouTube brand lift verification.
           • brandLiftReportingId - optional; type string
             The reporting id that maps brand lift partner data with a campaign (or a group of related campaigns) specific data.
           • reachPartner - optional; type ThirdPartyReachIntegrationPartner - type string with restriction - enum { 'NONE', 'COMSCORE', 'NIELSEN', 'KANTAR_MILLWARD_BROWN', 'VIDEO_RESEARCH', 'GEMIUS', 'VIDEO_AMP', 'ISPOT_TV', 'AUDIENCE_PROJECT', 'UNKNOWN' }
             A field to determine the type of advertiser's ThirdPartyReachIntegrationPartner. This field default is UNKNOWN.
           • reachClientId - optional; type string
             The third party partner id for YouTube reach verification for advertiser.
           • reachReportingId - optional; type string
             The reporting id that maps reach partner data with a campaign (or a group of related campaigns) specific data for advertiser.
           • publisherReachPartner - optional; type ThirdPartyReachIntegrationPartner - type string with restriction - enum { 'NONE', 'COMSCORE', 'NIELSEN', 'KANTAR_MILLWARD_BROWN', 'VIDEO_RESEARCH', 'GEMIUS', 'VIDEO_AMP', 'ISPOT_TV', 'AUDIENCE_PROJECT', 'UNKNOWN' }
             A field to determine the type of publisher's ThirdPartyReachIntegrationPartner. This field default is UNKNOWN.
           • publisherReachClientId - optional; type string
             The third party partner id for YouTube reach verification for publisher.
           • publisherReachReportingId - optional; type string
             The reporting id that maps reach partner data with a campaign (or a group of related campaigns) specific data for publisher.
         • makegoodInfo - optional; type ProposalLineItemMakegoodInfo
           Makegood info for this proposal line item. Immutable once created.

           Null if this proposal line item is not a makegood.

           Makegood info for a {@link ProposalLineItemDto}.
           • originalProposalLineItemId - optional; type long
             The ID of the original proposal line item on which this makegood is based. This attribute is read-only.
           • reason - optional; type string
             The publisher-provided reason why this makegood was initiated. This is free form text.

             The following predefined values can be used to render predefined options in the UI.

             UNDERDELIVERY: 'Impression underdelivery', SECONDARY_DELIVERY_TERMS: 'Did not meet secondary delivery terms ', PERFORMANCE: 'Performance issues',

         • hasMakegood - optional; type boolean
           Whether this proposal line item has an associated makegood. This attribute is read-only.
         • canCreateMakegood - optional; type boolean
           Whether a new makegood associated with this line item can be created. This attribute is read-only.
         • pauseRole - optional; type NegotiationRole - type string with restriction - enum { 'BUYER', 'SELLER', 'UNKNOWN' }
           The {@link NegotiationRole} that paused the proposal line item, i.e. {@link NegotiationRole#seller} or {@link NegotiationRole#buyer}, or {@code null} when the proposal is not paused. This attribute is read-only.
         • pauseReason - optional; type string
           The reason for pausing the {@link ProposalLineItem}, provided by the {@link pauseRole}. It is {@code null} when the {@link ProposalLineItem} is not paused. This attribute is read-only.
   Fault:
   ApiException (wsdlsoap:fault, use = literal)Source code
   ApiException type ApiExceptionFault

   Exception class for holding a list of service errors.

   Base class for exceptions.

   • message - optional; type string
     Error message.

   • errors - optional, unbounded; type ApiError
     The API error base class that provides details about an error that occurred while processing a service request.

     The OGNL field path is provided for parsers to identify the request data element that may have caused the error.

     • fieldPath - optional; type string
       The OGNL field path to identify cause of error.
     • fieldPathElements - optional, unbounded; type FieldPathElement
       A parsed copy of the field path. For example, the field path "operations[1].operand" corresponds to this list: {FieldPathElement(field = "operations", index = 1), FieldPathElement(field = "operand", index = null)}.
       A segment of a field path. Each dot in a field path defines a new segment.
       • field - optional; type string
         The name of a field in lower camelcase. (e.g. "biddingStrategy")
       • index - optional; type int
         For list fields, this is a 0-indexed position in the list. Null for non-list fields.
     • trigger - optional; type string
       The data that caused the error.
     • errorString - optional; type string
       A simple string representation of the error and reason.
     List of errors.

   A fault element of type ApiException.
3. getProposalLineItemsByStatement
   Source code
   Description:
   Gets a {@link ProposalLineItemPage} of {@link ProposalLineItem} objects that satisfy the given {@link Statement#query}. The following fields are supported for filtering:

   PQL Property	Object Property
   {@code id}	{@link ProposalLineItem#id}
   {@code name}	{@link ProposalLineItem#name}
   {@code proposalId}	{@link ProposalLineItem#proposalId}
   {@code startDateTime}	{@link ProposalLineItem#startDateTime}
   {@code endDateTime}	{@link ProposalLineItem#endDateTime}
   {@code isArchived}	{@link ProposalLineItem#isArchived}
   {@code lastModifiedDateTime}	{@link ProposalLineItem#lastModifiedDateTime}
   {@code isProgrammatic}	{@link ProposalLineItem#isProgrammatic}

   Operation type:
   Request-response. The endpoint receives a message, and sends a correlated message.
   Input:
   getProposalLineItemsByStatementRequest (wsdlsoap:header, use = literal, part = RequestHeader)Source code
   parameters type getProposalLineItemsByStatement

   Gets a {@link ProposalLineItemPage} of {@link ProposalLineItem} objects that satisfy the given {@link Statement#query}. The following fields are supported for filtering:

   PQL Property	Object Property
   {@code id}	{@link ProposalLineItem#id}
   {@code name}	{@link ProposalLineItem#name}
   {@code proposalId}	{@link ProposalLineItem#proposalId}
   {@code startDateTime}	{@link ProposalLineItem#startDateTime}
   {@code endDateTime}	{@link ProposalLineItem#endDateTime}
   {@code isArchived}	{@link ProposalLineItem#isArchived}
   {@code lastModifiedDateTime}	{@link ProposalLineItem#lastModifiedDateTime}
   {@code isProgrammatic}	{@link ProposalLineItem#isProgrammatic}

   • filterStatement - optional; type Statement
     Captures the {@code WHERE}, {@code ORDER BY} and {@code LIMIT} clauses of a PQL query. Statements are typically used to retrieve objects of a predefined domain type, which makes SELECT clause unnecessary.

     An example query text might be {@code "WHERE status = 'ACTIVE' ORDER BY id LIMIT 30"}.

     Statements support bind variables. These are substitutes for literals and can be thought of as input parameters to a PQL query.

     An example of such a query might be {@code "WHERE id = :idValue"}.

     Statements also support use of the LIKE keyword. This provides wildcard string matching.

     An example of such a query might be {@code "WHERE name LIKE '%searchString%'"}.

     The value for the variable idValue must then be set with an object of type {@link Value}, e.g., {@link NumberValue}, {@link TextValue} or {@link BooleanValue}.
     • query - optional; type string
       Holds the query in PQL syntax. The syntax is:
       [WHERE {[AND | OR] ...}]
[ORDER BY [ASC | DESC]]
[LIMIT {[,] } | { OFFSET }]
       

       
            := {< | <= | > | >= | = | != }

     := {< | <= | > | >= | = | != }
:= IN
:= IS NULL
:= LIKE
:= :
       

     • values - optional, unbounded; type String_ValueMapEntry
       Holds keys and values for bind variables and their values. The key is the name of the bind variable. The value is the literal value of the variable.

       In the example {@code "WHERE status = :bindStatus ORDER BY id LIMIT 30"}, the bind variable, represented by {@code :bindStatus} is named {@code bindStatus}, which would also be the parameter map key. The bind variable's value would be represented by a parameter map value of type {@link TextValue}. The final result, for example, would be an entry of {@code "bindStatus" => StringParam("ACTIVE")}.

       This represents an entry in a map with a key of type String and value of type Value.
       • key - optional; type string
       • value - optional; type Value
         {@code Value} represents a value.
   Output:
   getProposalLineItemsByStatementResponse (wsdlsoap:header, use = literal, part = ResponseHeader)Source code
   parameters type getProposalLineItemsByStatementResponse

   • rval - optional; type ProposalLineItemPage
     Captures a page of {@link ProposalLineItem} objects.
     • results - optional, unbounded; type ProposalLineItem
       A {@code ProposalLineItem} is added to a programmatic {@link Proposal} and is similar to a delivery {@link LineItem}. It contains delivery details including information like impression goal or quantity, start and end times, and targeting.
       • id - optional; type long
         The unique ID of the {@code ProposalLineItem}. This attribute is read-only.
       • proposalId - optional; type long
         The unique ID of the {@link Proposal}, to which the {@code ProposalLineItem} belongs. This attribute is required for creation and then is readonly. This attribute is required.
       • name - optional; type string
         The name of the {@code ProposalLineItem} which should be unique under the same {@link Proposal}. This attribute has a maximum length of 255 characters. This attribute can be configured as editable after the proposal has been submitted. Please check with your network administrator for editable fields configuration. This attribute is required.
       • startDateTime - optional; type DateTime
         Represents a date combined with the time of day.
         • date - optional; type Date
           Represents a date.
           • year - optional; type int
             Year (e.g., 2009)
           • month - optional; type int
             Month (1..12)
           • day - optional; type int
             Day (1..31)
         • hour - optional; type int
         • minute - optional; type int
         • second - optional; type int
         • timeZoneId - optional; type string
         The date and time at which the line item associated with the {@code ProposalLineItem} is enabled to begin serving. This attribute is optional during creation, but required and must be in the future when it turns into a line item. The {@link DateTime#timeZoneID} is required if start date time is not {@code null}. This attribute becomes readonly once the {@code ProposalLineItem} has started delivering.
       • endDateTime - optional; type DateTime
         Represents a date combined with the time of day.
         • date - optional; type Date
           Represents a date.
           • year - optional; type int
             Year (e.g., 2009)
           • month - optional; type int
             Month (1..12)
           • day - optional; type int
             Day (1..31)
         • hour - optional; type int
         • minute - optional; type int
         • second - optional; type int
         • timeZoneId - optional; type string
         The date and time at which the line item associated with the {@code ProposalLineItem} stops beening served. This attribute is optional during creation, but required and must be after the {@link #startDateTime}. The {@link DateTime#timeZoneID} is required if end date time is not {@code null}.
       • internalNotes - optional; type string
         Provides any additional notes that may annotate the {@code ProposalLineItem}. This attribute is optional and has a maximum length of 65,535 characters. This attribute can be configured as editable after the proposal has been submitted. Please check with your network administrator for editable fields configuration.
       • isArchived - optional; type boolean
         The archival status of the {@code ProposalLineItem}. This attribute is read-only.
       • goal - optional; type Goal
         Defines the criteria a {@link LineItem} needs to satisfy to meet its delivery goal.
         • goalType - optional; type GoalType - type string with restriction - enum { 'NONE', 'LIFETIME', 'DAILY', 'UNKNOWN' }
           The type of the goal for the {@code LineItem}. It defines the period over which the goal for {@code LineItem} should be reached.
         • unitType - optional; type UnitType - type string with restriction - enum { 'IMPRESSIONS', 'CLICKS', 'CLICK_THROUGH_CPA_CONVERSIONS', 'VIEW_THROUGH_CPA_CONVERSIONS', 'TOTAL_CPA_CONVERSIONS', 'VIEWABLE_IMPRESSIONS', 'IN_TARGET_IMPRESSIONS', 'UNKNOWN' }
           The type of the goal unit for the {@code LineItem}.
         • units - optional; type long
           If this is a primary goal, it represents the number or percentage of impressions or clicks that will be reserved for the {@code LineItem}. If the line item is of type {@link LineItemType#SPONSORSHIP}, it represents the percentage of available impressions reserved. If the line item is of type {@link LineItemType#BULK} or {@link LineItemType#PRICE_PRIORITY}, it represents the number of remaining impressions reserved. If the line item is of type {@link LineItemType#NETWORK} or {@link LineItemType#HOUSE}, it represents the percentage of remaining impressions reserved.

           If this is a secondary goal, it represents the number of impressions or conversions that the line item will stop serving at if reached. For valid line item types, see {@link LineItem#secondaryGoals}.

         The goal(i.e. contracted quantity, quantity or limit) that this {@code ProposalLineItem} is associated with, which is used in its pacing and budgeting. {@link Goal#units} must be greater than 0 when the proposal line item turns into a line item, {@link Goal#goalType} and {@link Goal#unitType} are readonly. For a Preferred deal {@code ProposalLineItem}, the goal type can only be {@link GoalType#NONE}. This attribute is required.
       • secondaryGoals - optional, unbounded; type Goal
         Defines the criteria a {@link LineItem} needs to satisfy to meet its delivery goal.
         • goalType - optional; type GoalType - type string with restriction - enum { 'NONE', 'LIFETIME', 'DAILY', 'UNKNOWN' }
           The type of the goal for the {@code LineItem}. It defines the period over which the goal for {@code LineItem} should be reached.
         • unitType - optional; type UnitType - type string with restriction - enum { 'IMPRESSIONS', 'CLICKS', 'CLICK_THROUGH_CPA_CONVERSIONS', 'VIEW_THROUGH_CPA_CONVERSIONS', 'TOTAL_CPA_CONVERSIONS', 'VIEWABLE_IMPRESSIONS', 'IN_TARGET_IMPRESSIONS', 'UNKNOWN' }
           The type of the goal unit for the {@code LineItem}.
         • units - optional; type long
           If this is a primary goal, it represents the number or percentage of impressions or clicks that will be reserved for the {@code LineItem}. If the line item is of type {@link LineItemType#SPONSORSHIP}, it represents the percentage of available impressions reserved. If the line item is of type {@link LineItemType#BULK} or {@link LineItemType#PRICE_PRIORITY}, it represents the number of remaining impressions reserved. If the line item is of type {@link LineItemType#NETWORK} or {@link LineItemType#HOUSE}, it represents the percentage of remaining impressions reserved.

           If this is a secondary goal, it represents the number of impressions or conversions that the line item will stop serving at if reached. For valid line item types, see {@link LineItem#secondaryGoals}.

         The secondary goals that this {@code ProposalLineItem} is associated with. For a programmatic line item with the properties {@link RateType#CPM} and {@link LineItemType#SPONSORSHIP}, this field will have one goal which describes the impressions cap. For other cases, this field is an empty list.
       • contractedUnitsBought - optional; type long
         The contracted number of daily minimum impressions used for {@link LineItemType#SPONSORSHIP} {@code ProposalLineItem} deals with a rate type of {@link RateType#CPD}.

         This attribute is required for percentage-based-goal {@link ProposalLineItem proposal line items}. It does not impact ad-serving and is for reporting purposes only.

       • deliveryRateType - optional; type DeliveryRateType - type string with restriction - enum { 'EVENLY', 'FRONTLOADED', 'AS_FAST_AS_POSSIBLE' }
         The strategy for delivering ads over the course of the {@code ProposalLineItem}'s duration. This attribute is required. For a Preferred deal {@code ProposalLineItem}, the value can only be {@link DeliveryRateType#FRONTLOADED}.
       • roadblockingType - optional; type RoadblockingType - type string with restriction - enum { 'ONLY_ONE', 'ONE_OR_MORE', 'AS_MANY_AS_POSSIBLE', 'ALL_ROADBLOCK', 'CREATIVE_SET' }
         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 during creation and defaults to the {@link Product#roadblockingType product's roadblocking type}, or {@link RoadblockingType#ONE_OR_MORE} if not specified by the product.
       • companionDeliveryOption - optional; type CompanionDeliveryOption - type string with restriction - enum { 'OPTIONAL', 'AT_LEAST_ONE', 'ALL', 'UNKNOWN' }
         The delivery option for companions. This is only valid if the roadblocking type is {@link RoadblockingType#CREATIVE_SET}. The default value for roadblocking creatives is {@link CompanionDeliveryOption#OPTIONAL}. The default value in other cases is {@link CompanionDeliveryOption#UNKNOWN}. Providing something other than {@link CompanionDeliveryOption#UNKNOWN} will cause an error.
       • videoMaxDuration - optional; type long
         The max duration of a video creative associated with this {@code ProposalLineItem} in milliseconds. This attribute is optional, defaults to the {@link Product#videoMaxDuration} on the {@link Product} it was created with, and only meaningful if this is a video proposal line item.
       • videoCreativeSkippableAdType - optional; type SkippableAdType - type string with restriction - enum { 'UNKNOWN', 'DISABLED', 'ENABLED', 'INSTREAM_SELECT', 'ANY' }
         The proposal line item's creatives' skippability. This attribute is optional, only applicable for video proposal line items, and defaults to {@link SkippableAdType#NOT_SKIPPABLE}.
       • frequencyCaps - optional, unbounded; type FrequencyCap
         Represents a limit on the number of times a single viewer can be exposed to the same {@link LineItem} in a specified time period.
         • maxImpressions - optional; type int
           The maximum number of impressions than can be served to a user within a specified time period.
         • numTimeUnits - optional; type int
           The number of {@code FrequencyCap#timeUnit} to represent the total time period.
         • timeUnit - optional; type TimeUnit - type string with restriction - enum { 'MINUTE', 'HOUR', 'DAY', 'WEEK', 'MONTH', 'LIFETIME', 'POD', 'STREAM', 'UNKNOWN' }
           The unit of time for specifying the time period.
         The set of frequency capping units for this {@code ProposalLineItem}. This attribute is optional during creation and defaults to the {@link Product#frequencyCaps product's frequency caps} if {@link Product#allowFrequencyCapsCustomization} is {@code false}.
       • dfpLineItemId - optional; type long
         The unique ID of corresponding {@link LineItem}. This will be {@code null} if the {@link Proposal} has not been pushed to Ad Manager. This attribute is read-only.
       • lineItemType - optional; type LineItemType - type string with restriction - enum { 'SPONSORSHIP', 'STANDARD', 'NETWORK', 'BULK', 'PRICE_PRIORITY', 'HOUSE', 'LEGACY_DFP', 'CLICK_TRACKING', 'ADSENSE', 'AD_EXCHANGE', 'BUMPER', 'ADMOB', 'PREFERRED_DEAL', 'UNKNOWN' }
         The corresponding {@link LineItemType} of the {@code ProposalLineItem}. For a programmatic {@code ProposalLineItem}, the value can only be one of:

         • {@link LineItemType#SPONSORSHIP}
         • {@link LineItemType#STANDARD}
         • {@link LineItemType#PREFERRED_DEAL}

         This attribute is required.
       • lineItemPriority - optional; type int
         The priority for the corresponding {@link LineItem} of the {@code ProposalLineItem}. This attribute is optional during creation and defaults to the default priority of the {@link #lineItemType}. For forecasting, this attribute is optional and has a default value assigned by Google. See {@link LineItem#priority} for more information.
       • rateType - optional; type RateType - type string with restriction - enum { 'CPM', 'CPD', 'VCPM', 'CPM_IN_TARGET', 'UNKNOWN' }
         The method used for billing the {@code ProposalLineItem}. This attribute is read-only. This attribute is required.
       • creativePlaceholders - optional, unbounded; type CreativePlaceholder
         A {@code CreativePlaceholder} describes a slot that a creative is expected to fill. This is used primarily to help in forecasting, and also to validate that the correct creatives are associated with the line item. A {@code CreativePlaceholder} must contain a size, and it can optionally contain companions. Companions are only valid if the line item's environment type is {@link EnvironmentType#VIDEO_PLAYER}.
         • size - optional; type Size
           The dimensions that the creative is expected to have. This attribute is required.
           Represents the dimensions of an {@link AdUnit}, {@link LineItem} or {@link Creative}.

           For interstitial size (out-of-page), native, ignored and fluid size, {@link Size} must be 1x1.

           • width - optional; type int
             The width of the {@link AdUnit}, {@link LineItem} or {@link Creative}.
           • height - optional; type int
             The height of the {@link AdUnit}, {@link LineItem} or {@link Creative}.
           • isAspectRatio - optional; type boolean
             Whether this size represents an aspect ratio.
         • creativeTemplateId - optional; type long
           The native creative template ID.

           This value is only required if {@link #creativeSizeType} is {@link CreativeSizeType#NATIVE}.

         • companions - optional, unbounded; type CreativePlaceholder
           A {@code CreativePlaceholder} describes a slot that a creative is expected to fill. This is used primarily to help in forecasting, and also to validate that the correct creatives are associated with the line item. A {@code CreativePlaceholder} must contain a size, and it can optionally contain companions. Companions are only valid if the line item's environment type is {@link EnvironmentType#VIDEO_PLAYER}.
           • size - optional; type Size
             The dimensions that the creative is expected to have. This attribute is required.
             Represents the dimensions of an {@link AdUnit}, {@link LineItem} or {@link Creative}.

             For interstitial size (out-of-page), native, ignored and fluid size, {@link Size} must be 1x1.

             • width - optional; type int
               The width of the {@link AdUnit}, {@link LineItem} or {@link Creative}.
             • height - optional; type int
               The height of the {@link AdUnit}, {@link LineItem} or {@link Creative}.
             • isAspectRatio - optional; type boolean
               Whether this size represents an aspect ratio.
           • creativeTemplateId - optional; type long
             The native creative template ID.

             This value is only required if {@link #creativeSizeType} is {@link CreativeSizeType#NATIVE}.

           • companions - optional, unbounded; type CreativePlaceholder
             A {@code CreativePlaceholder} describes a slot that a creative is expected to fill. This is used primarily to help in forecasting, and also to validate that the correct creatives are associated with the line item. A {@code CreativePlaceholder} must contain a size, and it can optionally contain companions. Companions are only valid if the line item's environment type is {@link EnvironmentType#VIDEO_PLAYER}.
             • size - optional; type Size
               The dimensions that the creative is expected to have. This attribute is required.
               Represents the dimensions of an {@link AdUnit}, {@link LineItem} or {@link Creative}.

               For interstitial size (out-of-page), native, ignored and fluid size, {@link Size} must be 1x1.

               • width - optional; type int
                 The width of the {@link AdUnit}, {@link LineItem} or {@link Creative}.
               • height - optional; type int
                 The height of the {@link AdUnit}, {@link LineItem} or {@link Creative}.
               • isAspectRatio - optional; type boolean
                 Whether this size represents an aspect ratio.
             • creativeTemplateId - optional; type long
               The native creative template ID.

               This value is only required if {@link #creativeSizeType} is {@link CreativeSizeType#NATIVE}.

             • companions - optional, unbounded; type CreativePlaceholder... is recursive
               The companions that the creative is expected to have. This attribute can only be set if the line item it belongs to has a {@link LineItem#environmentType} of {@link EnvironmentType#VIDEO_PLAYER} or {@link LineItem#roadblockingType} of {@link RoadblockingType#CREATIVE_SET}.
             • appliedLabels - optional, unbounded; type AppliedLabel
               Represents a {@link Label} that can be applied to an entity. To negate an inherited label, create an {@code AppliedLabel} with {@code labelId} as the inherited label's ID and {@code isNegated} set to true.
               • labelId - optional; type long
                 The ID of a created {@link Label}.
               • isNegated - optional; type boolean
                 {@code isNegated} should be set to {@code true} to negate the effects of {@code labelId}.
               The set of label frequency caps applied directly to this creative placeholder.
             • effectiveAppliedLabels - optional, unbounded; type AppliedLabel
               Represents a {@link Label} that can be applied to an entity. To negate an inherited label, create an {@code AppliedLabel} with {@code labelId} as the inherited label's ID and {@code isNegated} set to true.
               • labelId - optional; type long
                 The ID of a created {@link Label}.
               • isNegated - optional; type boolean
                 {@code isNegated} should be set to {@code true} to negate the effects of {@code labelId}.
               Contains the set of labels applied directly to this creative placeholder as well as those inherited from the creative template from which this creative placeholder was instantiated. This field is readonly and is assigned by Google.
             • expectedCreativeCount - optional; type int
               Expected number of creatives that will be uploaded corresponding to this creative placeholder. This estimate is used to improve the accuracy of forecasting; for example, if label frequency capping limits the number of times a creative may be served.
             • creativeSizeType - optional; type CreativeSizeType - type string with restriction - enum { 'PIXEL', 'ASPECT_RATIO', 'INTERSTITIAL', 'IGNORED', 'NATIVE', 'AUDIO' }
               Describes the types of sizes a creative can be. By default, the creative's size is {@link CreativeSizeType#PIXEL}, which is a dimension based size (width-height pair).
             • targetingName - optional; type string
               The name of the {@link CreativeTargeting} for creatives this placeholder represents.

               This attribute is optional. Specifying creative targeting here is for forecasting purposes only and has no effect on serving. The same creative targeting should be specified on a {@link LineItemCreativeAssociation} when associating a {@link Creative} with the {@link LineItem}.

             • isAmpOnly - optional; type boolean
               Indicate if the expected creative of this placeholder has an AMP only variant.

               This attribute is optional. It is for forecasting purposes only and has no effect on serving.

             The companions that the creative is expected to have. This attribute can only be set if the line item it belongs to has a {@link LineItem#environmentType} of {@link EnvironmentType#VIDEO_PLAYER} or {@link LineItem#roadblockingType} of {@link RoadblockingType#CREATIVE_SET}.
           • appliedLabels - optional, unbounded; type AppliedLabel
             Represents a {@link Label} that can be applied to an entity. To negate an inherited label, create an {@code AppliedLabel} with {@code labelId} as the inherited label's ID and {@code isNegated} set to true.
             • labelId - optional; type long
               The ID of a created {@link Label}.
             • isNegated - optional; type boolean
               {@code isNegated} should be set to {@code true} to negate the effects of {@code labelId}.
             The set of label frequency caps applied directly to this creative placeholder.
           • effectiveAppliedLabels - optional, unbounded; type AppliedLabel
             Represents a {@link Label} that can be applied to an entity. To negate an inherited label, create an {@code AppliedLabel} with {@code labelId} as the inherited label's ID and {@code isNegated} set to true.
             • labelId - optional; type long
               The ID of a created {@link Label}.
             • isNegated - optional; type boolean
               {@code isNegated} should be set to {@code true} to negate the effects of {@code labelId}.
             Contains the set of labels applied directly to this creative placeholder as well as those inherited from the creative template from which this creative placeholder was instantiated. This field is readonly and is assigned by Google.
           • expectedCreativeCount - optional; type int
             Expected number of creatives that will be uploaded corresponding to this creative placeholder. This estimate is used to improve the accuracy of forecasting; for example, if label frequency capping limits the number of times a creative may be served.
           • creativeSizeType - optional; type CreativeSizeType - type string with restriction - enum { 'PIXEL', 'ASPECT_RATIO', 'INTERSTITIAL', 'IGNORED', 'NATIVE', 'AUDIO' }
             Describes the types of sizes a creative can be. By default, the creative's size is {@link CreativeSizeType#PIXEL}, which is a dimension based size (width-height pair).
           • targetingName - optional; type string
             The name of the {@link CreativeTargeting} for creatives this placeholder represents.

             This attribute is optional. Specifying creative targeting here is for forecasting purposes only and has no effect on serving. The same creative targeting should be specified on a {@link LineItemCreativeAssociation} when associating a {@link Creative} with the {@link LineItem}.

           • isAmpOnly - optional; type boolean
             Indicate if the expected creative of this placeholder has an AMP only variant.

             This attribute is optional. It is for forecasting purposes only and has no effect on serving.

           The companions that the creative is expected to have. This attribute can only be set if the line item it belongs to has a {@link LineItem#environmentType} of {@link EnvironmentType#VIDEO_PLAYER} or {@link LineItem#roadblockingType} of {@link RoadblockingType#CREATIVE_SET}.
         • appliedLabels - optional, unbounded; type AppliedLabel
           Represents a {@link Label} that can be applied to an entity. To negate an inherited label, create an {@code AppliedLabel} with {@code labelId} as the inherited label's ID and {@code isNegated} set to true.
           • labelId - optional; type long
             The ID of a created {@link Label}.
           • isNegated - optional; type boolean
             {@code isNegated} should be set to {@code true} to negate the effects of {@code labelId}.
           The set of label frequency caps applied directly to this creative placeholder.
         • effectiveAppliedLabels - optional, unbounded; type AppliedLabel
           Represents a {@link Label} that can be applied to an entity. To negate an inherited label, create an {@code AppliedLabel} with {@code labelId} as the inherited label's ID and {@code isNegated} set to true.
           • labelId - optional; type long
             The ID of a created {@link Label}.
           • isNegated - optional; type boolean
             {@code isNegated} should be set to {@code true} to negate the effects of {@code labelId}.
           Contains the set of labels applied directly to this creative placeholder as well as those inherited from the creative template from which this creative placeholder was instantiated. This field is readonly and is assigned by Google.
         • expectedCreativeCount - optional; type int
           Expected number of creatives that will be uploaded corresponding to this creative placeholder. This estimate is used to improve the accuracy of forecasting; for example, if label frequency capping limits the number of times a creative may be served.
         • creativeSizeType - optional; type CreativeSizeType - type string with restriction - enum { 'PIXEL', 'ASPECT_RATIO', 'INTERSTITIAL', 'IGNORED', 'NATIVE', 'AUDIO' }
           Describes the types of sizes a creative can be. By default, the creative's size is {@link CreativeSizeType#PIXEL}, which is a dimension based size (width-height pair).
         • targetingName - optional; type string
           The name of the {@link CreativeTargeting} for creatives this placeholder represents.

           This attribute is optional. Specifying creative targeting here is for forecasting purposes only and has no effect on serving. The same creative targeting should be specified on a {@link LineItemCreativeAssociation} when associating a {@link Creative} with the {@link LineItem}.

         • isAmpOnly - optional; type boolean
           Indicate if the expected creative of this placeholder has an AMP only variant.

           This attribute is optional. It is for forecasting purposes only and has no effect on serving.

         Details about the creatives that are expected to serve through the {@code ProposalLineItem}. This attribute is optional during creation and defaults to the {@link Product#creativePlaceholders product's creative placeholders}. This attribute is required.
       • targeting - optional; type Targeting
         Contains the targeting criteria for the {@code ProposalLineItem}. This attribute is required.
         Contains targeting criteria for {@link LineItem} objects. See {@link LineItem#targeting}.
         • geoTargeting - optional; type GeoTargeting
           Provides line items the ability to target geographical locations. By default, line items target all countries and their subdivisions. With geographical targeting, you can target line items to specific countries, regions, metro areas, and cities. You can also exclude the same.

           The following rules apply for geographical targeting:

           • You cannot target and exclude the same location.
           • You cannot target a child whose parent has been excluded. For example, if the state of Illinois has been excluded, then you cannot target Chicago.
           • You must not target a location if you are also targeting its parent. For example, if you are targeting New York City, you must not have the state of New York as one of the targeted locations.
           • You cannot explicitly define inclusions or exclusions that are already implicit. For example, if you explicitly include California, you implicitly exclude all other states. You therefore cannot explicitly exclude Florida, because it is already implicitly excluded. Conversely if you explicitly exclude Florida, you cannot explicitly include California.
           • targetedLocations - optional, unbounded; type Location
             The geographical locations being targeted by the {@link LineItem}.
             A {@link Location} represents a geographical entity that can be targeted. If a location type is not available because of the API version you are using, the location will be represented as just the base class, otherwise it will be sub-classed correctly.
             • id - optional; type long
               Uniquely identifies each {@code Location}.
             • type - optional; type string
               The location type for this geographical entity (ex. "COUNTRY", "CITY", "STATE", "COUNTY", etc.)
             • canonicalParentId - optional; type int
               The nearest location parent's ID for this geographical entity.
             • displayName - optional; type string
               The localized name of the geographical entity.
           • excludedLocations - optional, unbounded; type Location
             The geographical locations being excluded by the {@link LineItem}.
             A {@link Location} represents a geographical entity that can be targeted. If a location type is not available because of the API version you are using, the location will be represented as just the base class, otherwise it will be sub-classed correctly.
             • id - optional; type long
               Uniquely identifies each {@code Location}.
             • type - optional; type string
               The location type for this geographical entity (ex. "COUNTRY", "CITY", "STATE", "COUNTY", etc.)
             • canonicalParentId - optional; type int
               The nearest location parent's ID for this geographical entity.
             • displayName - optional; type string
               The localized name of the geographical entity.
           Specifies what geographical locations are targeted by the {@link LineItem}. This attribute is optional.
         • inventoryTargeting - optional; type InventoryTargeting
           A collection of targeted and excluded ad units and placements.
           • targetedAdUnits - optional, unbounded; type AdUnitTargeting
             Represents targeted or excluded ad units.
             • adUnitId - optional; type string
               Included or excluded ad unit id.
             • includeDescendants - optional; type boolean
               Whether or not all descendants are included (or excluded) as part of including (or excluding) this ad unit. By default, the value is {@code true} which means targeting this ad unit will target all of its descendants.
             A list of targeted {@link AdUnitTargeting}.
           • excludedAdUnits - optional, unbounded; type AdUnitTargeting
             Represents targeted or excluded ad units.
             • adUnitId - optional; type string
               Included or excluded ad unit id.
             • includeDescendants - optional; type boolean
               Whether or not all descendants are included (or excluded) as part of including (or excluding) this ad unit. By default, the value is {@code true} which means targeting this ad unit will target all of its descendants.
             A list of excluded {@link AdUnitTargeting}.
           • targetedPlacementIds - optional, unbounded; type long
             A list of targeted {@link Placement} ids.
           Specifies what inventory is targeted by the {@link LineItem}. This attribute is required. The line item must target at least one ad unit or placement.
         • dayPartTargeting - optional; type DayPartTargeting
           Modify the delivery times of line items for particular days of the week. By default, line items are served at all days and times.
           • dayParts - optional, unbounded; type DayPart
             {@code DayPart} represents a time-period within a day of the week which is targeted by a {@link LineItem}.
             • dayOfWeek - optional; type DayOfWeek - type string with restriction - enum { 'MONDAY', 'TUESDAY', 'WEDNESDAY', 'THURSDAY', 'FRIDAY', 'SATURDAY', 'SUNDAY' }
               Day of the week the target applies to. This field is required.
             • startTime - optional; type TimeOfDay
               Represents the start time of the targeted period (inclusive).
               Represents a specific time in a day.
               • hour - optional; type int
                 Hour in 24 hour time (0..24). This field must be between 0 and 24, inclusive. This field is required.
               • minute - optional; type MinuteOfHour - type string with restriction - enum { 'ZERO', 'FIFTEEN', 'THIRTY', 'FORTY_FIVE' }
                 Minutes in an hour. Currently, only 0, 15, 30, and 45 are supported. This field is required.
             • endTime - optional; type TimeOfDay
               Represents the end time of the targeted period (exclusive).
               Represents a specific time in a day.
               • hour - optional; type int
                 Hour in 24 hour time (0..24). This field must be between 0 and 24, inclusive. This field is required.
               • minute - optional; type MinuteOfHour - type string with restriction - enum { 'ZERO', 'FIFTEEN', 'THIRTY', 'FORTY_FIVE' }
                 Minutes in an hour. Currently, only 0, 15, 30, and 45 are supported. This field is required.
             Specifies days of the week and times at which a {@code LineItem} will be delivered.

             If targeting all days and times, this value will be ignored.

           • timeZone - optional; type DeliveryTimeZone - type string with restriction - enum { 'PUBLISHER', 'BROWSER' }
             Specifies the time zone to be used for delivering {@link LineItem} objects. This attribute is optional and defaults to {@link DeliveryTimeZone#BROWSER}.

             Setting this has no effect if targeting all days and times.

           Specifies the days of the week and times that are targeted by the {@link LineItem}. This attribute is optional.
         • dateTimeRangeTargeting - optional; type DateTimeRangeTargeting
           The date time ranges that the line item is eligible to serve.
           • targetedDateTimeRanges - optional, unbounded; type DateTimeRange
             Represents a range of dates (combined with time of day) that has an upper and/or lower bound.
             • startDateTime - optional; type DateTime
               Represents a date combined with the time of day.
               • date - optional; type Date
                 Represents a date.
                 • year - optional; type int
                   Year (e.g., 2009)
                 • month - optional; type int
                   Month (1..12)
                 • day - optional; type int
                   Day (1..31)
               • hour - optional; type int
               • minute - optional; type int
               • second - optional; type int
               • timeZoneId - optional; type string
               The start date time of this range. This field is optional and if it is not set then there is no lower bound on the date time range. If this field is not set then {@code endDateTime} must be specified.
             • endDateTime - optional; type DateTime
               Represents a date combined with the time of day.
               • date - optional; type Date
                 Represents a date.
                 • year - optional; type int
                   Year (e.g., 2009)
                 • month - optional; type int
                   Month (1..12)
                 • day - optional; type int
                   Day (1..31)
               • hour - optional; type int
               • minute - optional; type int
               • second - optional; type int
               • timeZoneId - optional; type string
               The end date time of this range. This field is optional and if it is not set then there is no upper bound on the date time range. If this field is not set then {@code startDateTime} must be specified.
           Specifies the dates and time ranges that are targeted by the {@link LineItem}. This attribute is optional.
         • technologyTargeting - optional; type TechnologyTargeting
           Provides {@link LineItem} objects the ability to target or exclude technologies.
           • bandwidthGroupTargeting - optional; type BandwidthGroupTargeting
             The bandwidth groups being targeted by the {@link LineItem}.
             Represents bandwidth groups that are being targeted or excluded by the {@link LineItem}.
             • isTargeted - optional; type boolean
               Indicates whether bandwidth groups should be targeted or excluded. This attribute is optional and defaults to {@code true}.
             • bandwidthGroups - optional, unbounded; type Technology
               The bandwidth groups that are being targeted or excluded by the {@link LineItem}.
               Represents a technology entity that can be targeted.
               • id - optional; type long
                 The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
               • name - optional; type string
                 The name of the technology being targeting. This value is read-only and is assigned by Google.
           • browserTargeting - optional; type BrowserTargeting
             The browsers being targeted by the {@link LineItem}.
             Represents browsers that are being targeted or excluded by the {@link LineItem}.
             • isTargeted - optional; type boolean
               Indicates whether browsers should be targeted or excluded. This attribute is optional and defaults to {@code true}.
             • browsers - optional, unbounded; type Technology
               Browsers that are being targeted or excluded by the {@link LineItem}.
               Represents a technology entity that can be targeted.
               • id - optional; type long
                 The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
               • name - optional; type string
                 The name of the technology being targeting. This value is read-only and is assigned by Google.
           • browserLanguageTargeting - optional; type BrowserLanguageTargeting
             The languages of browsers being targeted by the {@link LineItem}.
             Represents browser languages that are being targeted or excluded by the {@link LineItem}.
             • isTargeted - optional; type boolean
               Indicates whether browsers languages should be targeted or excluded. This attribute is optional and defaults to {@code true}.
             • browserLanguages - optional, unbounded; type Technology
               Browser languages that are being targeted or excluded by the {@link LineItem}.
               Represents a technology entity that can be targeted.
               • id - optional; type long
                 The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
               • name - optional; type string
                 The name of the technology being targeting. This value is read-only and is assigned by Google.
           • deviceCapabilityTargeting - optional; type DeviceCapabilityTargeting
             The device capabilities being targeted by the {@link LineItem}.
             Represents device capabilities that are being targeted or excluded by the {@link LineItem}.
             • targetedDeviceCapabilities - optional, unbounded; type Technology
               Device capabilities that are being targeted by the {@link LineItem}.
               Represents a technology entity that can be targeted.
               • id - optional; type long
                 The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
               • name - optional; type string
                 The name of the technology being targeting. This value is read-only and is assigned by Google.
             • excludedDeviceCapabilities - optional, unbounded; type Technology
               Device capabilities that are being excluded by the {@link LineItem}.
               Represents a technology entity that can be targeted.
               • id - optional; type long
                 The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
               • name - optional; type string
                 The name of the technology being targeting. This value is read-only and is assigned by Google.
           • deviceCategoryTargeting - optional; type DeviceCategoryTargeting
             The device categories being targeted by the {@link LineItem}.
             Represents device categories that are being targeted or excluded by the {@link LineItem}.
             • targetedDeviceCategories - optional, unbounded; type Technology
               Device categories that are being targeted by the {@link LineItem}.
               Represents a technology entity that can be targeted.
               • id - optional; type long
                 The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
               • name - optional; type string
                 The name of the technology being targeting. This value is read-only and is assigned by Google.
             • excludedDeviceCategories - optional, unbounded; type Technology
               Device categories that are being excluded by the {@link LineItem}.
               Represents a technology entity that can be targeted.
               • id - optional; type long
                 The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
               • name - optional; type string
                 The name of the technology being targeting. This value is read-only and is assigned by Google.
           • deviceManufacturerTargeting - optional; type DeviceManufacturerTargeting
             The device manufacturers being targeted by the {@link LineItem}.
             Represents device manufacturer that are being targeted or excluded by the {@link LineItem}.
             • isTargeted - optional; type boolean
               Indicates whether device manufacturers should be targeted or excluded. This attribute is optional and defaults to {@code true}.
             • deviceManufacturers - optional, unbounded; type Technology
               Device manufacturers that are being targeted or excluded by the {@link LineItem}.
               Represents a technology entity that can be targeted.
               • id - optional; type long
                 The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
               • name - optional; type string
                 The name of the technology being targeting. This value is read-only and is assigned by Google.
           • mobileCarrierTargeting - optional; type MobileCarrierTargeting
             The mobile carriers being targeted by the {@link LineItem}.
             Represents mobile carriers that are being targeted or excluded by the {@link LineItem}.
             • isTargeted - optional; type boolean
               Indicates whether mobile carriers should be targeted or excluded. This attribute is optional and defaults to {@code true}.
             • mobileCarriers - optional, unbounded; type Technology
               Mobile carriers that are being targeted or excluded by the {@link LineItem}.
               Represents a technology entity that can be targeted.
               • id - optional; type long
                 The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
               • name - optional; type string
                 The name of the technology being targeting. This value is read-only and is assigned by Google.
           • mobileDeviceTargeting - optional; type MobileDeviceTargeting
             The mobile devices being targeted by the {@link LineItem}.
             Represents mobile devices that are being targeted or excluded by the {@link LineItem}.
             • targetedMobileDevices - optional, unbounded; type Technology
               Mobile devices that are being targeted by the {@link LineItem}.
               Represents a technology entity that can be targeted.
               • id - optional; type long
                 The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
               • name - optional; type string
                 The name of the technology being targeting. This value is read-only and is assigned by Google.
             • excludedMobileDevices - optional, unbounded; type Technology
               Mobile devices that are being excluded by the {@link LineItem}.
               Represents a technology entity that can be targeted.
               • id - optional; type long
                 The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
               • name - optional; type string
                 The name of the technology being targeting. This value is read-only and is assigned by Google.
           • mobileDeviceSubmodelTargeting - optional; type MobileDeviceSubmodelTargeting
             The mobile device submodels being targeted by the {@link LineItem}.
             Represents mobile devices that are being targeted or excluded by the {@link LineItem}.
             • targetedMobileDeviceSubmodels - optional, unbounded; type Technology
               Mobile device submodels that are being targeted by the {@link LineItem}.
               Represents a technology entity that can be targeted.
               • id - optional; type long
                 The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
               • name - optional; type string
                 The name of the technology being targeting. This value is read-only and is assigned by Google.
             • excludedMobileDeviceSubmodels - optional, unbounded; type Technology
               Mobile device submodels that are being excluded by the {@link LineItem}.
               Represents a technology entity that can be targeted.
               • id - optional; type long
                 The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
               • name - optional; type string
                 The name of the technology being targeting. This value is read-only and is assigned by Google.
           • operatingSystemTargeting - optional; type OperatingSystemTargeting
             The operating systems being targeted by the {@link LineItem}.
             Represents operating systems that are being targeted or excluded by the {@link LineItem}.
             • isTargeted - optional; type boolean
               Indicates whether operating systems should be targeted or excluded. This attribute is optional and defaults to {@code true}.
             • operatingSystems - optional, unbounded; type Technology
               Operating systems that are being targeted or excluded by the {@link LineItem}.
               Represents a technology entity that can be targeted.
               • id - optional; type long
                 The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
               • name - optional; type string
                 The name of the technology being targeting. This value is read-only and is assigned by Google.
           • operatingSystemVersionTargeting - optional; type OperatingSystemVersionTargeting
             The operating system versions being targeted by the {@link LineItem}.
             Represents operating system versions that are being targeted or excluded by the {@link LineItem}.
             • targetedOperatingSystemVersions - optional, unbounded; type Technology
               Operating system versions that are being targeted by the {@link LineItem}.
               Represents a technology entity that can be targeted.
               • id - optional; type long
                 The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
               • name - optional; type string
                 The name of the technology being targeting. This value is read-only and is assigned by Google.
             • excludedOperatingSystemVersions - optional, unbounded; type Technology
               Operating system versions that are being excluded by the {@link LineItem}.
               Represents a technology entity that can be targeted.
               • id - optional; type long
                 The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
               • name - optional; type string
                 The name of the technology being targeting. This value is read-only and is assigned by Google.
           Specifies the browsing technologies that are targeted by the {@link LineItem}. This attribute is optional.
         • customTargeting - optional; type CustomCriteriaSet - extension of abstract type CustomCriteriaNode
           A {@link CustomCriteriaSet} comprises of a set of {@link CustomCriteriaNode} objects combined by the {@link CustomCriteriaSet.LogicalOperator#logicalOperator}. The custom criteria targeting tree is subject to the rules defined on {@link Targeting#customTargeting}.
           A {@link CustomCriteriaNode} is a node in the custom targeting tree. A custom criteria node can either be a {@link CustomCriteriaSet} (a non-leaf node) or a {@link CustomCriteria} (a leaf node). The custom criteria targeting tree is subject to the rules defined on {@link Targeting#customTargeting}.
           • logicalOperator - optional; type CustomCriteriaSet.LogicalOperator - type string with restriction - enum { 'AND', 'OR' }
             The logical operator to be applied to {@link CustomCriteriaSet#children}. This attribute is required. This attribute is required.
           • children - optional, unbounded; type CustomCriteriaNode
             The custom criteria. This attribute is required.
             A {@link CustomCriteriaNode} is a node in the custom targeting tree. A custom criteria node can either be a {@link CustomCriteriaSet} (a non-leaf node) or a {@link CustomCriteria} (a leaf node). The custom criteria targeting tree is subject to the rules defined on {@link Targeting#customTargeting}.
             Specifies the collection of custom criteria that is targeted by the {@link LineItem}.

             Once the {@link LineItem} is updated or modified with custom targeting, the server may return a normalized, but equivalent representation of the custom targeting expression.

             {@code customTargeting} will have up to three levels of expressions including itself.

             The top level {@code CustomCriteriaSet} i.e. the {@code customTargeting} object can only contain a {@link CustomCriteriaSet.LogicalOperator#OR} of all its children.

             The second level of {@code CustomCriteriaSet} objects can only contain {@link CustomCriteriaSet.LogicalOperator#AND} of all their children. If a {@link CustomCriteria} is placed on this level, the server will wrap it in a {@link CustomCriteriaSet}.

             The third level can only comprise of {@link CustomCriteria} objects.

             The resulting custom targeting tree would be of the form:
             

           • userDomainTargeting - optional; type UserDomainTargeting
             Specifies the domains or subdomains that are targeted or excluded by the {@link LineItem}. Users visiting from an IP address associated with those domains will be targeted or excluded. This attribute is optional.
             Provides line items the ability to target or exclude users visiting their websites from a list of domains or subdomains.
             • domains - optional, unbounded; type string
               The domains or subdomains that are being targeted or excluded by the {@link LineItem}. This attribute is required and the maximum length of each domain is 67 characters.
             • targeted - optional; type boolean
               Indicates whether domains should be targeted or excluded. This attribute is optional and defaults to {@code true}.
           • contentTargeting - optional; type ContentTargeting
             Used to target {@link LineItem}s to specific videos on a publisher's site.
             • targetedContentIds - optional, unbounded; type long
               The IDs of content being targeted by the {@code LineItem}.
             • excludedContentIds - optional, unbounded; type long
               The IDs of content being excluded by the {@code LineItem}.
             • targetedVideoContentBundleIds - optional, unbounded; type long
               A list of video content bundles, represented by {@link ContentBundle} IDs, that are being targeted by the {@code LineItem}.
             • excludedVideoContentBundleIds - optional, unbounded; type long
               A list of video content bundles, represented by {@link ContentBundle} IDs, that are being excluded by the {@code LineItem}.
             Specifies the video categories and individual videos targeted by the {@link LineItem}.
           • videoPositionTargeting - optional; type VideoPositionTargeting
             Specifies targeting against video position types.
             Represents positions within and around a video where ads can be targeted to.

             Example positions could be {@code pre-roll} (before the video plays), {@code post-roll} (after a video has completed playback) and {@code mid-roll} (during video playback).

             Empty video position targeting means that all video positions are allowed. If a bumper line item has empty video position targeting it will be updated to target all bumper positions.

             • targetedPositions - optional, unbounded; type VideoPositionTarget
               The {@link VideoTargetingPosition} objects being targeted by the video {@link LineItem}.
               Represents the options for targetable positions within a video.
               • videoPosition - optional; type VideoPosition
                 Represents a targetable position within a video. A video ad can be targeted to a position (pre-roll, all mid-rolls, or post-roll), or to a specific mid-roll index.
                 • positionType - optional; type VideoPosition.Type - type string with restriction - enum { 'UNKNOWN', 'ALL', 'PREROLL', 'MIDROLL', 'POSTROLL' }
                   The type of video position (pre-roll, mid-roll, or post-roll).
                 • midrollIndex - optional; type int
                   The index of the mid-roll to target. Only valid if the {@link positionType} is {@link VideoPositionType#MIDROLL}, otherwise this field will be ignored.
                 The video position to target. This attribute is required.
               • videoBumperType - optional; type VideoBumperType - type string with restriction - enum { 'BEFORE', 'AFTER' }
                 The video bumper type to target. To target a video position or a pod position, this value must be null. To target a bumper position this value must be populated and the line item must have a bumper type. To target a custom ad spot, this value must be null.
               • videoPositionWithinPod - optional; type VideoPositionWithinPod
                 Represents a targetable position within a pod within a video stream. A video ad can be targeted to any position in the pod (first, second, third ... last). If there is only 1 ad in a pod, either first or last will target that position.
                 • index - optional; type int
                   The specific index of the pod. The index is defined as:

                   • 1 = first
                   • 2 = second
                   • 3 = third
                   • ....
                   • 100 = last

                   100 will always be the last position. For example, for a pod with 5 positions, 100 would target position 5. Multiple targets against the index 100 can exist.
                   Positions over 100 are not supported.
                 The video position within a pod to target. To target a video position or a bumper position, this value must be null. To target a position within a pod this value must be populated. To target a custom ad spot, this value must be null.
               • adSpotId - optional; type long
                 A custom spot {@link AdSpot} to target. To target a video position, a bumper type or a video position within a pod this value must be null.
           • mobileApplicationTargeting - optional; type MobileApplicationTargeting
             Provides the ability to target or exclude users' mobile applications.
             • mobileApplicationIds - optional, unbounded; type long
               The {@link MobileApplication#id IDs} that are being targeted or excluded.
             • isTargeted - optional; type boolean
               Indicates whether mobile apps should be targeted or excluded. This attribute is optional and defaults to {@code true}.
             Specifies targeting against mobile applications.
           • buyerUserListTargeting - optional; type BuyerUserListTargeting
             The {@code BuyerUserListTargeting} associated with a programmatic {@link LineItem} or {@link ProposalLineItem} object.
             • hasBuyerUserListTargeting - optional; type boolean
               Whether the programmatic {@code LineItem} or {@code ProposalLineItem} object has buyer user list targeting.
             Specifies whether buyer user lists are targeted on a programmatic {@link LineItem} or {@link ProposalLineItem}. This attribute is readonly and is populated by Google.
           • inventoryUrlTargeting - optional; type InventoryUrlTargeting
             A collection of targeted inventory urls.
             • targetedUrls - optional, unbounded; type InventoryUrl
               The representation of an inventory Url that is used in targeting.
               • id - optional; type long
             • excludedUrls - optional, unbounded; type InventoryUrl
               The representation of an inventory Url that is used in targeting.
               • id - optional; type long
             Specifies the URLs that are targeted by the entity. This is currently only supported by {@link YieldGroup}.
           • verticalTargeting - optional; type VerticalTargeting
             Specifies the verticals that are targeted by the entity. The IDs listed here correspond to the IDs in the AD_CATEGORY table of type VERTICAL.
             Vertical targeting information.
             • targetedVerticalIds - optional, unbounded; type long
             • excludedVerticalIds - optional, unbounded; type long
           • contentLabelTargeting - optional; type ContentLabelTargeting
             Content label targeting information.
             • excludedContentLabelIds - optional, unbounded; type long
             Specifies the content labels that are excluded by the entity. The IDs listed here correspond to the IDs in the CONTENT_LABEL table.
           • requestPlatformTargeting - optional; type RequestPlatformTargeting
             Provides line items the ability to target the platform that requests and renders the ad.

             The following rules apply for {@link RequestPlatformTargeting}

             • {@link RequestPlatformTargeting} must be specified for {@link ProposalLineItem}s.
             • {@link RequestPlatformTargeting} must be specified for video line items. Empty values for {@link RequestPlatformTargeting#targetedRequestPlatforms} mean that all request platforms will be targeted.
             • {@link RequestPlatformTargeting} is read-only and assigned by Google for non-video line items.
             • {@link RequestPlatformTargeting} is read-only and assigned by Google for line items generated from proposal line items.
             • targetedRequestPlatforms - optional, unbounded; type RequestPlatform - type string with restriction - enum { 'UNKNOWN', 'BROWSER', 'MOBILE_APP', 'VIDEO_PLAYER' }
             Specifies the request platforms that are targeted by the {@link LineItem}. This attribute is required for video line items and for {@link ProposalLineItem}.

             This value is modifiable for video line items, but read-only for non-video line items.

             This value is read-only for video line items generated from proposal line items.

           • inventorySizeTargeting - optional; type InventorySizeTargeting
             Represents a collection of targeted and excluded inventory sizes. This is currently only available on {@link YieldGroup} and {@link TrafficDataRequest}.
             • isTargeted - optional; type boolean
               Whether the inventory sizes should be targeted or excluded.
             • targetedSizes - optional, unbounded; type TargetedSize
               A list of {@link TargetedSizeDto}s.
               A size that is targeted on a request.
               • size - optional; type Size
                 Represents the dimensions of an {@link AdUnit}, {@link LineItem} or {@link Creative}.

                 For interstitial size (out-of-page), native, ignored and fluid size, {@link Size} must be 1x1.

                 • width - optional; type int
                   The width of the {@link AdUnit}, {@link LineItem} or {@link Creative}.
                 • height - optional; type int
                   The height of the {@link AdUnit}, {@link LineItem} or {@link Creative}.
                 • isAspectRatio - optional; type boolean
                   Whether this size represents an aspect ratio.
             Specifies the sizes that are targeted by the entity. This is currently only supported on {@link YieldGroup} and {@link TrafficDataRequest}.
           • customFieldValues - optional, unbounded; type BaseCustomFieldValue
             The value of a {@link CustomField} for a particular entity.
             • customFieldId - optional; type long
               Id of the {@code CustomField} to which this value belongs. This attribute is required.
             The values of the custom fields associated with the {@code ProposalLineItem}. This attribute is optional. This attribute can be configured as editable after the proposal has been submitted. Please check with your network administrator for editable fields configuration.
           • appliedLabels - optional, unbounded; type AppliedLabel
             Represents a {@link Label} that can be applied to an entity. To negate an inherited label, create an {@code AppliedLabel} with {@code labelId} as the inherited label's ID and {@code isNegated} set to true.
             • labelId - optional; type long
               The ID of a created {@link Label}.
             • isNegated - optional; type boolean
               {@code isNegated} should be set to {@code true} to negate the effects of {@code labelId}.
             The set of labels applied directly to the {@code ProposalLineItem}. This attribute is optional.
           • effectiveAppliedLabels - optional, unbounded; type AppliedLabel
             Represents a {@link Label} that can be applied to an entity. To negate an inherited label, create an {@code AppliedLabel} with {@code labelId} as the inherited label's ID and {@code isNegated} set to true.
             • labelId - optional; type long
               The ID of a created {@link Label}.
             • isNegated - optional; type boolean
               {@code isNegated} should be set to {@code true} to negate the effects of {@code labelId}.
             Contains the set of labels applied directly to the proposal as well as those inherited ones. If a label has been negated, only the negated label is returned. This attribute is read-only.
           • disableSameAdvertiserCompetitiveExclusion - optional; type 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 {@code true} will allow line items from the same advertiser to serve regardless of the other competitive exclusion labels being applied.

             This attribute is optional and defaults to false.

           • isSold - optional; type boolean
             Indicates whether this {@code ProposalLineItem} has been sold. This attribute is read-only.
           • netRate - optional; type Money
             Represents a money amount.
             • currencyCode - optional; type string
               Three letter currency code in string format.
             • microAmount - optional; type long
               Money values are always specified in terms of micros which are a millionth of the fundamental currency unit. For US dollars, $1 is 1,000,000 micros.
             The amount of money to spend per impression or click in proposal currency. It supports precision of 4 decimal places in terms of the fundamental currency unit, so the {@link Money#getAmountInMicros} must be multiples of 100. It doesn't include agency commission.

             For example, if {@link Proposal#currencyCode} is 'USD', then $123.4567 could be represented as 123456700, but further precision is not supported.

             The field {@link ProposalLineItem#netRate} is required, and used to calculate {@link ProposalLineItem#netCost} if unspecified.

           • netCost - optional; type Money
             Represents a money amount.
             • currencyCode - optional; type string
               Three letter currency code in string format.
             • microAmount - optional; type long
               Money values are always specified in terms of micros which are a millionth of the fundamental currency unit. For US dollars, $1 is 1,000,000 micros.
             The cost of the {@code ProposalLineItem} in proposal currency. It supports precision of 2 decimal places in terms of the fundamental currency unit, so the {@link Money#getAmountInMicros} must be multiples of 10000. It doesn't include agency commission.

             For example, if {@link Proposal#currencyCode} is 'USD', then $123.45 could be represented as 123450000, but further precision is not supported.

             The field {@link ProposalLineItem#netRate} is required, and used to calculate {@link ProposalLineItem#netCost} if unspecified.

           • deliveryIndicator - optional; type DeliveryIndicator
             Indicates the delivery performance of the {@link LineItem}.
             • expectedDeliveryPercentage - optional; type double
               How much the {@code LineItem} was expected to deliver as a percentage of {@link LineItem#primaryGoal}.
             • actualDeliveryPercentage - optional; type double
               How much the line item actually delivered as a percentage of {@link LineItem#primaryGoal}.
             Indicates how well the line item generated from this proposal line item has been performing. This will be {@code null} if the delivery indicator information is not available due to one of the following reasons:

             1. The proposal line item has not pushed to Ad Manager.
             2. The line item is not delivering.
             3. The line item has an unlimited goal or cap.
             4. The line item has a percentage based goal or cap.

             This attribute is read-only.
           • deliveryData - optional; type DeliveryData
             Holds the number of clicks or impressions, determined by {@link LineItem#costType}, delivered for a single line item for the last 7 days
             • units - optional, unbounded; type long
               Clicks or impressions delivered for the last 7 days.
             Delivery data provides the number of clicks or impressions delivered for the {@link LineItem} generated from this proposal line item in the last 7 days. This will be {@code null} if the delivery data cannot be computed due to one of the following reasons:

             1. The proposal line item has not pushed to Ad Manager.
             2. The line item is not deliverable.
             3. The line item has completed delivering more than 7 days ago.
             4. The line item has an absolute-based goal. {@link ProposalLineItem#deliveryIndicator} should be used to track its progress in this case. This attribute is read-only.
           • computedStatus - optional; type ComputedStatus - type string with restriction - enum { 'DELIVERY_EXTENDED', 'DELIVERING', 'READY', 'PAUSED', 'INACTIVE', 'PAUSED_INVENTORY_RELEASED', 'PENDING_APPROVAL', 'COMPLETED', 'DISAPPROVED', 'DRAFT', 'CANCELED' }
             The status of the {@link LineItem} generated from this proposal line item. This will be {@code null} if the proposal line item has not pushed to Ad Manager. This attribute is read-only.
           • lastModifiedDateTime - optional; type DateTime
             Represents a date combined with the time of day.
             • date - optional; type Date
               Represents a date.
               • year - optional; type int
                 Year (e.g., 2009)
               • month - optional; type int
                 Month (1..12)
               • day - optional; type int
                 Day (1..31)
             • hour - optional; type int
             • minute - optional; type int
             • second - optional; type int
             • timeZoneId - optional; type string
             The date and time this {@code ProposalLineItem} was last modified.

             This attribute is assigned by Google when a {@code ProposalLineItem} is updated. This attribute is read-only.

           • reservationStatus - optional; type ReservationStatus - type string with restriction - enum { 'RESERVED', 'NOT_RESERVED', 'RELEASED', 'CHECK_LINE_ITEM_RESERVATION_STATUS', 'UNKNOWN' }
             The reservation status of the {@link ProposalLineItem}. This attribute is read-only.
           • lastReservationDateTime - optional; type DateTime
             Represents a date combined with the time of day.
             • date - optional; type Date
               Represents a date.
               • year - optional; type int
                 Year (e.g., 2009)
               • month - optional; type int
                 Month (1..12)
               • day - optional; type int
                 Day (1..31)
             • hour - optional; type int
             • minute - optional; type int
             • second - optional; type int
             • timeZoneId - optional; type string
             The last {@link DateTime} when the {@link ProposalLineItem} reserved inventory. This attribute is read-only.
           • environmentType - optional; type EnvironmentType - type string with restriction - enum { 'BROWSER', 'VIDEO_PLAYER' }
             The environment that the {@code ProposalLineItem} is targeting. The default value is {@link EnvironmentType#BROWSER}. If this value is {@link EnvironmentType#VIDEO_PLAYER}, then this {@code ProposalLineItem} can only target {@link AdUnit ad units} that have {@link AdUnitSize sizes} whose {@link AdUnitSize#environmentType} is also {@link EnvironmentType#VIDEO_PLAYER}.

             This field is read-only and set to {@link Product#environmentType} of the product this proposal line item was created from.

           • allowedFormats - optional, unbounded; type AllowedFormats - type string with restriction - enum { 'AUDIO', 'UNKNOWN' }
             The set of {@link AllowedFormats} that this proposal line item can have. If the set is empty, this proposal line item allows all formats.
           • additionalTerms - optional; type string
             Additional terms shown to the buyer in Marketplace.
           • programmaticCreativeSource - optional; type ProgrammaticCreativeSource - type string with restriction - enum { 'PUBLISHER', 'ADVERTISER', 'UNKNOWN' }
             Indicates the {@link ProgrammaticCreativeSource} of the programmatic line item.
           • grpSettings - optional; type GrpSettings
             {@code GrpSettings} contains information for a line item that will have a target demographic when serving. This information will be used to set up tracking and enable reporting on the demographic information.
             • minTargetAge - optional; type long
               Specifies the minimum target age (in years) of the {@link LineItem}. This field is only applicable if {@link #provider} is not null.
             • maxTargetAge - optional; type long
               Specifies the maximum target age (in years) of the {@link LineItem}. This field is only applicable if {@link #provider} is not null.
             • targetGender - optional; type GrpTargetGender - type string with restriction - enum { 'UNKNOWN', 'MALE', 'FEMALE', 'BOTH' }
               Specifies the target gender of the {@link LineItem}. This field is only applicable if {@link #provider} is not null.
             • provider - optional; type GrpProvider - type string with restriction - enum { 'UNKNOWN', 'NIELSEN' }
               Specifies the GRP provider of the {@link LineItem}.
             • inTargetRatioEstimateMilliPercent - optional; type long
               Estimate for the in-target ratio given the line item's audience targeting. This field is only applicable if {@link #provider} is Nielsen, {@link LineItem#primaryGoal#unitType} is in-target impressions, and {@link LineItem#CostType} is in-target CPM. This field determines the in-target ratio to use for pacing Nielsen line items before Nielsen reporting data is available. Represented as a milli percent, so 55.7% becomes 55700.
             • nielsenCtvPacingType - optional; type NielsenCtvPacingType - type string with restriction - enum { 'UNKNOWN', 'NONE', 'COVIEW', 'STRICT_COVIEW' }
               Specifies which pacing computation to apply in pacing to impressions from connected devices. This field is required if {@code enableNielsenCoViewingSupport} is true.
             • pacingDeviceCategorizationType - optional; type PacingDeviceCategorizationType - type string with restriction - enum { 'UNKNOWN', 'GOOGLE', 'NIELSEN' }
               Specifies whether to use Google or Nielsen device breakdown in Nielsen Line Item auto pacing.
             • applyTrueCoview - optional; type boolean
               Specifies whether to apply true coviewing in Nielsen Line Item auto pacing. This field can only be true if NielsenCtvPacingType is not NONE.
             Contains the information for a proposal line item which has a target GRP demographic.
           • estimatedMinimumImpressions - optional; type long
             The estimated minimum impressions that should be delivered for a proposal line item.
           • thirdPartyMeasurementSettings - optional; type ThirdPartyMeasurementSettings
             Contains third party measurement settings for cross-sell Partners
             Contains third party auto-pixeling settings for cross-sell Partners.
             • viewabilityPartner - optional; type ThirdPartyViewabilityIntegrationPartner - type string with restriction - enum { 'NONE', 'MOAT', 'DOUBLE_VERIFY', 'INTEGRAL_AD_SCIENCE', 'COMSCORE', 'TELEMETRY', 'UNKNOWN' }
               A field to determine the type of ThirdPartyViewabilityIntegrationPartner. This field default is NONE.
             • viewabilityClientId - optional; type string
               The third party partner id for YouTube viewability verification.
             • viewabilityReportingId - optional; type string
               The reporting id that maps viewability partner data with a campaign (or a group of related campaigns) specific data.
             • publisherViewabilityPartner - optional; type ThirdPartyViewabilityIntegrationPartner - type string with restriction - enum { 'NONE', 'MOAT', 'DOUBLE_VERIFY', 'INTEGRAL_AD_SCIENCE', 'COMSCORE', 'TELEMETRY', 'UNKNOWN' }
               A field to determine the type of publisher's viewability partner. This field default is NONE.
             • publisherViewabilityClientId - optional; type string
               The third party partner id for YouTube viewability verification for publisher.
             • publisherViewabilityReportingId - optional; type string
               The reporting id that maps viewability partner data with a campaign (or a group of related campaigns) specific data for publisher.
             • brandLiftPartner - optional; type ThirdPartyBrandLiftIntegrationPartner - type string with restriction - enum { 'UNKNOWN', 'NONE', 'KANTAR_MILLWARD_BROWN', 'DYNATA', 'INTAGE', 'MACROMILL' }
               A field to determine the type of ThirdPartyBrandLiftIntegrationPartner. This field default is NONE.
             • brandLiftClientId - optional; type string
               The third party partner id for YouTube brand lift verification.
             • brandLiftReportingId - optional; type string
               The reporting id that maps brand lift partner data with a campaign (or a group of related campaigns) specific data.
             • reachPartner - optional; type ThirdPartyReachIntegrationPartner - type string with restriction - enum { 'NONE', 'COMSCORE', 'NIELSEN', 'KANTAR_MILLWARD_BROWN', 'VIDEO_RESEARCH', 'GEMIUS', 'VIDEO_AMP', 'ISPOT_TV', 'AUDIENCE_PROJECT', 'UNKNOWN' }
               A field to determine the type of advertiser's ThirdPartyReachIntegrationPartner. This field default is UNKNOWN.
             • reachClientId - optional; type string
               The third party partner id for YouTube reach verification for advertiser.
             • reachReportingId - optional; type string
               The reporting id that maps reach partner data with a campaign (or a group of related campaigns) specific data for advertiser.
             • publisherReachPartner - optional; type ThirdPartyReachIntegrationPartner - type string with restriction - enum { 'NONE', 'COMSCORE', 'NIELSEN', 'KANTAR_MILLWARD_BROWN', 'VIDEO_RESEARCH', 'GEMIUS', 'VIDEO_AMP', 'ISPOT_TV', 'AUDIENCE_PROJECT', 'UNKNOWN' }
               A field to determine the type of publisher's ThirdPartyReachIntegrationPartner. This field default is UNKNOWN.
             • publisherReachClientId - optional; type string
               The third party partner id for YouTube reach verification for publisher.
             • publisherReachReportingId - optional; type string
               The reporting id that maps reach partner data with a campaign (or a group of related campaigns) specific data for publisher.
           • makegoodInfo - optional; type ProposalLineItemMakegoodInfo
             Makegood info for this proposal line item. Immutable once created.

             Null if this proposal line item is not a makegood.

             Makegood info for a {@link ProposalLineItemDto}.
             • originalProposalLineItemId - optional; type long
               The ID of the original proposal line item on which this makegood is based. This attribute is read-only.
             • reason - optional; type string
               The publisher-provided reason why this makegood was initiated. This is free form text.

               The following predefined values can be used to render predefined options in the UI.

               UNDERDELIVERY: 'Impression underdelivery', SECONDARY_DELIVERY_TERMS: 'Did not meet secondary delivery terms ', PERFORMANCE: 'Performance issues',

           • hasMakegood - optional; type boolean
             Whether this proposal line item has an associated makegood. This attribute is read-only.
           • canCreateMakegood - optional; type boolean
             Whether a new makegood associated with this line item can be created. This attribute is read-only.
           • pauseRole - optional; type NegotiationRole - type string with restriction - enum { 'BUYER', 'SELLER', 'UNKNOWN' }
             The {@link NegotiationRole} that paused the proposal line item, i.e. {@link NegotiationRole#seller} or {@link NegotiationRole#buyer}, or {@code null} when the proposal is not paused. This attribute is read-only.
           • pauseReason - optional; type string
             The reason for pausing the {@link ProposalLineItem}, provided by the {@link pauseRole}. It is {@code null} when the {@link ProposalLineItem} is not paused. This attribute is read-only.
           The collection of proposal line items contained within this page.
         • startIndex - optional; type int
           The absolute index in the total result set on which this page begins.
         • totalResultSetSize - optional; type int
           The size of the total result set to which this page belongs.
   Fault:
   ApiException (wsdlsoap:fault, use = literal)Source code
   ApiException type ApiExceptionFault

   Exception class for holding a list of service errors.

   Base class for exceptions.

   • message - optional; type string
     Error message.

   • errors - optional, unbounded; type ApiError
     The API error base class that provides details about an error that occurred while processing a service request.

     The OGNL field path is provided for parsers to identify the request data element that may have caused the error.

     • fieldPath - optional; type string
       The OGNL field path to identify cause of error.
     • fieldPathElements - optional, unbounded; type FieldPathElement
       A parsed copy of the field path. For example, the field path "operations[1].operand" corresponds to this list: {FieldPathElement(field = "operations", index = 1), FieldPathElement(field = "operand", index = null)}.
       A segment of a field path. Each dot in a field path defines a new segment.
       • field - optional; type string
         The name of a field in lower camelcase. (e.g. "biddingStrategy")
       • index - optional; type int
         For list fields, this is a 0-indexed position in the list. Null for non-list fields.
     • trigger - optional; type string
       The data that caused the error.
     • errorString - optional; type string
       A simple string representation of the error and reason.
     List of errors.

   A fault element of type ApiException.
4. performProposalLineItemAction
   Source code
   Description:
   Performs actions on {@link ProposalLineItem} objects that match the given {@link Statement#query}.
   Operation type:
   Request-response. The endpoint receives a message, and sends a correlated message.
   Input:
   performProposalLineItemActionRequest (wsdlsoap:header, use = literal, part = RequestHeader)Source code
   parameters type performProposalLineItemAction

   Performs actions on {@link ProposalLineItem} objects that match the given {@link Statement#query}.

   • proposalLineItemAction - optional; type ProposalLineItemAction
     Represents the actions that can be performed on {@link ProposalLineItem} objects.
     • filterStatement - optional; type Statement
       Captures the {@code WHERE}, {@code ORDER BY} and {@code LIMIT} clauses of a PQL query. Statements are typically used to retrieve objects of a predefined domain type, which makes SELECT clause unnecessary.

       An example query text might be {@code "WHERE status = 'ACTIVE' ORDER BY id LIMIT 30"}.

       Statements support bind variables. These are substitutes for literals and can be thought of as input parameters to a PQL query.

       An example of such a query might be {@code "WHERE id = :idValue"}.

       Statements also support use of the LIKE keyword. This provides wildcard string matching.

       An example of such a query might be {@code "WHERE name LIKE '%searchString%'"}.

       The value for the variable idValue must then be set with an object of type {@link Value}, e.g., {@link NumberValue}, {@link TextValue} or {@link BooleanValue}.
       • query - optional; type string
         Holds the query in PQL syntax. The syntax is:
         [WHERE {[AND | OR] ...}]
[ORDER BY [ASC | DESC]]
[LIMIT {[,] } | { OFFSET }]
         

         
              := {< | <= | > | >= | = | != }

     := {< | <= | > | >= | = | != }
:= IN
:= IS NULL
:= LIKE
:= :
         

       • values - optional, unbounded; type String_ValueMapEntry
         Holds keys and values for bind variables and their values. The key is the name of the bind variable. The value is the literal value of the variable.

         In the example {@code "WHERE status = :bindStatus ORDER BY id LIMIT 30"}, the bind variable, represented by {@code :bindStatus} is named {@code bindStatus}, which would also be the parameter map key. The bind variable's value would be represented by a parameter map value of type {@link TextValue}. The final result, for example, would be an entry of {@code "bindStatus" => StringParam("ACTIVE")}.

         This represents an entry in a map with a key of type String and value of type Value.
         • key - optional; type string
         • value - optional; type Value
           {@code Value} represents a value.
   Output:
   performProposalLineItemActionResponse (wsdlsoap:header, use = literal, part = ResponseHeader)Source code
   parameters type performProposalLineItemActionResponse

   • rval - optional; type UpdateResult
     Represents the result of performing an action on objects.
     • numChanges - optional; type int
       The number of objects that were changed as a result of performing the action.
   Fault:
   ApiException (wsdlsoap:fault, use = literal)Source code
   ApiException type ApiExceptionFault

   Exception class for holding a list of service errors.

   Base class for exceptions.

   • message - optional; type string
     Error message.

   • errors - optional, unbounded; type ApiError
     The API error base class that provides details about an error that occurred while processing a service request.

     The OGNL field path is provided for parsers to identify the request data element that may have caused the error.

     • fieldPath - optional; type string
       The OGNL field path to identify cause of error.
     • fieldPathElements - optional, unbounded; type FieldPathElement
       A parsed copy of the field path. For example, the field path "operations[1].operand" corresponds to this list: {FieldPathElement(field = "operations", index = 1), FieldPathElement(field = "operand", index = null)}.
       A segment of a field path. Each dot in a field path defines a new segment.
       • field - optional; type string
         The name of a field in lower camelcase. (e.g. "biddingStrategy")
       • index - optional; type int
         For list fields, this is a 0-indexed position in the list. Null for non-list fields.
     • trigger - optional; type string
       The data that caused the error.
     • errorString - optional; type string
       A simple string representation of the error and reason.
     List of errors.

   A fault element of type ApiException.
5. updateProposalLineItems
   Source code
   Description:
   Updates the specified {@link ProposalLineItem} objects.
   Operation type:
   Request-response. The endpoint receives a message, and sends a correlated message.
   Input:
   updateProposalLineItemsRequest (wsdlsoap:header, use = literal, part = RequestHeader)Source code
   parameters type updateProposalLineItems

   Updates the specified {@link ProposalLineItem} objects.

   • proposalLineItems - optional, unbounded; type ProposalLineItem
     A {@code ProposalLineItem} is added to a programmatic {@link Proposal} and is similar to a delivery {@link LineItem}. It contains delivery details including information like impression goal or quantity, start and end times, and targeting.
     • id - optional; type long
       The unique ID of the {@code ProposalLineItem}. This attribute is read-only.
     • proposalId - optional; type long
       The unique ID of the {@link Proposal}, to which the {@code ProposalLineItem} belongs. This attribute is required for creation and then is readonly. This attribute is required.
     • name - optional; type string
       The name of the {@code ProposalLineItem} which should be unique under the same {@link Proposal}. This attribute has a maximum length of 255 characters. This attribute can be configured as editable after the proposal has been submitted. Please check with your network administrator for editable fields configuration. This attribute is required.
     • startDateTime - optional; type DateTime
       Represents a date combined with the time of day.
       • date - optional; type Date
         Represents a date.
         • year - optional; type int
           Year (e.g., 2009)
         • month - optional; type int
           Month (1..12)
         • day - optional; type int
           Day (1..31)
       • hour - optional; type int
       • minute - optional; type int
       • second - optional; type int
       • timeZoneId - optional; type string
       The date and time at which the line item associated with the {@code ProposalLineItem} is enabled to begin serving. This attribute is optional during creation, but required and must be in the future when it turns into a line item. The {@link DateTime#timeZoneID} is required if start date time is not {@code null}. This attribute becomes readonly once the {@code ProposalLineItem} has started delivering.
     • endDateTime - optional; type DateTime
       Represents a date combined with the time of day.
       • date - optional; type Date
         Represents a date.
         • year - optional; type int
           Year (e.g., 2009)
         • month - optional; type int
           Month (1..12)
         • day - optional; type int
           Day (1..31)
       • hour - optional; type int
       • minute - optional; type int
       • second - optional; type int
       • timeZoneId - optional; type string
       The date and time at which the line item associated with the {@code ProposalLineItem} stops beening served. This attribute is optional during creation, but required and must be after the {@link #startDateTime}. The {@link DateTime#timeZoneID} is required if end date time is not {@code null}.
     • internalNotes - optional; type string
       Provides any additional notes that may annotate the {@code ProposalLineItem}. This attribute is optional and has a maximum length of 65,535 characters. This attribute can be configured as editable after the proposal has been submitted. Please check with your network administrator for editable fields configuration.
     • isArchived - optional; type boolean
       The archival status of the {@code ProposalLineItem}. This attribute is read-only.
     • goal - optional; type Goal
       Defines the criteria a {@link LineItem} needs to satisfy to meet its delivery goal.
       • goalType - optional; type GoalType - type string with restriction - enum { 'NONE', 'LIFETIME', 'DAILY', 'UNKNOWN' }
         The type of the goal for the {@code LineItem}. It defines the period over which the goal for {@code LineItem} should be reached.
       • unitType - optional; type UnitType - type string with restriction - enum { 'IMPRESSIONS', 'CLICKS', 'CLICK_THROUGH_CPA_CONVERSIONS', 'VIEW_THROUGH_CPA_CONVERSIONS', 'TOTAL_CPA_CONVERSIONS', 'VIEWABLE_IMPRESSIONS', 'IN_TARGET_IMPRESSIONS', 'UNKNOWN' }
         The type of the goal unit for the {@code LineItem}.
       • units - optional; type long
         If this is a primary goal, it represents the number or percentage of impressions or clicks that will be reserved for the {@code LineItem}. If the line item is of type {@link LineItemType#SPONSORSHIP}, it represents the percentage of available impressions reserved. If the line item is of type {@link LineItemType#BULK} or {@link LineItemType#PRICE_PRIORITY}, it represents the number of remaining impressions reserved. If the line item is of type {@link LineItemType#NETWORK} or {@link LineItemType#HOUSE}, it represents the percentage of remaining impressions reserved.

         If this is a secondary goal, it represents the number of impressions or conversions that the line item will stop serving at if reached. For valid line item types, see {@link LineItem#secondaryGoals}.

       The goal(i.e. contracted quantity, quantity or limit) that this {@code ProposalLineItem} is associated with, which is used in its pacing and budgeting. {@link Goal#units} must be greater than 0 when the proposal line item turns into a line item, {@link Goal#goalType} and {@link Goal#unitType} are readonly. For a Preferred deal {@code ProposalLineItem}, the goal type can only be {@link GoalType#NONE}. This attribute is required.
     • secondaryGoals - optional, unbounded; type Goal
       Defines the criteria a {@link LineItem} needs to satisfy to meet its delivery goal.
       • goalType - optional; type GoalType - type string with restriction - enum { 'NONE', 'LIFETIME', 'DAILY', 'UNKNOWN' }
         The type of the goal for the {@code LineItem}. It defines the period over which the goal for {@code LineItem} should be reached.
       • unitType - optional; type UnitType - type string with restriction - enum { 'IMPRESSIONS', 'CLICKS', 'CLICK_THROUGH_CPA_CONVERSIONS', 'VIEW_THROUGH_CPA_CONVERSIONS', 'TOTAL_CPA_CONVERSIONS', 'VIEWABLE_IMPRESSIONS', 'IN_TARGET_IMPRESSIONS', 'UNKNOWN' }
         The type of the goal unit for the {@code LineItem}.
       • units - optional; type long
         If this is a primary goal, it represents the number or percentage of impressions or clicks that will be reserved for the {@code LineItem}. If the line item is of type {@link LineItemType#SPONSORSHIP}, it represents the percentage of available impressions reserved. If the line item is of type {@link LineItemType#BULK} or {@link LineItemType#PRICE_PRIORITY}, it represents the number of remaining impressions reserved. If the line item is of type {@link LineItemType#NETWORK} or {@link LineItemType#HOUSE}, it represents the percentage of remaining impressions reserved.

         If this is a secondary goal, it represents the number of impressions or conversions that the line item will stop serving at if reached. For valid line item types, see {@link LineItem#secondaryGoals}.

       The secondary goals that this {@code ProposalLineItem} is associated with. For a programmatic line item with the properties {@link RateType#CPM} and {@link LineItemType#SPONSORSHIP}, this field will have one goal which describes the impressions cap. For other cases, this field is an empty list.
     • contractedUnitsBought - optional; type long
       The contracted number of daily minimum impressions used for {@link LineItemType#SPONSORSHIP} {@code ProposalLineItem} deals with a rate type of {@link RateType#CPD}.

       This attribute is required for percentage-based-goal {@link ProposalLineItem proposal line items}. It does not impact ad-serving and is for reporting purposes only.

     • deliveryRateType - optional; type DeliveryRateType - type string with restriction - enum { 'EVENLY', 'FRONTLOADED', 'AS_FAST_AS_POSSIBLE' }
       The strategy for delivering ads over the course of the {@code ProposalLineItem}'s duration. This attribute is required. For a Preferred deal {@code ProposalLineItem}, the value can only be {@link DeliveryRateType#FRONTLOADED}.
     • roadblockingType - optional; type RoadblockingType - type string with restriction - enum { 'ONLY_ONE', 'ONE_OR_MORE', 'AS_MANY_AS_POSSIBLE', 'ALL_ROADBLOCK', 'CREATIVE_SET' }
       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 during creation and defaults to the {@link Product#roadblockingType product's roadblocking type}, or {@link RoadblockingType#ONE_OR_MORE} if not specified by the product.
     • companionDeliveryOption - optional; type CompanionDeliveryOption - type string with restriction - enum { 'OPTIONAL', 'AT_LEAST_ONE', 'ALL', 'UNKNOWN' }
       The delivery option for companions. This is only valid if the roadblocking type is {@link RoadblockingType#CREATIVE_SET}. The default value for roadblocking creatives is {@link CompanionDeliveryOption#OPTIONAL}. The default value in other cases is {@link CompanionDeliveryOption#UNKNOWN}. Providing something other than {@link CompanionDeliveryOption#UNKNOWN} will cause an error.
     • videoMaxDuration - optional; type long
       The max duration of a video creative associated with this {@code ProposalLineItem} in milliseconds. This attribute is optional, defaults to the {@link Product#videoMaxDuration} on the {@link Product} it was created with, and only meaningful if this is a video proposal line item.
     • videoCreativeSkippableAdType - optional; type SkippableAdType - type string with restriction - enum { 'UNKNOWN', 'DISABLED', 'ENABLED', 'INSTREAM_SELECT', 'ANY' }
       The proposal line item's creatives' skippability. This attribute is optional, only applicable for video proposal line items, and defaults to {@link SkippableAdType#NOT_SKIPPABLE}.
     • frequencyCaps - optional, unbounded; type FrequencyCap
       Represents a limit on the number of times a single viewer can be exposed to the same {@link LineItem} in a specified time period.
       • maxImpressions - optional; type int
         The maximum number of impressions than can be served to a user within a specified time period.
       • numTimeUnits - optional; type int
         The number of {@code FrequencyCap#timeUnit} to represent the total time period.
       • timeUnit - optional; type TimeUnit - type string with restriction - enum { 'MINUTE', 'HOUR', 'DAY', 'WEEK', 'MONTH', 'LIFETIME', 'POD', 'STREAM', 'UNKNOWN' }
         The unit of time for specifying the time period.
       The set of frequency capping units for this {@code ProposalLineItem}. This attribute is optional during creation and defaults to the {@link Product#frequencyCaps product's frequency caps} if {@link Product#allowFrequencyCapsCustomization} is {@code false}.
     • dfpLineItemId - optional; type long
       The unique ID of corresponding {@link LineItem}. This will be {@code null} if the {@link Proposal} has not been pushed to Ad Manager. This attribute is read-only.
     • lineItemType - optional; type LineItemType - type string with restriction - enum { 'SPONSORSHIP', 'STANDARD', 'NETWORK', 'BULK', 'PRICE_PRIORITY', 'HOUSE', 'LEGACY_DFP', 'CLICK_TRACKING', 'ADSENSE', 'AD_EXCHANGE', 'BUMPER', 'ADMOB', 'PREFERRED_DEAL', 'UNKNOWN' }
       The corresponding {@link LineItemType} of the {@code ProposalLineItem}. For a programmatic {@code ProposalLineItem}, the value can only be one of:

       • {@link LineItemType#SPONSORSHIP}
       • {@link LineItemType#STANDARD}
       • {@link LineItemType#PREFERRED_DEAL}

       This attribute is required.
     • lineItemPriority - optional; type int
       The priority for the corresponding {@link LineItem} of the {@code ProposalLineItem}. This attribute is optional during creation and defaults to the default priority of the {@link #lineItemType}. For forecasting, this attribute is optional and has a default value assigned by Google. See {@link LineItem#priority} for more information.
     • rateType - optional; type RateType - type string with restriction - enum { 'CPM', 'CPD', 'VCPM', 'CPM_IN_TARGET', 'UNKNOWN' }
       The method used for billing the {@code ProposalLineItem}. This attribute is read-only. This attribute is required.
     • creativePlaceholders - optional, unbounded; type CreativePlaceholder
       A {@code CreativePlaceholder} describes a slot that a creative is expected to fill. This is used primarily to help in forecasting, and also to validate that the correct creatives are associated with the line item. A {@code CreativePlaceholder} must contain a size, and it can optionally contain companions. Companions are only valid if the line item's environment type is {@link EnvironmentType#VIDEO_PLAYER}.
       • size - optional; type Size
         The dimensions that the creative is expected to have. This attribute is required.
         Represents the dimensions of an {@link AdUnit}, {@link LineItem} or {@link Creative}.

         For interstitial size (out-of-page), native, ignored and fluid size, {@link Size} must be 1x1.

         • width - optional; type int
           The width of the {@link AdUnit}, {@link LineItem} or {@link Creative}.
         • height - optional; type int
           The height of the {@link AdUnit}, {@link LineItem} or {@link Creative}.
         • isAspectRatio - optional; type boolean
           Whether this size represents an aspect ratio.
       • creativeTemplateId - optional; type long
         The native creative template ID.

         This value is only required if {@link #creativeSizeType} is {@link CreativeSizeType#NATIVE}.

       • companions - optional, unbounded; type CreativePlaceholder
         A {@code CreativePlaceholder} describes a slot that a creative is expected to fill. This is used primarily to help in forecasting, and also to validate that the correct creatives are associated with the line item. A {@code CreativePlaceholder} must contain a size, and it can optionally contain companions. Companions are only valid if the line item's environment type is {@link EnvironmentType#VIDEO_PLAYER}.
         • size - optional; type Size
           The dimensions that the creative is expected to have. This attribute is required.
           Represents the dimensions of an {@link AdUnit}, {@link LineItem} or {@link Creative}.

           For interstitial size (out-of-page), native, ignored and fluid size, {@link Size} must be 1x1.

           • width - optional; type int
             The width of the {@link AdUnit}, {@link LineItem} or {@link Creative}.
           • height - optional; type int
             The height of the {@link AdUnit}, {@link LineItem} or {@link Creative}.
           • isAspectRatio - optional; type boolean
             Whether this size represents an aspect ratio.
         • creativeTemplateId - optional; type long
           The native creative template ID.

           This value is only required if {@link #creativeSizeType} is {@link CreativeSizeType#NATIVE}.

         • companions - optional, unbounded; type CreativePlaceholder
           A {@code CreativePlaceholder} describes a slot that a creative is expected to fill. This is used primarily to help in forecasting, and also to validate that the correct creatives are associated with the line item. A {@code CreativePlaceholder} must contain a size, and it can optionally contain companions. Companions are only valid if the line item's environment type is {@link EnvironmentType#VIDEO_PLAYER}.
           • size - optional; type Size
             The dimensions that the creative is expected to have. This attribute is required.
             Represents the dimensions of an {@link AdUnit}, {@link LineItem} or {@link Creative}.

             For interstitial size (out-of-page), native, ignored and fluid size, {@link Size} must be 1x1.

             • width - optional; type int
               The width of the {@link AdUnit}, {@link LineItem} or {@link Creative}.
             • height - optional; type int
               The height of the {@link AdUnit}, {@link LineItem} or {@link Creative}.
             • isAspectRatio - optional; type boolean
               Whether this size represents an aspect ratio.
           • creativeTemplateId - optional; type long
             The native creative template ID.

             This value is only required if {@link #creativeSizeType} is {@link CreativeSizeType#NATIVE}.

           • companions - optional, unbounded; type CreativePlaceholder... is recursive
             The companions that the creative is expected to have. This attribute can only be set if the line item it belongs to has a {@link LineItem#environmentType} of {@link EnvironmentType#VIDEO_PLAYER} or {@link LineItem#roadblockingType} of {@link RoadblockingType#CREATIVE_SET}.
           • appliedLabels - optional, unbounded; type AppliedLabel
             Represents a {@link Label} that can be applied to an entity. To negate an inherited label, create an {@code AppliedLabel} with {@code labelId} as the inherited label's ID and {@code isNegated} set to true.
             • labelId - optional; type long
               The ID of a created {@link Label}.
             • isNegated - optional; type boolean
               {@code isNegated} should be set to {@code true} to negate the effects of {@code labelId}.
             The set of label frequency caps applied directly to this creative placeholder.
           • effectiveAppliedLabels - optional, unbounded; type AppliedLabel
             Represents a {@link Label} that can be applied to an entity. To negate an inherited label, create an {@code AppliedLabel} with {@code labelId} as the inherited label's ID and {@code isNegated} set to true.
             • labelId - optional; type long
               The ID of a created {@link Label}.
             • isNegated - optional; type boolean
               {@code isNegated} should be set to {@code true} to negate the effects of {@code labelId}.
             Contains the set of labels applied directly to this creative placeholder as well as those inherited from the creative template from which this creative placeholder was instantiated. This field is readonly and is assigned by Google.
           • expectedCreativeCount - optional; type int
             Expected number of creatives that will be uploaded corresponding to this creative placeholder. This estimate is used to improve the accuracy of forecasting; for example, if label frequency capping limits the number of times a creative may be served.
           • creativeSizeType - optional; type CreativeSizeType - type string with restriction - enum { 'PIXEL', 'ASPECT_RATIO', 'INTERSTITIAL', 'IGNORED', 'NATIVE', 'AUDIO' }
             Describes the types of sizes a creative can be. By default, the creative's size is {@link CreativeSizeType#PIXEL}, which is a dimension based size (width-height pair).
           • targetingName - optional; type string
             The name of the {@link CreativeTargeting} for creatives this placeholder represents.

             This attribute is optional. Specifying creative targeting here is for forecasting purposes only and has no effect on serving. The same creative targeting should be specified on a {@link LineItemCreativeAssociation} when associating a {@link Creative} with the {@link LineItem}.

           • isAmpOnly - optional; type boolean
             Indicate if the expected creative of this placeholder has an AMP only variant.

             This attribute is optional. It is for forecasting purposes only and has no effect on serving.

           The companions that the creative is expected to have. This attribute can only be set if the line item it belongs to has a {@link LineItem#environmentType} of {@link EnvironmentType#VIDEO_PLAYER} or {@link LineItem#roadblockingType} of {@link RoadblockingType#CREATIVE_SET}.
         • appliedLabels - optional, unbounded; type AppliedLabel
           Represents a {@link Label} that can be applied to an entity. To negate an inherited label, create an {@code AppliedLabel} with {@code labelId} as the inherited label's ID and {@code isNegated} set to true.
           • labelId - optional; type long
             The ID of a created {@link Label}.
           • isNegated - optional; type boolean
             {@code isNegated} should be set to {@code true} to negate the effects of {@code labelId}.
           The set of label frequency caps applied directly to this creative placeholder.
         • effectiveAppliedLabels - optional, unbounded; type AppliedLabel
           Represents a {@link Label} that can be applied to an entity. To negate an inherited label, create an {@code AppliedLabel} with {@code labelId} as the inherited label's ID and {@code isNegated} set to true.
           • labelId - optional; type long
             The ID of a created {@link Label}.
           • isNegated - optional; type boolean
             {@code isNegated} should be set to {@code true} to negate the effects of {@code labelId}.
           Contains the set of labels applied directly to this creative placeholder as well as those inherited from the creative template from which this creative placeholder was instantiated. This field is readonly and is assigned by Google.
         • expectedCreativeCount - optional; type int
           Expected number of creatives that will be uploaded corresponding to this creative placeholder. This estimate is used to improve the accuracy of forecasting; for example, if label frequency capping limits the number of times a creative may be served.
         • creativeSizeType - optional; type CreativeSizeType - type string with restriction - enum { 'PIXEL', 'ASPECT_RATIO', 'INTERSTITIAL', 'IGNORED', 'NATIVE', 'AUDIO' }
           Describes the types of sizes a creative can be. By default, the creative's size is {@link CreativeSizeType#PIXEL}, which is a dimension based size (width-height pair).
         • targetingName - optional; type string
           The name of the {@link CreativeTargeting} for creatives this placeholder represents.

           This attribute is optional. Specifying creative targeting here is for forecasting purposes only and has no effect on serving. The same creative targeting should be specified on a {@link LineItemCreativeAssociation} when associating a {@link Creative} with the {@link LineItem}.

         • isAmpOnly - optional; type boolean
           Indicate if the expected creative of this placeholder has an AMP only variant.

           This attribute is optional. It is for forecasting purposes only and has no effect on serving.

         The companions that the creative is expected to have. This attribute can only be set if the line item it belongs to has a {@link LineItem#environmentType} of {@link EnvironmentType#VIDEO_PLAYER} or {@link LineItem#roadblockingType} of {@link RoadblockingType#CREATIVE_SET}.
       • appliedLabels - optional, unbounded; type AppliedLabel
         Represents a {@link Label} that can be applied to an entity. To negate an inherited label, create an {@code AppliedLabel} with {@code labelId} as the inherited label's ID and {@code isNegated} set to true.
         • labelId - optional; type long
           The ID of a created {@link Label}.
         • isNegated - optional; type boolean
           {@code isNegated} should be set to {@code true} to negate the effects of {@code labelId}.
         The set of label frequency caps applied directly to this creative placeholder.
       • effectiveAppliedLabels - optional, unbounded; type AppliedLabel
         Represents a {@link Label} that can be applied to an entity. To negate an inherited label, create an {@code AppliedLabel} with {@code labelId} as the inherited label's ID and {@code isNegated} set to true.
         • labelId - optional; type long
           The ID of a created {@link Label}.
         • isNegated - optional; type boolean
           {@code isNegated} should be set to {@code true} to negate the effects of {@code labelId}.
         Contains the set of labels applied directly to this creative placeholder as well as those inherited from the creative template from which this creative placeholder was instantiated. This field is readonly and is assigned by Google.
       • expectedCreativeCount - optional; type int
         Expected number of creatives that will be uploaded corresponding to this creative placeholder. This estimate is used to improve the accuracy of forecasting; for example, if label frequency capping limits the number of times a creative may be served.
       • creativeSizeType - optional; type CreativeSizeType - type string with restriction - enum { 'PIXEL', 'ASPECT_RATIO', 'INTERSTITIAL', 'IGNORED', 'NATIVE', 'AUDIO' }
         Describes the types of sizes a creative can be. By default, the creative's size is {@link CreativeSizeType#PIXEL}, which is a dimension based size (width-height pair).
       • targetingName - optional; type string
         The name of the {@link CreativeTargeting} for creatives this placeholder represents.

         This attribute is optional. Specifying creative targeting here is for forecasting purposes only and has no effect on serving. The same creative targeting should be specified on a {@link LineItemCreativeAssociation} when associating a {@link Creative} with the {@link LineItem}.

       • isAmpOnly - optional; type boolean
         Indicate if the expected creative of this placeholder has an AMP only variant.

         This attribute is optional. It is for forecasting purposes only and has no effect on serving.

       Details about the creatives that are expected to serve through the {@code ProposalLineItem}. This attribute is optional during creation and defaults to the {@link Product#creativePlaceholders product's creative placeholders}. This attribute is required.
     • targeting - optional; type Targeting
       Contains the targeting criteria for the {@code ProposalLineItem}. This attribute is required.
       Contains targeting criteria for {@link LineItem} objects. See {@link LineItem#targeting}.
       • geoTargeting - optional; type GeoTargeting
         Provides line items the ability to target geographical locations. By default, line items target all countries and their subdivisions. With geographical targeting, you can target line items to specific countries, regions, metro areas, and cities. You can also exclude the same.

         The following rules apply for geographical targeting:

         • You cannot target and exclude the same location.
         • You cannot target a child whose parent has been excluded. For example, if the state of Illinois has been excluded, then you cannot target Chicago.
         • You must not target a location if you are also targeting its parent. For example, if you are targeting New York City, you must not have the state of New York as one of the targeted locations.
         • You cannot explicitly define inclusions or exclusions that are already implicit. For example, if you explicitly include California, you implicitly exclude all other states. You therefore cannot explicitly exclude Florida, because it is already implicitly excluded. Conversely if you explicitly exclude Florida, you cannot explicitly include California.
         • targetedLocations - optional, unbounded; type Location
           The geographical locations being targeted by the {@link LineItem}.
           A {@link Location} represents a geographical entity that can be targeted. If a location type is not available because of the API version you are using, the location will be represented as just the base class, otherwise it will be sub-classed correctly.
           • id - optional; type long
             Uniquely identifies each {@code Location}.
           • type - optional; type string
             The location type for this geographical entity (ex. "COUNTRY", "CITY", "STATE", "COUNTY", etc.)
           • canonicalParentId - optional; type int
             The nearest location parent's ID for this geographical entity.
           • displayName - optional; type string
             The localized name of the geographical entity.
         • excludedLocations - optional, unbounded; type Location
           The geographical locations being excluded by the {@link LineItem}.
           A {@link Location} represents a geographical entity that can be targeted. If a location type is not available because of the API version you are using, the location will be represented as just the base class, otherwise it will be sub-classed correctly.
           • id - optional; type long
             Uniquely identifies each {@code Location}.
           • type - optional; type string
             The location type for this geographical entity (ex. "COUNTRY", "CITY", "STATE", "COUNTY", etc.)
           • canonicalParentId - optional; type int
             The nearest location parent's ID for this geographical entity.
           • displayName - optional; type string
             The localized name of the geographical entity.
         Specifies what geographical locations are targeted by the {@link LineItem}. This attribute is optional.
       • inventoryTargeting - optional; type InventoryTargeting
         A collection of targeted and excluded ad units and placements.
         • targetedAdUnits - optional, unbounded; type AdUnitTargeting
           Represents targeted or excluded ad units.
           • adUnitId - optional; type string
             Included or excluded ad unit id.
           • includeDescendants - optional; type boolean
             Whether or not all descendants are included (or excluded) as part of including (or excluding) this ad unit. By default, the value is {@code true} which means targeting this ad unit will target all of its descendants.
           A list of targeted {@link AdUnitTargeting}.
         • excludedAdUnits - optional, unbounded; type AdUnitTargeting
           Represents targeted or excluded ad units.
           • adUnitId - optional; type string
             Included or excluded ad unit id.
           • includeDescendants - optional; type boolean
             Whether or not all descendants are included (or excluded) as part of including (or excluding) this ad unit. By default, the value is {@code true} which means targeting this ad unit will target all of its descendants.
           A list of excluded {@link AdUnitTargeting}.
         • targetedPlacementIds - optional, unbounded; type long
           A list of targeted {@link Placement} ids.
         Specifies what inventory is targeted by the {@link LineItem}. This attribute is required. The line item must target at least one ad unit or placement.
       • dayPartTargeting - optional; type DayPartTargeting
         Modify the delivery times of line items for particular days of the week. By default, line items are served at all days and times.
         • dayParts - optional, unbounded; type DayPart
           {@code DayPart} represents a time-period within a day of the week which is targeted by a {@link LineItem}.
           • dayOfWeek - optional; type DayOfWeek - type string with restriction - enum { 'MONDAY', 'TUESDAY', 'WEDNESDAY', 'THURSDAY', 'FRIDAY', 'SATURDAY', 'SUNDAY' }
             Day of the week the target applies to. This field is required.
           • startTime - optional; type TimeOfDay
             Represents the start time of the targeted period (inclusive).
             Represents a specific time in a day.
             • hour - optional; type int
               Hour in 24 hour time (0..24). This field must be between 0 and 24, inclusive. This field is required.
             • minute - optional; type MinuteOfHour - type string with restriction - enum { 'ZERO', 'FIFTEEN', 'THIRTY', 'FORTY_FIVE' }
               Minutes in an hour. Currently, only 0, 15, 30, and 45 are supported. This field is required.
           • endTime - optional; type TimeOfDay
             Represents the end time of the targeted period (exclusive).
             Represents a specific time in a day.
             • hour - optional; type int
               Hour in 24 hour time (0..24). This field must be between 0 and 24, inclusive. This field is required.
             • minute - optional; type MinuteOfHour - type string with restriction - enum { 'ZERO', 'FIFTEEN', 'THIRTY', 'FORTY_FIVE' }
               Minutes in an hour. Currently, only 0, 15, 30, and 45 are supported. This field is required.
           Specifies days of the week and times at which a {@code LineItem} will be delivered.

           If targeting all days and times, this value will be ignored.

         • timeZone - optional; type DeliveryTimeZone - type string with restriction - enum { 'PUBLISHER', 'BROWSER' }
           Specifies the time zone to be used for delivering {@link LineItem} objects. This attribute is optional and defaults to {@link DeliveryTimeZone#BROWSER}.

           Setting this has no effect if targeting all days and times.

         Specifies the days of the week and times that are targeted by the {@link LineItem}. This attribute is optional.
       • dateTimeRangeTargeting - optional; type DateTimeRangeTargeting
         The date time ranges that the line item is eligible to serve.
         • targetedDateTimeRanges - optional, unbounded; type DateTimeRange
           Represents a range of dates (combined with time of day) that has an upper and/or lower bound.
           • startDateTime - optional; type DateTime
             Represents a date combined with the time of day.
             • date - optional; type Date
               Represents a date.
               • year - optional; type int
                 Year (e.g., 2009)
               • month - optional; type int
                 Month (1..12)
               • day - optional; type int
                 Day (1..31)
             • hour - optional; type int
             • minute - optional; type int
             • second - optional; type int
             • timeZoneId - optional; type string
             The start date time of this range. This field is optional and if it is not set then there is no lower bound on the date time range. If this field is not set then {@code endDateTime} must be specified.
           • endDateTime - optional; type DateTime
             Represents a date combined with the time of day.
             • date - optional; type Date
               Represents a date.
               • year - optional; type int
                 Year (e.g., 2009)
               • month - optional; type int
                 Month (1..12)
               • day - optional; type int
                 Day (1..31)
             • hour - optional; type int
             • minute - optional; type int
             • second - optional; type int
             • timeZoneId - optional; type string
             The end date time of this range. This field is optional and if it is not set then there is no upper bound on the date time range. If this field is not set then {@code startDateTime} must be specified.
         Specifies the dates and time ranges that are targeted by the {@link LineItem}. This attribute is optional.
       • technologyTargeting - optional; type TechnologyTargeting
         Provides {@link LineItem} objects the ability to target or exclude technologies.
         • bandwidthGroupTargeting - optional; type BandwidthGroupTargeting
           The bandwidth groups being targeted by the {@link LineItem}.
           Represents bandwidth groups that are being targeted or excluded by the {@link LineItem}.
           • isTargeted - optional; type boolean
             Indicates whether bandwidth groups should be targeted or excluded. This attribute is optional and defaults to {@code true}.
           • bandwidthGroups - optional, unbounded; type Technology
             The bandwidth groups that are being targeted or excluded by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
         • browserTargeting - optional; type BrowserTargeting
           The browsers being targeted by the {@link LineItem}.
           Represents browsers that are being targeted or excluded by the {@link LineItem}.
           • isTargeted - optional; type boolean
             Indicates whether browsers should be targeted or excluded. This attribute is optional and defaults to {@code true}.
           • browsers - optional, unbounded; type Technology
             Browsers that are being targeted or excluded by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
         • browserLanguageTargeting - optional; type BrowserLanguageTargeting
           The languages of browsers being targeted by the {@link LineItem}.
           Represents browser languages that are being targeted or excluded by the {@link LineItem}.
           • isTargeted - optional; type boolean
             Indicates whether browsers languages should be targeted or excluded. This attribute is optional and defaults to {@code true}.
           • browserLanguages - optional, unbounded; type Technology
             Browser languages that are being targeted or excluded by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
         • deviceCapabilityTargeting - optional; type DeviceCapabilityTargeting
           The device capabilities being targeted by the {@link LineItem}.
           Represents device capabilities that are being targeted or excluded by the {@link LineItem}.
           • targetedDeviceCapabilities - optional, unbounded; type Technology
             Device capabilities that are being targeted by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
           • excludedDeviceCapabilities - optional, unbounded; type Technology
             Device capabilities that are being excluded by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
         • deviceCategoryTargeting - optional; type DeviceCategoryTargeting
           The device categories being targeted by the {@link LineItem}.
           Represents device categories that are being targeted or excluded by the {@link LineItem}.
           • targetedDeviceCategories - optional, unbounded; type Technology
             Device categories that are being targeted by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
           • excludedDeviceCategories - optional, unbounded; type Technology
             Device categories that are being excluded by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
         • deviceManufacturerTargeting - optional; type DeviceManufacturerTargeting
           The device manufacturers being targeted by the {@link LineItem}.
           Represents device manufacturer that are being targeted or excluded by the {@link LineItem}.
           • isTargeted - optional; type boolean
             Indicates whether device manufacturers should be targeted or excluded. This attribute is optional and defaults to {@code true}.
           • deviceManufacturers - optional, unbounded; type Technology
             Device manufacturers that are being targeted or excluded by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
         • mobileCarrierTargeting - optional; type MobileCarrierTargeting
           The mobile carriers being targeted by the {@link LineItem}.
           Represents mobile carriers that are being targeted or excluded by the {@link LineItem}.
           • isTargeted - optional; type boolean
             Indicates whether mobile carriers should be targeted or excluded. This attribute is optional and defaults to {@code true}.
           • mobileCarriers - optional, unbounded; type Technology
             Mobile carriers that are being targeted or excluded by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
         • mobileDeviceTargeting - optional; type MobileDeviceTargeting
           The mobile devices being targeted by the {@link LineItem}.
           Represents mobile devices that are being targeted or excluded by the {@link LineItem}.
           • targetedMobileDevices - optional, unbounded; type Technology
             Mobile devices that are being targeted by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
           • excludedMobileDevices - optional, unbounded; type Technology
             Mobile devices that are being excluded by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
         • mobileDeviceSubmodelTargeting - optional; type MobileDeviceSubmodelTargeting
           The mobile device submodels being targeted by the {@link LineItem}.
           Represents mobile devices that are being targeted or excluded by the {@link LineItem}.
           • targetedMobileDeviceSubmodels - optional, unbounded; type Technology
             Mobile device submodels that are being targeted by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
           • excludedMobileDeviceSubmodels - optional, unbounded; type Technology
             Mobile device submodels that are being excluded by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
         • operatingSystemTargeting - optional; type OperatingSystemTargeting
           The operating systems being targeted by the {@link LineItem}.
           Represents operating systems that are being targeted or excluded by the {@link LineItem}.
           • isTargeted - optional; type boolean
             Indicates whether operating systems should be targeted or excluded. This attribute is optional and defaults to {@code true}.
           • operatingSystems - optional, unbounded; type Technology
             Operating systems that are being targeted or excluded by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
         • operatingSystemVersionTargeting - optional; type OperatingSystemVersionTargeting
           The operating system versions being targeted by the {@link LineItem}.
           Represents operating system versions that are being targeted or excluded by the {@link LineItem}.
           • targetedOperatingSystemVersions - optional, unbounded; type Technology
             Operating system versions that are being targeted by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
           • excludedOperatingSystemVersions - optional, unbounded; type Technology
             Operating system versions that are being excluded by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
         Specifies the browsing technologies that are targeted by the {@link LineItem}. This attribute is optional.
       • customTargeting - optional; type CustomCriteriaSet - extension of abstract type CustomCriteriaNode
         A {@link CustomCriteriaSet} comprises of a set of {@link CustomCriteriaNode} objects combined by the {@link CustomCriteriaSet.LogicalOperator#logicalOperator}. The custom criteria targeting tree is subject to the rules defined on {@link Targeting#customTargeting}.
         A {@link CustomCriteriaNode} is a node in the custom targeting tree. A custom criteria node can either be a {@link CustomCriteriaSet} (a non-leaf node) or a {@link CustomCriteria} (a leaf node). The custom criteria targeting tree is subject to the rules defined on {@link Targeting#customTargeting}.
         • logicalOperator - optional; type CustomCriteriaSet.LogicalOperator - type string with restriction - enum { 'AND', 'OR' }
           The logical operator to be applied to {@link CustomCriteriaSet#children}. This attribute is required. This attribute is required.
         • children - optional, unbounded; type CustomCriteriaNode
           The custom criteria. This attribute is required.
           A {@link CustomCriteriaNode} is a node in the custom targeting tree. A custom criteria node can either be a {@link CustomCriteriaSet} (a non-leaf node) or a {@link CustomCriteria} (a leaf node). The custom criteria targeting tree is subject to the rules defined on {@link Targeting#customTargeting}.
           Specifies the collection of custom criteria that is targeted by the {@link LineItem}.

           Once the {@link LineItem} is updated or modified with custom targeting, the server may return a normalized, but equivalent representation of the custom targeting expression.

           {@code customTargeting} will have up to three levels of expressions including itself.

           The top level {@code CustomCriteriaSet} i.e. the {@code customTargeting} object can only contain a {@link CustomCriteriaSet.LogicalOperator#OR} of all its children.

           The second level of {@code CustomCriteriaSet} objects can only contain {@link CustomCriteriaSet.LogicalOperator#AND} of all their children. If a {@link CustomCriteria} is placed on this level, the server will wrap it in a {@link CustomCriteriaSet}.

           The third level can only comprise of {@link CustomCriteria} objects.

           The resulting custom targeting tree would be of the form:
           

         • userDomainTargeting - optional; type UserDomainTargeting
           Specifies the domains or subdomains that are targeted or excluded by the {@link LineItem}. Users visiting from an IP address associated with those domains will be targeted or excluded. This attribute is optional.
           Provides line items the ability to target or exclude users visiting their websites from a list of domains or subdomains.
           • domains - optional, unbounded; type string
             The domains or subdomains that are being targeted or excluded by the {@link LineItem}. This attribute is required and the maximum length of each domain is 67 characters.
           • targeted - optional; type boolean
             Indicates whether domains should be targeted or excluded. This attribute is optional and defaults to {@code true}.
         • contentTargeting - optional; type ContentTargeting
           Used to target {@link LineItem}s to specific videos on a publisher's site.
           • targetedContentIds - optional, unbounded; type long
             The IDs of content being targeted by the {@code LineItem}.
           • excludedContentIds - optional, unbounded; type long
             The IDs of content being excluded by the {@code LineItem}.
           • targetedVideoContentBundleIds - optional, unbounded; type long
             A list of video content bundles, represented by {@link ContentBundle} IDs, that are being targeted by the {@code LineItem}.
           • excludedVideoContentBundleIds - optional, unbounded; type long
             A list of video content bundles, represented by {@link ContentBundle} IDs, that are being excluded by the {@code LineItem}.
           Specifies the video categories and individual videos targeted by the {@link LineItem}.
         • videoPositionTargeting - optional; type VideoPositionTargeting
           Specifies targeting against video position types.
           Represents positions within and around a video where ads can be targeted to.

           Example positions could be {@code pre-roll} (before the video plays), {@code post-roll} (after a video has completed playback) and {@code mid-roll} (during video playback).

           Empty video position targeting means that all video positions are allowed. If a bumper line item has empty video position targeting it will be updated to target all bumper positions.

           • targetedPositions - optional, unbounded; type VideoPositionTarget
             The {@link VideoTargetingPosition} objects being targeted by the video {@link LineItem}.
             Represents the options for targetable positions within a video.
             • videoPosition - optional; type VideoPosition
               Represents a targetable position within a video. A video ad can be targeted to a position (pre-roll, all mid-rolls, or post-roll), or to a specific mid-roll index.
               • positionType - optional; type VideoPosition.Type - type string with restriction - enum { 'UNKNOWN', 'ALL', 'PREROLL', 'MIDROLL', 'POSTROLL' }
                 The type of video position (pre-roll, mid-roll, or post-roll).
               • midrollIndex - optional; type int
                 The index of the mid-roll to target. Only valid if the {@link positionType} is {@link VideoPositionType#MIDROLL}, otherwise this field will be ignored.
               The video position to target. This attribute is required.
             • videoBumperType - optional; type VideoBumperType - type string with restriction - enum { 'BEFORE', 'AFTER' }
               The video bumper type to target. To target a video position or a pod position, this value must be null. To target a bumper position this value must be populated and the line item must have a bumper type. To target a custom ad spot, this value must be null.
             • videoPositionWithinPod - optional; type VideoPositionWithinPod
               Represents a targetable position within a pod within a video stream. A video ad can be targeted to any position in the pod (first, second, third ... last). If there is only 1 ad in a pod, either first or last will target that position.
               • index - optional; type int
                 The specific index of the pod. The index is defined as:

                 • 1 = first
                 • 2 = second
                 • 3 = third
                 • ....
                 • 100 = last

                 100 will always be the last position. For example, for a pod with 5 positions, 100 would target position 5. Multiple targets against the index 100 can exist.
                 Positions over 100 are not supported.
               The video position within a pod to target. To target a video position or a bumper position, this value must be null. To target a position within a pod this value must be populated. To target a custom ad spot, this value must be null.
             • adSpotId - optional; type long
               A custom spot {@link AdSpot} to target. To target a video position, a bumper type or a video position within a pod this value must be null.
         • mobileApplicationTargeting - optional; type MobileApplicationTargeting
           Provides the ability to target or exclude users' mobile applications.
           • mobileApplicationIds - optional, unbounded; type long
             The {@link MobileApplication#id IDs} that are being targeted or excluded.
           • isTargeted - optional; type boolean
             Indicates whether mobile apps should be targeted or excluded. This attribute is optional and defaults to {@code true}.
           Specifies targeting against mobile applications.
         • buyerUserListTargeting - optional; type BuyerUserListTargeting
           The {@code BuyerUserListTargeting} associated with a programmatic {@link LineItem} or {@link ProposalLineItem} object.
           • hasBuyerUserListTargeting - optional; type boolean
             Whether the programmatic {@code LineItem} or {@code ProposalLineItem} object has buyer user list targeting.
           Specifies whether buyer user lists are targeted on a programmatic {@link LineItem} or {@link ProposalLineItem}. This attribute is readonly and is populated by Google.
         • inventoryUrlTargeting - optional; type InventoryUrlTargeting
           A collection of targeted inventory urls.
           • targetedUrls - optional, unbounded; type InventoryUrl
             The representation of an inventory Url that is used in targeting.
             • id - optional; type long
           • excludedUrls - optional, unbounded; type InventoryUrl
             The representation of an inventory Url that is used in targeting.
             • id - optional; type long
           Specifies the URLs that are targeted by the entity. This is currently only supported by {@link YieldGroup}.
         • verticalTargeting - optional; type VerticalTargeting
           Specifies the verticals that are targeted by the entity. The IDs listed here correspond to the IDs in the AD_CATEGORY table of type VERTICAL.
           Vertical targeting information.
           • targetedVerticalIds - optional, unbounded; type long
           • excludedVerticalIds - optional, unbounded; type long
         • contentLabelTargeting - optional; type ContentLabelTargeting
           Content label targeting information.
           • excludedContentLabelIds - optional, unbounded; type long
           Specifies the content labels that are excluded by the entity. The IDs listed here correspond to the IDs in the CONTENT_LABEL table.
         • requestPlatformTargeting - optional; type RequestPlatformTargeting
           Provides line items the ability to target the platform that requests and renders the ad.

           The following rules apply for {@link RequestPlatformTargeting}

           • {@link RequestPlatformTargeting} must be specified for {@link ProposalLineItem}s.
           • {@link RequestPlatformTargeting} must be specified for video line items. Empty values for {@link RequestPlatformTargeting#targetedRequestPlatforms} mean that all request platforms will be targeted.
           • {@link RequestPlatformTargeting} is read-only and assigned by Google for non-video line items.
           • {@link RequestPlatformTargeting} is read-only and assigned by Google for line items generated from proposal line items.
           • targetedRequestPlatforms - optional, unbounded; type RequestPlatform - type string with restriction - enum { 'UNKNOWN', 'BROWSER', 'MOBILE_APP', 'VIDEO_PLAYER' }
           Specifies the request platforms that are targeted by the {@link LineItem}. This attribute is required for video line items and for {@link ProposalLineItem}.

           This value is modifiable for video line items, but read-only for non-video line items.

           This value is read-only for video line items generated from proposal line items.

         • inventorySizeTargeting - optional; type InventorySizeTargeting
           Represents a collection of targeted and excluded inventory sizes. This is currently only available on {@link YieldGroup} and {@link TrafficDataRequest}.
           • isTargeted - optional; type boolean
             Whether the inventory sizes should be targeted or excluded.
           • targetedSizes - optional, unbounded; type TargetedSize
             A list of {@link TargetedSizeDto}s.
             A size that is targeted on a request.
             • size - optional; type Size
               Represents the dimensions of an {@link AdUnit}, {@link LineItem} or {@link Creative}.

               For interstitial size (out-of-page), native, ignored and fluid size, {@link Size} must be 1x1.

               • width - optional; type int
                 The width of the {@link AdUnit}, {@link LineItem} or {@link Creative}.
               • height - optional; type int
                 The height of the {@link AdUnit}, {@link LineItem} or {@link Creative}.
               • isAspectRatio - optional; type boolean
                 Whether this size represents an aspect ratio.
           Specifies the sizes that are targeted by the entity. This is currently only supported on {@link YieldGroup} and {@link TrafficDataRequest}.
         • customFieldValues - optional, unbounded; type BaseCustomFieldValue
           The value of a {@link CustomField} for a particular entity.
           • customFieldId - optional; type long
             Id of the {@code CustomField} to which this value belongs. This attribute is required.
           The values of the custom fields associated with the {@code ProposalLineItem}. This attribute is optional. This attribute can be configured as editable after the proposal has been submitted. Please check with your network administrator for editable fields configuration.
         • appliedLabels - optional, unbounded; type AppliedLabel
           Represents a {@link Label} that can be applied to an entity. To negate an inherited label, create an {@code AppliedLabel} with {@code labelId} as the inherited label's ID and {@code isNegated} set to true.
           • labelId - optional; type long
             The ID of a created {@link Label}.
           • isNegated - optional; type boolean
             {@code isNegated} should be set to {@code true} to negate the effects of {@code labelId}.
           The set of labels applied directly to the {@code ProposalLineItem}. This attribute is optional.
         • effectiveAppliedLabels - optional, unbounded; type AppliedLabel
           Represents a {@link Label} that can be applied to an entity. To negate an inherited label, create an {@code AppliedLabel} with {@code labelId} as the inherited label's ID and {@code isNegated} set to true.
           • labelId - optional; type long
             The ID of a created {@link Label}.
           • isNegated - optional; type boolean
             {@code isNegated} should be set to {@code true} to negate the effects of {@code labelId}.
           Contains the set of labels applied directly to the proposal as well as those inherited ones. If a label has been negated, only the negated label is returned. This attribute is read-only.
         • disableSameAdvertiserCompetitiveExclusion - optional; type 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 {@code true} will allow line items from the same advertiser to serve regardless of the other competitive exclusion labels being applied.

           This attribute is optional and defaults to false.

         • isSold - optional; type boolean
           Indicates whether this {@code ProposalLineItem} has been sold. This attribute is read-only.
         • netRate - optional; type Money
           Represents a money amount.
           • currencyCode - optional; type string
             Three letter currency code in string format.
           • microAmount - optional; type long
             Money values are always specified in terms of micros which are a millionth of the fundamental currency unit. For US dollars, $1 is 1,000,000 micros.
           The amount of money to spend per impression or click in proposal currency. It supports precision of 4 decimal places in terms of the fundamental currency unit, so the {@link Money#getAmountInMicros} must be multiples of 100. It doesn't include agency commission.

           For example, if {@link Proposal#currencyCode} is 'USD', then $123.4567 could be represented as 123456700, but further precision is not supported.

           The field {@link ProposalLineItem#netRate} is required, and used to calculate {@link ProposalLineItem#netCost} if unspecified.

         • netCost - optional; type Money
           Represents a money amount.
           • currencyCode - optional; type string
             Three letter currency code in string format.
           • microAmount - optional; type long
             Money values are always specified in terms of micros which are a millionth of the fundamental currency unit. For US dollars, $1 is 1,000,000 micros.
           The cost of the {@code ProposalLineItem} in proposal currency. It supports precision of 2 decimal places in terms of the fundamental currency unit, so the {@link Money#getAmountInMicros} must be multiples of 10000. It doesn't include agency commission.

           For example, if {@link Proposal#currencyCode} is 'USD', then $123.45 could be represented as 123450000, but further precision is not supported.

           The field {@link ProposalLineItem#netRate} is required, and used to calculate {@link ProposalLineItem#netCost} if unspecified.

         • deliveryIndicator - optional; type DeliveryIndicator
           Indicates the delivery performance of the {@link LineItem}.
           • expectedDeliveryPercentage - optional; type double
             How much the {@code LineItem} was expected to deliver as a percentage of {@link LineItem#primaryGoal}.
           • actualDeliveryPercentage - optional; type double
             How much the line item actually delivered as a percentage of {@link LineItem#primaryGoal}.
           Indicates how well the line item generated from this proposal line item has been performing. This will be {@code null} if the delivery indicator information is not available due to one of the following reasons:

           1. The proposal line item has not pushed to Ad Manager.
           2. The line item is not delivering.
           3. The line item has an unlimited goal or cap.
           4. The line item has a percentage based goal or cap.

           This attribute is read-only.
         • deliveryData - optional; type DeliveryData
           Holds the number of clicks or impressions, determined by {@link LineItem#costType}, delivered for a single line item for the last 7 days
           • units - optional, unbounded; type long
             Clicks or impressions delivered for the last 7 days.
           Delivery data provides the number of clicks or impressions delivered for the {@link LineItem} generated from this proposal line item in the last 7 days. This will be {@code null} if the delivery data cannot be computed due to one of the following reasons:

           1. The proposal line item has not pushed to Ad Manager.
           2. The line item is not deliverable.
           3. The line item has completed delivering more than 7 days ago.
           4. The line item has an absolute-based goal. {@link ProposalLineItem#deliveryIndicator} should be used to track its progress in this case. This attribute is read-only.
         • computedStatus - optional; type ComputedStatus - type string with restriction - enum { 'DELIVERY_EXTENDED', 'DELIVERING', 'READY', 'PAUSED', 'INACTIVE', 'PAUSED_INVENTORY_RELEASED', 'PENDING_APPROVAL', 'COMPLETED', 'DISAPPROVED', 'DRAFT', 'CANCELED' }
           The status of the {@link LineItem} generated from this proposal line item. This will be {@code null} if the proposal line item has not pushed to Ad Manager. This attribute is read-only.
         • lastModifiedDateTime - optional; type DateTime
           Represents a date combined with the time of day.
           • date - optional; type Date
             Represents a date.
             • year - optional; type int
               Year (e.g., 2009)
             • month - optional; type int
               Month (1..12)
             • day - optional; type int
               Day (1..31)
           • hour - optional; type int
           • minute - optional; type int
           • second - optional; type int
           • timeZoneId - optional; type string
           The date and time this {@code ProposalLineItem} was last modified.

           This attribute is assigned by Google when a {@code ProposalLineItem} is updated. This attribute is read-only.

         • reservationStatus - optional; type ReservationStatus - type string with restriction - enum { 'RESERVED', 'NOT_RESERVED', 'RELEASED', 'CHECK_LINE_ITEM_RESERVATION_STATUS', 'UNKNOWN' }
           The reservation status of the {@link ProposalLineItem}. This attribute is read-only.
         • lastReservationDateTime - optional; type DateTime
           Represents a date combined with the time of day.
           • date - optional; type Date
             Represents a date.
             • year - optional; type int
               Year (e.g., 2009)
             • month - optional; type int
               Month (1..12)
             • day - optional; type int
               Day (1..31)
           • hour - optional; type int
           • minute - optional; type int
           • second - optional; type int
           • timeZoneId - optional; type string
           The last {@link DateTime} when the {@link ProposalLineItem} reserved inventory. This attribute is read-only.
         • environmentType - optional; type EnvironmentType - type string with restriction - enum { 'BROWSER', 'VIDEO_PLAYER' }
           The environment that the {@code ProposalLineItem} is targeting. The default value is {@link EnvironmentType#BROWSER}. If this value is {@link EnvironmentType#VIDEO_PLAYER}, then this {@code ProposalLineItem} can only target {@link AdUnit ad units} that have {@link AdUnitSize sizes} whose {@link AdUnitSize#environmentType} is also {@link EnvironmentType#VIDEO_PLAYER}.

           This field is read-only and set to {@link Product#environmentType} of the product this proposal line item was created from.

         • allowedFormats - optional, unbounded; type AllowedFormats - type string with restriction - enum { 'AUDIO', 'UNKNOWN' }
           The set of {@link AllowedFormats} that this proposal line item can have. If the set is empty, this proposal line item allows all formats.
         • additionalTerms - optional; type string
           Additional terms shown to the buyer in Marketplace.
         • programmaticCreativeSource - optional; type ProgrammaticCreativeSource - type string with restriction - enum { 'PUBLISHER', 'ADVERTISER', 'UNKNOWN' }
           Indicates the {@link ProgrammaticCreativeSource} of the programmatic line item.
         • grpSettings - optional; type GrpSettings
           {@code GrpSettings} contains information for a line item that will have a target demographic when serving. This information will be used to set up tracking and enable reporting on the demographic information.
           • minTargetAge - optional; type long
             Specifies the minimum target age (in years) of the {@link LineItem}. This field is only applicable if {@link #provider} is not null.
           • maxTargetAge - optional; type long
             Specifies the maximum target age (in years) of the {@link LineItem}. This field is only applicable if {@link #provider} is not null.
           • targetGender - optional; type GrpTargetGender - type string with restriction - enum { 'UNKNOWN', 'MALE', 'FEMALE', 'BOTH' }
             Specifies the target gender of the {@link LineItem}. This field is only applicable if {@link #provider} is not null.
           • provider - optional; type GrpProvider - type string with restriction - enum { 'UNKNOWN', 'NIELSEN' }
             Specifies the GRP provider of the {@link LineItem}.
           • inTargetRatioEstimateMilliPercent - optional; type long
             Estimate for the in-target ratio given the line item's audience targeting. This field is only applicable if {@link #provider} is Nielsen, {@link LineItem#primaryGoal#unitType} is in-target impressions, and {@link LineItem#CostType} is in-target CPM. This field determines the in-target ratio to use for pacing Nielsen line items before Nielsen reporting data is available. Represented as a milli percent, so 55.7% becomes 55700.
           • nielsenCtvPacingType - optional; type NielsenCtvPacingType - type string with restriction - enum { 'UNKNOWN', 'NONE', 'COVIEW', 'STRICT_COVIEW' }
             Specifies which pacing computation to apply in pacing to impressions from connected devices. This field is required if {@code enableNielsenCoViewingSupport} is true.
           • pacingDeviceCategorizationType - optional; type PacingDeviceCategorizationType - type string with restriction - enum { 'UNKNOWN', 'GOOGLE', 'NIELSEN' }
             Specifies whether to use Google or Nielsen device breakdown in Nielsen Line Item auto pacing.
           • applyTrueCoview - optional; type boolean
             Specifies whether to apply true coviewing in Nielsen Line Item auto pacing. This field can only be true if NielsenCtvPacingType is not NONE.
           Contains the information for a proposal line item which has a target GRP demographic.
         • estimatedMinimumImpressions - optional; type long
           The estimated minimum impressions that should be delivered for a proposal line item.
         • thirdPartyMeasurementSettings - optional; type ThirdPartyMeasurementSettings
           Contains third party measurement settings for cross-sell Partners
           Contains third party auto-pixeling settings for cross-sell Partners.
           • viewabilityPartner - optional; type ThirdPartyViewabilityIntegrationPartner - type string with restriction - enum { 'NONE', 'MOAT', 'DOUBLE_VERIFY', 'INTEGRAL_AD_SCIENCE', 'COMSCORE', 'TELEMETRY', 'UNKNOWN' }
             A field to determine the type of ThirdPartyViewabilityIntegrationPartner. This field default is NONE.
           • viewabilityClientId - optional; type string
             The third party partner id for YouTube viewability verification.
           • viewabilityReportingId - optional; type string
             The reporting id that maps viewability partner data with a campaign (or a group of related campaigns) specific data.
           • publisherViewabilityPartner - optional; type ThirdPartyViewabilityIntegrationPartner - type string with restriction - enum { 'NONE', 'MOAT', 'DOUBLE_VERIFY', 'INTEGRAL_AD_SCIENCE', 'COMSCORE', 'TELEMETRY', 'UNKNOWN' }
             A field to determine the type of publisher's viewability partner. This field default is NONE.
           • publisherViewabilityClientId - optional; type string
             The third party partner id for YouTube viewability verification for publisher.
           • publisherViewabilityReportingId - optional; type string
             The reporting id that maps viewability partner data with a campaign (or a group of related campaigns) specific data for publisher.
           • brandLiftPartner - optional; type ThirdPartyBrandLiftIntegrationPartner - type string with restriction - enum { 'UNKNOWN', 'NONE', 'KANTAR_MILLWARD_BROWN', 'DYNATA', 'INTAGE', 'MACROMILL' }
             A field to determine the type of ThirdPartyBrandLiftIntegrationPartner. This field default is NONE.
           • brandLiftClientId - optional; type string
             The third party partner id for YouTube brand lift verification.
           • brandLiftReportingId - optional; type string
             The reporting id that maps brand lift partner data with a campaign (or a group of related campaigns) specific data.
           • reachPartner - optional; type ThirdPartyReachIntegrationPartner - type string with restriction - enum { 'NONE', 'COMSCORE', 'NIELSEN', 'KANTAR_MILLWARD_BROWN', 'VIDEO_RESEARCH', 'GEMIUS', 'VIDEO_AMP', 'ISPOT_TV', 'AUDIENCE_PROJECT', 'UNKNOWN' }
             A field to determine the type of advertiser's ThirdPartyReachIntegrationPartner. This field default is UNKNOWN.
           • reachClientId - optional; type string
             The third party partner id for YouTube reach verification for advertiser.
           • reachReportingId - optional; type string
             The reporting id that maps reach partner data with a campaign (or a group of related campaigns) specific data for advertiser.
           • publisherReachPartner - optional; type ThirdPartyReachIntegrationPartner - type string with restriction - enum { 'NONE', 'COMSCORE', 'NIELSEN', 'KANTAR_MILLWARD_BROWN', 'VIDEO_RESEARCH', 'GEMIUS', 'VIDEO_AMP', 'ISPOT_TV', 'AUDIENCE_PROJECT', 'UNKNOWN' }
             A field to determine the type of publisher's ThirdPartyReachIntegrationPartner. This field default is UNKNOWN.
           • publisherReachClientId - optional; type string
             The third party partner id for YouTube reach verification for publisher.
           • publisherReachReportingId - optional; type string
             The reporting id that maps reach partner data with a campaign (or a group of related campaigns) specific data for publisher.
         • makegoodInfo - optional; type ProposalLineItemMakegoodInfo
           Makegood info for this proposal line item. Immutable once created.

           Null if this proposal line item is not a makegood.

           Makegood info for a {@link ProposalLineItemDto}.
           • originalProposalLineItemId - optional; type long
             The ID of the original proposal line item on which this makegood is based. This attribute is read-only.
           • reason - optional; type string
             The publisher-provided reason why this makegood was initiated. This is free form text.

             The following predefined values can be used to render predefined options in the UI.

             UNDERDELIVERY: 'Impression underdelivery', SECONDARY_DELIVERY_TERMS: 'Did not meet secondary delivery terms ', PERFORMANCE: 'Performance issues',

         • hasMakegood - optional; type boolean
           Whether this proposal line item has an associated makegood. This attribute is read-only.
         • canCreateMakegood - optional; type boolean
           Whether a new makegood associated with this line item can be created. This attribute is read-only.
         • pauseRole - optional; type NegotiationRole - type string with restriction - enum { 'BUYER', 'SELLER', 'UNKNOWN' }
           The {@link NegotiationRole} that paused the proposal line item, i.e. {@link NegotiationRole#seller} or {@link NegotiationRole#buyer}, or {@code null} when the proposal is not paused. This attribute is read-only.
         • pauseReason - optional; type string
           The reason for pausing the {@link ProposalLineItem}, provided by the {@link pauseRole}. It is {@code null} when the {@link ProposalLineItem} is not paused. This attribute is read-only.
   Output:
   updateProposalLineItemsResponse (wsdlsoap:header, use = literal, part = ResponseHeader)Source code
   parameters type updateProposalLineItemsResponse

   • rval - optional, unbounded; type ProposalLineItem
     A {@code ProposalLineItem} is added to a programmatic {@link Proposal} and is similar to a delivery {@link LineItem}. It contains delivery details including information like impression goal or quantity, start and end times, and targeting.
     • id - optional; type long
       The unique ID of the {@code ProposalLineItem}. This attribute is read-only.
     • proposalId - optional; type long
       The unique ID of the {@link Proposal}, to which the {@code ProposalLineItem} belongs. This attribute is required for creation and then is readonly. This attribute is required.
     • name - optional; type string
       The name of the {@code ProposalLineItem} which should be unique under the same {@link Proposal}. This attribute has a maximum length of 255 characters. This attribute can be configured as editable after the proposal has been submitted. Please check with your network administrator for editable fields configuration. This attribute is required.
     • startDateTime - optional; type DateTime
       Represents a date combined with the time of day.
       • date - optional; type Date
         Represents a date.
         • year - optional; type int
           Year (e.g., 2009)
         • month - optional; type int
           Month (1..12)
         • day - optional; type int
           Day (1..31)
       • hour - optional; type int
       • minute - optional; type int
       • second - optional; type int
       • timeZoneId - optional; type string
       The date and time at which the line item associated with the {@code ProposalLineItem} is enabled to begin serving. This attribute is optional during creation, but required and must be in the future when it turns into a line item. The {@link DateTime#timeZoneID} is required if start date time is not {@code null}. This attribute becomes readonly once the {@code ProposalLineItem} has started delivering.
     • endDateTime - optional; type DateTime
       Represents a date combined with the time of day.
       • date - optional; type Date
         Represents a date.
         • year - optional; type int
           Year (e.g., 2009)
         • month - optional; type int
           Month (1..12)
         • day - optional; type int
           Day (1..31)
       • hour - optional; type int
       • minute - optional; type int
       • second - optional; type int
       • timeZoneId - optional; type string
       The date and time at which the line item associated with the {@code ProposalLineItem} stops beening served. This attribute is optional during creation, but required and must be after the {@link #startDateTime}. The {@link DateTime#timeZoneID} is required if end date time is not {@code null}.
     • internalNotes - optional; type string
       Provides any additional notes that may annotate the {@code ProposalLineItem}. This attribute is optional and has a maximum length of 65,535 characters. This attribute can be configured as editable after the proposal has been submitted. Please check with your network administrator for editable fields configuration.
     • isArchived - optional; type boolean
       The archival status of the {@code ProposalLineItem}. This attribute is read-only.
     • goal - optional; type Goal
       Defines the criteria a {@link LineItem} needs to satisfy to meet its delivery goal.
       • goalType - optional; type GoalType - type string with restriction - enum { 'NONE', 'LIFETIME', 'DAILY', 'UNKNOWN' }
         The type of the goal for the {@code LineItem}. It defines the period over which the goal for {@code LineItem} should be reached.
       • unitType - optional; type UnitType - type string with restriction - enum { 'IMPRESSIONS', 'CLICKS', 'CLICK_THROUGH_CPA_CONVERSIONS', 'VIEW_THROUGH_CPA_CONVERSIONS', 'TOTAL_CPA_CONVERSIONS', 'VIEWABLE_IMPRESSIONS', 'IN_TARGET_IMPRESSIONS', 'UNKNOWN' }
         The type of the goal unit for the {@code LineItem}.
       • units - optional; type long
         If this is a primary goal, it represents the number or percentage of impressions or clicks that will be reserved for the {@code LineItem}. If the line item is of type {@link LineItemType#SPONSORSHIP}, it represents the percentage of available impressions reserved. If the line item is of type {@link LineItemType#BULK} or {@link LineItemType#PRICE_PRIORITY}, it represents the number of remaining impressions reserved. If the line item is of type {@link LineItemType#NETWORK} or {@link LineItemType#HOUSE}, it represents the percentage of remaining impressions reserved.

         If this is a secondary goal, it represents the number of impressions or conversions that the line item will stop serving at if reached. For valid line item types, see {@link LineItem#secondaryGoals}.

       The goal(i.e. contracted quantity, quantity or limit) that this {@code ProposalLineItem} is associated with, which is used in its pacing and budgeting. {@link Goal#units} must be greater than 0 when the proposal line item turns into a line item, {@link Goal#goalType} and {@link Goal#unitType} are readonly. For a Preferred deal {@code ProposalLineItem}, the goal type can only be {@link GoalType#NONE}. This attribute is required.
     • secondaryGoals - optional, unbounded; type Goal
       Defines the criteria a {@link LineItem} needs to satisfy to meet its delivery goal.
       • goalType - optional; type GoalType - type string with restriction - enum { 'NONE', 'LIFETIME', 'DAILY', 'UNKNOWN' }
         The type of the goal for the {@code LineItem}. It defines the period over which the goal for {@code LineItem} should be reached.
       • unitType - optional; type UnitType - type string with restriction - enum { 'IMPRESSIONS', 'CLICKS', 'CLICK_THROUGH_CPA_CONVERSIONS', 'VIEW_THROUGH_CPA_CONVERSIONS', 'TOTAL_CPA_CONVERSIONS', 'VIEWABLE_IMPRESSIONS', 'IN_TARGET_IMPRESSIONS', 'UNKNOWN' }
         The type of the goal unit for the {@code LineItem}.
       • units - optional; type long
         If this is a primary goal, it represents the number or percentage of impressions or clicks that will be reserved for the {@code LineItem}. If the line item is of type {@link LineItemType#SPONSORSHIP}, it represents the percentage of available impressions reserved. If the line item is of type {@link LineItemType#BULK} or {@link LineItemType#PRICE_PRIORITY}, it represents the number of remaining impressions reserved. If the line item is of type {@link LineItemType#NETWORK} or {@link LineItemType#HOUSE}, it represents the percentage of remaining impressions reserved.

         If this is a secondary goal, it represents the number of impressions or conversions that the line item will stop serving at if reached. For valid line item types, see {@link LineItem#secondaryGoals}.

       The secondary goals that this {@code ProposalLineItem} is associated with. For a programmatic line item with the properties {@link RateType#CPM} and {@link LineItemType#SPONSORSHIP}, this field will have one goal which describes the impressions cap. For other cases, this field is an empty list.
     • contractedUnitsBought - optional; type long
       The contracted number of daily minimum impressions used for {@link LineItemType#SPONSORSHIP} {@code ProposalLineItem} deals with a rate type of {@link RateType#CPD}.

       This attribute is required for percentage-based-goal {@link ProposalLineItem proposal line items}. It does not impact ad-serving and is for reporting purposes only.

     • deliveryRateType - optional; type DeliveryRateType - type string with restriction - enum { 'EVENLY', 'FRONTLOADED', 'AS_FAST_AS_POSSIBLE' }
       The strategy for delivering ads over the course of the {@code ProposalLineItem}'s duration. This attribute is required. For a Preferred deal {@code ProposalLineItem}, the value can only be {@link DeliveryRateType#FRONTLOADED}.
     • roadblockingType - optional; type RoadblockingType - type string with restriction - enum { 'ONLY_ONE', 'ONE_OR_MORE', 'AS_MANY_AS_POSSIBLE', 'ALL_ROADBLOCK', 'CREATIVE_SET' }
       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 during creation and defaults to the {@link Product#roadblockingType product's roadblocking type}, or {@link RoadblockingType#ONE_OR_MORE} if not specified by the product.
     • companionDeliveryOption - optional; type CompanionDeliveryOption - type string with restriction - enum { 'OPTIONAL', 'AT_LEAST_ONE', 'ALL', 'UNKNOWN' }
       The delivery option for companions. This is only valid if the roadblocking type is {@link RoadblockingType#CREATIVE_SET}. The default value for roadblocking creatives is {@link CompanionDeliveryOption#OPTIONAL}. The default value in other cases is {@link CompanionDeliveryOption#UNKNOWN}. Providing something other than {@link CompanionDeliveryOption#UNKNOWN} will cause an error.
     • videoMaxDuration - optional; type long
       The max duration of a video creative associated with this {@code ProposalLineItem} in milliseconds. This attribute is optional, defaults to the {@link Product#videoMaxDuration} on the {@link Product} it was created with, and only meaningful if this is a video proposal line item.
     • videoCreativeSkippableAdType - optional; type SkippableAdType - type string with restriction - enum { 'UNKNOWN', 'DISABLED', 'ENABLED', 'INSTREAM_SELECT', 'ANY' }
       The proposal line item's creatives' skippability. This attribute is optional, only applicable for video proposal line items, and defaults to {@link SkippableAdType#NOT_SKIPPABLE}.
     • frequencyCaps - optional, unbounded; type FrequencyCap
       Represents a limit on the number of times a single viewer can be exposed to the same {@link LineItem} in a specified time period.
       • maxImpressions - optional; type int
         The maximum number of impressions than can be served to a user within a specified time period.
       • numTimeUnits - optional; type int
         The number of {@code FrequencyCap#timeUnit} to represent the total time period.
       • timeUnit - optional; type TimeUnit - type string with restriction - enum { 'MINUTE', 'HOUR', 'DAY', 'WEEK', 'MONTH', 'LIFETIME', 'POD', 'STREAM', 'UNKNOWN' }
         The unit of time for specifying the time period.
       The set of frequency capping units for this {@code ProposalLineItem}. This attribute is optional during creation and defaults to the {@link Product#frequencyCaps product's frequency caps} if {@link Product#allowFrequencyCapsCustomization} is {@code false}.
     • dfpLineItemId - optional; type long
       The unique ID of corresponding {@link LineItem}. This will be {@code null} if the {@link Proposal} has not been pushed to Ad Manager. This attribute is read-only.
     • lineItemType - optional; type LineItemType - type string with restriction - enum { 'SPONSORSHIP', 'STANDARD', 'NETWORK', 'BULK', 'PRICE_PRIORITY', 'HOUSE', 'LEGACY_DFP', 'CLICK_TRACKING', 'ADSENSE', 'AD_EXCHANGE', 'BUMPER', 'ADMOB', 'PREFERRED_DEAL', 'UNKNOWN' }
       The corresponding {@link LineItemType} of the {@code ProposalLineItem}. For a programmatic {@code ProposalLineItem}, the value can only be one of:

       • {@link LineItemType#SPONSORSHIP}
       • {@link LineItemType#STANDARD}
       • {@link LineItemType#PREFERRED_DEAL}

       This attribute is required.
     • lineItemPriority - optional; type int
       The priority for the corresponding {@link LineItem} of the {@code ProposalLineItem}. This attribute is optional during creation and defaults to the default priority of the {@link #lineItemType}. For forecasting, this attribute is optional and has a default value assigned by Google. See {@link LineItem#priority} for more information.
     • rateType - optional; type RateType - type string with restriction - enum { 'CPM', 'CPD', 'VCPM', 'CPM_IN_TARGET', 'UNKNOWN' }
       The method used for billing the {@code ProposalLineItem}. This attribute is read-only. This attribute is required.
     • creativePlaceholders - optional, unbounded; type CreativePlaceholder
       A {@code CreativePlaceholder} describes a slot that a creative is expected to fill. This is used primarily to help in forecasting, and also to validate that the correct creatives are associated with the line item. A {@code CreativePlaceholder} must contain a size, and it can optionally contain companions. Companions are only valid if the line item's environment type is {@link EnvironmentType#VIDEO_PLAYER}.
       • size - optional; type Size
         The dimensions that the creative is expected to have. This attribute is required.
         Represents the dimensions of an {@link AdUnit}, {@link LineItem} or {@link Creative}.

         For interstitial size (out-of-page), native, ignored and fluid size, {@link Size} must be 1x1.

         • width - optional; type int
           The width of the {@link AdUnit}, {@link LineItem} or {@link Creative}.
         • height - optional; type int
           The height of the {@link AdUnit}, {@link LineItem} or {@link Creative}.
         • isAspectRatio - optional; type boolean
           Whether this size represents an aspect ratio.
       • creativeTemplateId - optional; type long
         The native creative template ID.

         This value is only required if {@link #creativeSizeType} is {@link CreativeSizeType#NATIVE}.

       • companions - optional, unbounded; type CreativePlaceholder
         A {@code CreativePlaceholder} describes a slot that a creative is expected to fill. This is used primarily to help in forecasting, and also to validate that the correct creatives are associated with the line item. A {@code CreativePlaceholder} must contain a size, and it can optionally contain companions. Companions are only valid if the line item's environment type is {@link EnvironmentType#VIDEO_PLAYER}.
         • size - optional; type Size
           The dimensions that the creative is expected to have. This attribute is required.
           Represents the dimensions of an {@link AdUnit}, {@link LineItem} or {@link Creative}.

           For interstitial size (out-of-page), native, ignored and fluid size, {@link Size} must be 1x1.

           • width - optional; type int
             The width of the {@link AdUnit}, {@link LineItem} or {@link Creative}.
           • height - optional; type int
             The height of the {@link AdUnit}, {@link LineItem} or {@link Creative}.
           • isAspectRatio - optional; type boolean
             Whether this size represents an aspect ratio.
         • creativeTemplateId - optional; type long
           The native creative template ID.

           This value is only required if {@link #creativeSizeType} is {@link CreativeSizeType#NATIVE}.

         • companions - optional, unbounded; type CreativePlaceholder
           A {@code CreativePlaceholder} describes a slot that a creative is expected to fill. This is used primarily to help in forecasting, and also to validate that the correct creatives are associated with the line item. A {@code CreativePlaceholder} must contain a size, and it can optionally contain companions. Companions are only valid if the line item's environment type is {@link EnvironmentType#VIDEO_PLAYER}.
           • size - optional; type Size
             The dimensions that the creative is expected to have. This attribute is required.
             Represents the dimensions of an {@link AdUnit}, {@link LineItem} or {@link Creative}.

             For interstitial size (out-of-page), native, ignored and fluid size, {@link Size} must be 1x1.

             • width - optional; type int
               The width of the {@link AdUnit}, {@link LineItem} or {@link Creative}.
             • height - optional; type int
               The height of the {@link AdUnit}, {@link LineItem} or {@link Creative}.
             • isAspectRatio - optional; type boolean
               Whether this size represents an aspect ratio.
           • creativeTemplateId - optional; type long
             The native creative template ID.

             This value is only required if {@link #creativeSizeType} is {@link CreativeSizeType#NATIVE}.

           • companions - optional, unbounded; type CreativePlaceholder... is recursive
             The companions that the creative is expected to have. This attribute can only be set if the line item it belongs to has a {@link LineItem#environmentType} of {@link EnvironmentType#VIDEO_PLAYER} or {@link LineItem#roadblockingType} of {@link RoadblockingType#CREATIVE_SET}.
           • appliedLabels - optional, unbounded; type AppliedLabel
             Represents a {@link Label} that can be applied to an entity. To negate an inherited label, create an {@code AppliedLabel} with {@code labelId} as the inherited label's ID and {@code isNegated} set to true.
             • labelId - optional; type long
               The ID of a created {@link Label}.
             • isNegated - optional; type boolean
               {@code isNegated} should be set to {@code true} to negate the effects of {@code labelId}.
             The set of label frequency caps applied directly to this creative placeholder.
           • effectiveAppliedLabels - optional, unbounded; type AppliedLabel
             Represents a {@link Label} that can be applied to an entity. To negate an inherited label, create an {@code AppliedLabel} with {@code labelId} as the inherited label's ID and {@code isNegated} set to true.
             • labelId - optional; type long
               The ID of a created {@link Label}.
             • isNegated - optional; type boolean
               {@code isNegated} should be set to {@code true} to negate the effects of {@code labelId}.
             Contains the set of labels applied directly to this creative placeholder as well as those inherited from the creative template from which this creative placeholder was instantiated. This field is readonly and is assigned by Google.
           • expectedCreativeCount - optional; type int
             Expected number of creatives that will be uploaded corresponding to this creative placeholder. This estimate is used to improve the accuracy of forecasting; for example, if label frequency capping limits the number of times a creative may be served.
           • creativeSizeType - optional; type CreativeSizeType - type string with restriction - enum { 'PIXEL', 'ASPECT_RATIO', 'INTERSTITIAL', 'IGNORED', 'NATIVE', 'AUDIO' }
             Describes the types of sizes a creative can be. By default, the creative's size is {@link CreativeSizeType#PIXEL}, which is a dimension based size (width-height pair).
           • targetingName - optional; type string
             The name of the {@link CreativeTargeting} for creatives this placeholder represents.

             This attribute is optional. Specifying creative targeting here is for forecasting purposes only and has no effect on serving. The same creative targeting should be specified on a {@link LineItemCreativeAssociation} when associating a {@link Creative} with the {@link LineItem}.

           • isAmpOnly - optional; type boolean
             Indicate if the expected creative of this placeholder has an AMP only variant.

             This attribute is optional. It is for forecasting purposes only and has no effect on serving.

           The companions that the creative is expected to have. This attribute can only be set if the line item it belongs to has a {@link LineItem#environmentType} of {@link EnvironmentType#VIDEO_PLAYER} or {@link LineItem#roadblockingType} of {@link RoadblockingType#CREATIVE_SET}.
         • appliedLabels - optional, unbounded; type AppliedLabel
           Represents a {@link Label} that can be applied to an entity. To negate an inherited label, create an {@code AppliedLabel} with {@code labelId} as the inherited label's ID and {@code isNegated} set to true.
           • labelId - optional; type long
             The ID of a created {@link Label}.
           • isNegated - optional; type boolean
             {@code isNegated} should be set to {@code true} to negate the effects of {@code labelId}.
           The set of label frequency caps applied directly to this creative placeholder.
         • effectiveAppliedLabels - optional, unbounded; type AppliedLabel
           Represents a {@link Label} that can be applied to an entity. To negate an inherited label, create an {@code AppliedLabel} with {@code labelId} as the inherited label's ID and {@code isNegated} set to true.
           • labelId - optional; type long
             The ID of a created {@link Label}.
           • isNegated - optional; type boolean
             {@code isNegated} should be set to {@code true} to negate the effects of {@code labelId}.
           Contains the set of labels applied directly to this creative placeholder as well as those inherited from the creative template from which this creative placeholder was instantiated. This field is readonly and is assigned by Google.
         • expectedCreativeCount - optional; type int
           Expected number of creatives that will be uploaded corresponding to this creative placeholder. This estimate is used to improve the accuracy of forecasting; for example, if label frequency capping limits the number of times a creative may be served.
         • creativeSizeType - optional; type CreativeSizeType - type string with restriction - enum { 'PIXEL', 'ASPECT_RATIO', 'INTERSTITIAL', 'IGNORED', 'NATIVE', 'AUDIO' }
           Describes the types of sizes a creative can be. By default, the creative's size is {@link CreativeSizeType#PIXEL}, which is a dimension based size (width-height pair).
         • targetingName - optional; type string
           The name of the {@link CreativeTargeting} for creatives this placeholder represents.

           This attribute is optional. Specifying creative targeting here is for forecasting purposes only and has no effect on serving. The same creative targeting should be specified on a {@link LineItemCreativeAssociation} when associating a {@link Creative} with the {@link LineItem}.

         • isAmpOnly - optional; type boolean
           Indicate if the expected creative of this placeholder has an AMP only variant.

           This attribute is optional. It is for forecasting purposes only and has no effect on serving.

         The companions that the creative is expected to have. This attribute can only be set if the line item it belongs to has a {@link LineItem#environmentType} of {@link EnvironmentType#VIDEO_PLAYER} or {@link LineItem#roadblockingType} of {@link RoadblockingType#CREATIVE_SET}.
       • appliedLabels - optional, unbounded; type AppliedLabel
         Represents a {@link Label} that can be applied to an entity. To negate an inherited label, create an {@code AppliedLabel} with {@code labelId} as the inherited label's ID and {@code isNegated} set to true.
         • labelId - optional; type long
           The ID of a created {@link Label}.
         • isNegated - optional; type boolean
           {@code isNegated} should be set to {@code true} to negate the effects of {@code labelId}.
         The set of label frequency caps applied directly to this creative placeholder.
       • effectiveAppliedLabels - optional, unbounded; type AppliedLabel
         Represents a {@link Label} that can be applied to an entity. To negate an inherited label, create an {@code AppliedLabel} with {@code labelId} as the inherited label's ID and {@code isNegated} set to true.
         • labelId - optional; type long
           The ID of a created {@link Label}.
         • isNegated - optional; type boolean
           {@code isNegated} should be set to {@code true} to negate the effects of {@code labelId}.
         Contains the set of labels applied directly to this creative placeholder as well as those inherited from the creative template from which this creative placeholder was instantiated. This field is readonly and is assigned by Google.
       • expectedCreativeCount - optional; type int
         Expected number of creatives that will be uploaded corresponding to this creative placeholder. This estimate is used to improve the accuracy of forecasting; for example, if label frequency capping limits the number of times a creative may be served.
       • creativeSizeType - optional; type CreativeSizeType - type string with restriction - enum { 'PIXEL', 'ASPECT_RATIO', 'INTERSTITIAL', 'IGNORED', 'NATIVE', 'AUDIO' }
         Describes the types of sizes a creative can be. By default, the creative's size is {@link CreativeSizeType#PIXEL}, which is a dimension based size (width-height pair).
       • targetingName - optional; type string
         The name of the {@link CreativeTargeting} for creatives this placeholder represents.

         This attribute is optional. Specifying creative targeting here is for forecasting purposes only and has no effect on serving. The same creative targeting should be specified on a {@link LineItemCreativeAssociation} when associating a {@link Creative} with the {@link LineItem}.

       • isAmpOnly - optional; type boolean
         Indicate if the expected creative of this placeholder has an AMP only variant.

         This attribute is optional. It is for forecasting purposes only and has no effect on serving.

       Details about the creatives that are expected to serve through the {@code ProposalLineItem}. This attribute is optional during creation and defaults to the {@link Product#creativePlaceholders product's creative placeholders}. This attribute is required.
     • targeting - optional; type Targeting
       Contains the targeting criteria for the {@code ProposalLineItem}. This attribute is required.
       Contains targeting criteria for {@link LineItem} objects. See {@link LineItem#targeting}.
       • geoTargeting - optional; type GeoTargeting
         Provides line items the ability to target geographical locations. By default, line items target all countries and their subdivisions. With geographical targeting, you can target line items to specific countries, regions, metro areas, and cities. You can also exclude the same.

         The following rules apply for geographical targeting:

         • You cannot target and exclude the same location.
         • You cannot target a child whose parent has been excluded. For example, if the state of Illinois has been excluded, then you cannot target Chicago.
         • You must not target a location if you are also targeting its parent. For example, if you are targeting New York City, you must not have the state of New York as one of the targeted locations.
         • You cannot explicitly define inclusions or exclusions that are already implicit. For example, if you explicitly include California, you implicitly exclude all other states. You therefore cannot explicitly exclude Florida, because it is already implicitly excluded. Conversely if you explicitly exclude Florida, you cannot explicitly include California.
         • targetedLocations - optional, unbounded; type Location
           The geographical locations being targeted by the {@link LineItem}.
           A {@link Location} represents a geographical entity that can be targeted. If a location type is not available because of the API version you are using, the location will be represented as just the base class, otherwise it will be sub-classed correctly.
           • id - optional; type long
             Uniquely identifies each {@code Location}.
           • type - optional; type string
             The location type for this geographical entity (ex. "COUNTRY", "CITY", "STATE", "COUNTY", etc.)
           • canonicalParentId - optional; type int
             The nearest location parent's ID for this geographical entity.
           • displayName - optional; type string
             The localized name of the geographical entity.
         • excludedLocations - optional, unbounded; type Location
           The geographical locations being excluded by the {@link LineItem}.
           A {@link Location} represents a geographical entity that can be targeted. If a location type is not available because of the API version you are using, the location will be represented as just the base class, otherwise it will be sub-classed correctly.
           • id - optional; type long
             Uniquely identifies each {@code Location}.
           • type - optional; type string
             The location type for this geographical entity (ex. "COUNTRY", "CITY", "STATE", "COUNTY", etc.)
           • canonicalParentId - optional; type int
             The nearest location parent's ID for this geographical entity.
           • displayName - optional; type string
             The localized name of the geographical entity.
         Specifies what geographical locations are targeted by the {@link LineItem}. This attribute is optional.
       • inventoryTargeting - optional; type InventoryTargeting
         A collection of targeted and excluded ad units and placements.
         • targetedAdUnits - optional, unbounded; type AdUnitTargeting
           Represents targeted or excluded ad units.
           • adUnitId - optional; type string
             Included or excluded ad unit id.
           • includeDescendants - optional; type boolean
             Whether or not all descendants are included (or excluded) as part of including (or excluding) this ad unit. By default, the value is {@code true} which means targeting this ad unit will target all of its descendants.
           A list of targeted {@link AdUnitTargeting}.
         • excludedAdUnits - optional, unbounded; type AdUnitTargeting
           Represents targeted or excluded ad units.
           • adUnitId - optional; type string
             Included or excluded ad unit id.
           • includeDescendants - optional; type boolean
             Whether or not all descendants are included (or excluded) as part of including (or excluding) this ad unit. By default, the value is {@code true} which means targeting this ad unit will target all of its descendants.
           A list of excluded {@link AdUnitTargeting}.
         • targetedPlacementIds - optional, unbounded; type long
           A list of targeted {@link Placement} ids.
         Specifies what inventory is targeted by the {@link LineItem}. This attribute is required. The line item must target at least one ad unit or placement.
       • dayPartTargeting - optional; type DayPartTargeting
         Modify the delivery times of line items for particular days of the week. By default, line items are served at all days and times.
         • dayParts - optional, unbounded; type DayPart
           {@code DayPart} represents a time-period within a day of the week which is targeted by a {@link LineItem}.
           • dayOfWeek - optional; type DayOfWeek - type string with restriction - enum { 'MONDAY', 'TUESDAY', 'WEDNESDAY', 'THURSDAY', 'FRIDAY', 'SATURDAY', 'SUNDAY' }
             Day of the week the target applies to. This field is required.
           • startTime - optional; type TimeOfDay
             Represents the start time of the targeted period (inclusive).
             Represents a specific time in a day.
             • hour - optional; type int
               Hour in 24 hour time (0..24). This field must be between 0 and 24, inclusive. This field is required.
             • minute - optional; type MinuteOfHour - type string with restriction - enum { 'ZERO', 'FIFTEEN', 'THIRTY', 'FORTY_FIVE' }
               Minutes in an hour. Currently, only 0, 15, 30, and 45 are supported. This field is required.
           • endTime - optional; type TimeOfDay
             Represents the end time of the targeted period (exclusive).
             Represents a specific time in a day.
             • hour - optional; type int
               Hour in 24 hour time (0..24). This field must be between 0 and 24, inclusive. This field is required.
             • minute - optional; type MinuteOfHour - type string with restriction - enum { 'ZERO', 'FIFTEEN', 'THIRTY', 'FORTY_FIVE' }
               Minutes in an hour. Currently, only 0, 15, 30, and 45 are supported. This field is required.
           Specifies days of the week and times at which a {@code LineItem} will be delivered.

           If targeting all days and times, this value will be ignored.

         • timeZone - optional; type DeliveryTimeZone - type string with restriction - enum { 'PUBLISHER', 'BROWSER' }
           Specifies the time zone to be used for delivering {@link LineItem} objects. This attribute is optional and defaults to {@link DeliveryTimeZone#BROWSER}.

           Setting this has no effect if targeting all days and times.

         Specifies the days of the week and times that are targeted by the {@link LineItem}. This attribute is optional.
       • dateTimeRangeTargeting - optional; type DateTimeRangeTargeting
         The date time ranges that the line item is eligible to serve.
         • targetedDateTimeRanges - optional, unbounded; type DateTimeRange
           Represents a range of dates (combined with time of day) that has an upper and/or lower bound.
           • startDateTime - optional; type DateTime
             Represents a date combined with the time of day.
             • date - optional; type Date
               Represents a date.
               • year - optional; type int
                 Year (e.g., 2009)
               • month - optional; type int
                 Month (1..12)
               • day - optional; type int
                 Day (1..31)
             • hour - optional; type int
             • minute - optional; type int
             • second - optional; type int
             • timeZoneId - optional; type string
             The start date time of this range. This field is optional and if it is not set then there is no lower bound on the date time range. If this field is not set then {@code endDateTime} must be specified.
           • endDateTime - optional; type DateTime
             Represents a date combined with the time of day.
             • date - optional; type Date
               Represents a date.
               • year - optional; type int
                 Year (e.g., 2009)
               • month - optional; type int
                 Month (1..12)
               • day - optional; type int
                 Day (1..31)
             • hour - optional; type int
             • minute - optional; type int
             • second - optional; type int
             • timeZoneId - optional; type string
             The end date time of this range. This field is optional and if it is not set then there is no upper bound on the date time range. If this field is not set then {@code startDateTime} must be specified.
         Specifies the dates and time ranges that are targeted by the {@link LineItem}. This attribute is optional.
       • technologyTargeting - optional; type TechnologyTargeting
         Provides {@link LineItem} objects the ability to target or exclude technologies.
         • bandwidthGroupTargeting - optional; type BandwidthGroupTargeting
           The bandwidth groups being targeted by the {@link LineItem}.
           Represents bandwidth groups that are being targeted or excluded by the {@link LineItem}.
           • isTargeted - optional; type boolean
             Indicates whether bandwidth groups should be targeted or excluded. This attribute is optional and defaults to {@code true}.
           • bandwidthGroups - optional, unbounded; type Technology
             The bandwidth groups that are being targeted or excluded by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
         • browserTargeting - optional; type BrowserTargeting
           The browsers being targeted by the {@link LineItem}.
           Represents browsers that are being targeted or excluded by the {@link LineItem}.
           • isTargeted - optional; type boolean
             Indicates whether browsers should be targeted or excluded. This attribute is optional and defaults to {@code true}.
           • browsers - optional, unbounded; type Technology
             Browsers that are being targeted or excluded by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
         • browserLanguageTargeting - optional; type BrowserLanguageTargeting
           The languages of browsers being targeted by the {@link LineItem}.
           Represents browser languages that are being targeted or excluded by the {@link LineItem}.
           • isTargeted - optional; type boolean
             Indicates whether browsers languages should be targeted or excluded. This attribute is optional and defaults to {@code true}.
           • browserLanguages - optional, unbounded; type Technology
             Browser languages that are being targeted or excluded by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
         • deviceCapabilityTargeting - optional; type DeviceCapabilityTargeting
           The device capabilities being targeted by the {@link LineItem}.
           Represents device capabilities that are being targeted or excluded by the {@link LineItem}.
           • targetedDeviceCapabilities - optional, unbounded; type Technology
             Device capabilities that are being targeted by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
           • excludedDeviceCapabilities - optional, unbounded; type Technology
             Device capabilities that are being excluded by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
         • deviceCategoryTargeting - optional; type DeviceCategoryTargeting
           The device categories being targeted by the {@link LineItem}.
           Represents device categories that are being targeted or excluded by the {@link LineItem}.
           • targetedDeviceCategories - optional, unbounded; type Technology
             Device categories that are being targeted by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
           • excludedDeviceCategories - optional, unbounded; type Technology
             Device categories that are being excluded by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
         • deviceManufacturerTargeting - optional; type DeviceManufacturerTargeting
           The device manufacturers being targeted by the {@link LineItem}.
           Represents device manufacturer that are being targeted or excluded by the {@link LineItem}.
           • isTargeted - optional; type boolean
             Indicates whether device manufacturers should be targeted or excluded. This attribute is optional and defaults to {@code true}.
           • deviceManufacturers - optional, unbounded; type Technology
             Device manufacturers that are being targeted or excluded by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
         • mobileCarrierTargeting - optional; type MobileCarrierTargeting
           The mobile carriers being targeted by the {@link LineItem}.
           Represents mobile carriers that are being targeted or excluded by the {@link LineItem}.
           • isTargeted - optional; type boolean
             Indicates whether mobile carriers should be targeted or excluded. This attribute is optional and defaults to {@code true}.
           • mobileCarriers - optional, unbounded; type Technology
             Mobile carriers that are being targeted or excluded by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
         • mobileDeviceTargeting - optional; type MobileDeviceTargeting
           The mobile devices being targeted by the {@link LineItem}.
           Represents mobile devices that are being targeted or excluded by the {@link LineItem}.
           • targetedMobileDevices - optional, unbounded; type Technology
             Mobile devices that are being targeted by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
           • excludedMobileDevices - optional, unbounded; type Technology
             Mobile devices that are being excluded by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
         • mobileDeviceSubmodelTargeting - optional; type MobileDeviceSubmodelTargeting
           The mobile device submodels being targeted by the {@link LineItem}.
           Represents mobile devices that are being targeted or excluded by the {@link LineItem}.
           • targetedMobileDeviceSubmodels - optional, unbounded; type Technology
             Mobile device submodels that are being targeted by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
           • excludedMobileDeviceSubmodels - optional, unbounded; type Technology
             Mobile device submodels that are being excluded by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
         • operatingSystemTargeting - optional; type OperatingSystemTargeting
           The operating systems being targeted by the {@link LineItem}.
           Represents operating systems that are being targeted or excluded by the {@link LineItem}.
           • isTargeted - optional; type boolean
             Indicates whether operating systems should be targeted or excluded. This attribute is optional and defaults to {@code true}.
           • operatingSystems - optional, unbounded; type Technology
             Operating systems that are being targeted or excluded by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
         • operatingSystemVersionTargeting - optional; type OperatingSystemVersionTargeting
           The operating system versions being targeted by the {@link LineItem}.
           Represents operating system versions that are being targeted or excluded by the {@link LineItem}.
           • targetedOperatingSystemVersions - optional, unbounded; type Technology
             Operating system versions that are being targeted by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
           • excludedOperatingSystemVersions - optional, unbounded; type Technology
             Operating system versions that are being excluded by the {@link LineItem}.
             Represents a technology entity that can be targeted.
             • id - optional; type long
               The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}.
             • name - optional; type string
               The name of the technology being targeting. This value is read-only and is assigned by Google.
         Specifies the browsing technologies that are targeted by the {@link LineItem}. This attribute is optional.
       • customTargeting - optional; type CustomCriteriaSet - extension of abstract type CustomCriteriaNode
         A {@link CustomCriteriaSet} comprises of a set of {@link CustomCriteriaNode} objects combined by the {@link CustomCriteriaSet.LogicalOperator#logicalOperator}. The custom criteria targeting tree is subject to the rules defined on {@link Targeting#customTargeting}.
         A {@link CustomCriteriaNode} is a node in the custom targeting tree. A custom criteria node can either be a {@link CustomCriteriaSet} (a non-leaf node) or a {@link CustomCriteria} (a leaf node). The custom criteria targeting tree is subject to the rules defined on {@link Targeting#customTargeting}.
         • logicalOperator - optional; type CustomCriteriaSet.LogicalOperator - type string with restriction - enum { 'AND', 'OR' }
           The logical operator to be applied to {@link CustomCriteriaSet#children}. This attribute is required. This attribute is required.
         • children - optional, unbounded; type CustomCriteriaNode
           The custom criteria. This attribute is required.
           A {@link CustomCriteriaNode} is a node in the custom targeting tree. A custom criteria node can either be a {@link CustomCriteriaSet} (a non-leaf node) or a {@link CustomCriteria} (a leaf node). The custom criteria targeting tree is subject to the rules defined on {@link Targeting#customTargeting}.
           Specifies the collection of custom criteria that is targeted by the {@link LineItem}.

           Once the {@link LineItem} is updated or modified with custom targeting, the server may return a normalized, but equivalent representation of the custom targeting expression.

           {@code customTargeting} will have up to three levels of expressions including itself.

           The top level {@code CustomCriteriaSet} i.e. the {@code customTargeting} object can only contain a {@link CustomCriteriaSet.LogicalOperator#OR} of all its children.

           The second level of {@code CustomCriteriaSet} objects can only contain {@link CustomCriteriaSet.LogicalOperator#AND} of all their children. If a {@link CustomCriteria} is placed on this level, the server will wrap it in a {@link CustomCriteriaSet}.

           The third level can only comprise of {@link CustomCriteria} objects.

           The resulting custom targeting tree would be of the form:
           

         • userDomainTargeting - optional; type UserDomainTargeting
           Specifies the domains or subdomains that are targeted or excluded by the {@link LineItem}. Users visiting from an IP address associated with those domains will be targeted or excluded. This attribute is optional.
           Provides line items the ability to target or exclude users visiting their websites from a list of domains or subdomains.
           • domains - optional, unbounded; type string
             The domains or subdomains that are being targeted or excluded by the {@link LineItem}. This attribute is required and the maximum length of each domain is 67 characters.
           • targeted - optional; type boolean
             Indicates whether domains should be targeted or excluded. This attribute is optional and defaults to {@code true}.
         • contentTargeting - optional; type ContentTargeting
           Used to target {@link LineItem}s to specific videos on a publisher's site.
           • targetedContentIds - optional, unbounded; type long
             The IDs of content being targeted by the {@code LineItem}.
           • excludedContentIds - optional, unbounded; type long
             The IDs of content being excluded by the {@code LineItem}.
           • targetedVideoContentBundleIds - optional, unbounded; type long
             A list of video content bundles, represented by {@link ContentBundle} IDs, that are being targeted by the {@code LineItem}.
           • excludedVideoContentBundleIds - optional, unbounded; type long
             A list of video content bundles, represented by {@link ContentBundle} IDs, that are being excluded by the {@code LineItem}.
           Specifies the video categories and individual videos targeted by the {@link LineItem}.
         • videoPositionTargeting - optional; type VideoPositionTargeting
           Specifies targeting against video position types.
           Represents positions within and around a video where ads can be targeted to.

           Example positions could be {@code pre-roll} (before the video plays), {@code post-roll} (after a video has completed playback) and {@code mid-roll} (during video playback).

           Empty video position targeting means that all video positions are allowed. If a bumper line item has empty video position targeting it will be updated to target all bumper positions.

           • targetedPositions - optional, unbounded; type VideoPositionTarget
             The {@link VideoTargetingPosition} objects being targeted by the video {@link LineItem}.
             Represents the options for targetable positions within a video.
             • videoPosition - optional; type VideoPosition
               Represents a targetable position within a video. A video ad can be targeted to a position (pre-roll, all mid-rolls, or post-roll), or to a specific mid-roll index.
               • positionType - optional; type VideoPosition.Type - type string with restriction - enum { 'UNKNOWN', 'ALL', 'PREROLL', 'MIDROLL', 'POSTROLL' }
                 The type of video position (pre-roll, mid-roll, or post-roll).
               • midrollIndex - optional; type int
                 The index of the mid-roll to target. Only valid if the {@link positionType} is {@link VideoPositionType#MIDROLL}, otherwise this field will be ignored.
               The video position to target. This attribute is required.
             • videoBumperType - optional; type VideoBumperType - type string with restriction - enum { 'BEFORE', 'AFTER' }
               The video bumper type to target. To target a video position or a pod position, this value must be null. To target a bumper position this value must be populated and the line item must have a bumper type. To target a custom ad spot, this value must be null.
             • videoPositionWithinPod - optional; type VideoPositionWithinPod
               Represents a targetable position within a pod within a video stream. A video ad can be targeted to any position in the pod (first, second, third ... last). If there is only 1 ad in a pod, either first or last will target that position.
               • index - optional; type int
                 The specific index of the pod. The index is defined as:

                 • 1 = first
                 • 2 = second
                 • 3 = third
                 • ....
                 • 100 = last

                 100 will always be the last position. For example, for a pod with 5 positions, 100 would target position 5. Multiple targets against the index 100 can exist.
                 Positions over 100 are not supported.
               The video position within a pod to target. To target a video position or a bumper position, this value must be null. To target a position within a pod this value must be populated. To target a custom ad spot, this value must be null.
             • adSpotId - optional; type long
               A custom spot {@link AdSpot} to target. To target a video position, a bumper type or a video position within a pod this value must be null.
         • mobileApplicationTargeting - optional; type MobileApplicationTargeting
           Provides the ability to target or exclude users' mobile applications.
           • mobileApplicationIds - optional, unbounded; type long
             The {@link MobileApplication#id IDs} that are being targeted or excluded.
           • isTargeted - optional; type boolean
             Indicates whether mobile apps should be targeted or excluded. This attribute is optional and defaults to {@code true}.
           Specifies targeting against mobile applications.
         • buyerUserListTargeting - optional; type BuyerUserListTargeting
           The {@code BuyerUserListTargeting} associated with a programmatic {@link LineItem} or {@link ProposalLineItem} object.
           • hasBuyerUserListTargeting - optional; type boolean
             Whether the programmatic {@code LineItem} or {@code ProposalLineItem} object has buyer user list targeting.
           Specifies whether buyer user lists are targeted on a programmatic {@link LineItem} or {@link ProposalLineItem}. This attribute is readonly and is populated by Google.
         • inventoryUrlTargeting - optional; type InventoryUrlTargeting
           A collection of targeted inventory urls.
           • targetedUrls - optional, unbounded; type InventoryUrl
             The representation of an inventory Url that is used in targeting.
             • id - optional; type long
           • excludedUrls - optional, unbounded; type InventoryUrl
             The representation of an inventory Url that is used in targeting.
             • id - optional; type long
           Specifies the URLs that are targeted by the entity. This is currently only supported by {@link YieldGroup}.
         • verticalTargeting - optional; type VerticalTargeting
           Specifies the verticals that are targeted by the entity. The IDs listed here correspond to the IDs in the AD_CATEGORY table of type VERTICAL.
           Vertical targeting information.
           • targetedVerticalIds - optional, unbounded; type long
           • excludedVerticalIds - optional, unbounded; type long
         • contentLabelTargeting - optional; type ContentLabelTargeting
           Content label targeting information.
           • excludedContentLabelIds - optional, unbounded; type long
           Specifies the content labels that are excluded by the entity. The IDs listed here correspond to the IDs in the CONTENT_LABEL table.
         • requestPlatformTargeting - optional; type RequestPlatformTargeting
           Provides line items the ability to target the platform that requests and renders the ad.

           The following rules apply for {@link RequestPlatformTargeting}

           • {@link RequestPlatformTargeting} must be specified for {@link ProposalLineItem}s.
           • {@link RequestPlatformTargeting} must be specified for video line items. Empty values for {@link RequestPlatformTargeting#targetedRequestPlatforms} mean that all request platforms will be targeted.
           • {@link RequestPlatformTargeting} is read-only and assigned by Google for non-video line items.
           • {@link RequestPlatformTargeting} is read-only and assigned by Google for line items generated from proposal line items.
           • targetedRequestPlatforms - optional, unbounded; type RequestPlatform - type string with restriction - enum { 'UNKNOWN', 'BROWSER', 'MOBILE_APP', 'VIDEO_PLAYER' }
           Specifies the request platforms that are targeted by the {@link LineItem}. This attribute is required for video line items and for {@link ProposalLineItem}.

           This value is modifiable for video line items, but read-only for non-video line items.

           This value is read-only for video line items generated from proposal line items.

         • inventorySizeTargeting - optional; type InventorySizeTargeting
           Represents a collection of targeted and excluded inventory sizes. This is currently only available on {@link YieldGroup} and {@link TrafficDataRequest}.
           • isTargeted - optional; type boolean
             Whether the inventory sizes should be targeted or excluded.
           • targetedSizes - optional, unbounded; type TargetedSize
             A list of {@link TargetedSizeDto}s.
             A size that is targeted on a request.
             • size - optional; type Size
               Represents the dimensions of an {@link AdUnit}, {@link LineItem} or {@link Creative}.

               For interstitial size (out-of-page), native, ignored and fluid size, {@link Size} must be 1x1.

               • width - optional; type int
                 The width of the {@link AdUnit}, {@link LineItem} or {@link Creative}.
               • height - optional; type int
                 The height of the {@link AdUnit}, {@link LineItem} or {@link Creative}.
               • isAspectRatio - optional; type boolean
                 Whether this size represents an aspect ratio.
           Specifies the sizes that are targeted by the entity. This is currently only supported on {@link YieldGroup} and {@link TrafficDataRequest}.
         • customFieldValues - optional, unbounded; type BaseCustomFieldValue
           The value of a {@link CustomField} for a particular entity.
           • customFieldId - optional; type long
             Id of the {@code CustomField} to which this value belongs. This attribute is required.
           The values of the custom fields associated with the {@code ProposalLineItem}. This attribute is optional. This attribute can be configured as editable after the proposal has been submitted. Please check with your network administrator for editable fields configuration.
         • appliedLabels - optional, unbounded; type AppliedLabel
           Represents a {@link Label} that can be applied to an entity. To negate an inherited label, create an {@code AppliedLabel} with {@code labelId} as the inherited label's ID and {@code isNegated} set to true.
           • labelId - optional; type long
             The ID of a created {@link Label}.
           • isNegated - optional; type boolean
             {@code isNegated} should be set to {@code true} to negate the effects of {@code labelId}.
           The set of labels applied directly to the {@code ProposalLineItem}. This attribute is optional.
         • effectiveAppliedLabels - optional, unbounded; type AppliedLabel
           Represents a {@link Label} that can be applied to an entity. To negate an inherited label, create an {@code AppliedLabel} with {@code labelId} as the inherited label's ID and {@code isNegated} set to true.
           • labelId - optional; type long
             The ID of a created {@link Label}.
           • isNegated - optional; type boolean
             {@code isNegated} should be set to {@code true} to negate the effects of {@code labelId}.
           Contains the set of labels applied directly to the proposal as well as those inherited ones. If a label has been negated, only the negated label is returned. This attribute is read-only.
         • disableSameAdvertiserCompetitiveExclusion - optional; type 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 {@code true} will allow line items from the same advertiser to serve regardless of the other competitive exclusion labels being applied.

           This attribute is optional and defaults to false.

         • isSold - optional; type boolean
           Indicates whether this {@code ProposalLineItem} has been sold. This attribute is read-only.
         • netRate - optional; type Money
           Represents a money amount.
           • currencyCode - optional; type string
             Three letter currency code in string format.
           • microAmount - optional; type long
             Money values are always specified in terms of micros which are a millionth of the fundamental currency unit. For US dollars, $1 is 1,000,000 micros.
           The amount of money to spend per impression or click in proposal currency. It supports precision of 4 decimal places in terms of the fundamental currency unit, so the {@link Money#getAmountInMicros} must be multiples of 100. It doesn't include agency commission.

           For example, if {@link Proposal#currencyCode} is 'USD', then $123.4567 could be represented as 123456700, but further precision is not supported.

           The field {@link ProposalLineItem#netRate} is required, and used to calculate {@link ProposalLineItem#netCost} if unspecified.

         • netCost - optional; type Money
           Represents a money amount.
           • currencyCode - optional; type string
             Three letter currency code in string format.
           • microAmount - optional; type long
             Money values are always specified in terms of micros which are a millionth of the fundamental currency unit. For US dollars, $1 is 1,000,000 micros.
           The cost of the {@code ProposalLineItem} in proposal currency. It supports precision of 2 decimal places in terms of the fundamental currency unit, so the {@link Money#getAmountInMicros} must be multiples of 10000. It doesn't include agency commission.

           For example, if {@link Proposal#currencyCode} is 'USD', then $123.45 could be represented as 123450000, but further precision is not supported.

           The field {@link ProposalLineItem#netRate} is required, and used to calculate {@link ProposalLineItem#netCost} if unspecified.

         • deliveryIndicator - optional; type DeliveryIndicator
           Indicates the delivery performance of the {@link LineItem}.
           • expectedDeliveryPercentage - optional; type double
             How much the {@code LineItem} was expected to deliver as a percentage of {@link LineItem#primaryGoal}.
           • actualDeliveryPercentage - optional; type double
             How much the line item actually delivered as a percentage of {@link LineItem#primaryGoal}.
           Indicates how well the line item generated from this proposal line item has been performing. This will be {@code null} if the delivery indicator information is not available due to one of the following reasons:

           1. The proposal line item has not pushed to Ad Manager.
           2. The line item is not delivering.
           3. The line item has an unlimited goal or cap.
           4. The line item has a percentage based goal or cap.

           This attribute is read-only.
         • deliveryData - optional; type DeliveryData
           Holds the number of clicks or impressions, determined by {@link LineItem#costType}, delivered for a single line item for the last 7 days
           • units - optional, unbounded; type long
             Clicks or impressions delivered for the last 7 days.
           Delivery data provides the number of clicks or impressions delivered for the {@link LineItem} generated from this proposal line item in the last 7 days. This will be {@code null} if the delivery data cannot be computed due to one of the following reasons:

           1. The proposal line item has not pushed to Ad Manager.
           2. The line item is not deliverable.
           3. The line item has completed delivering more than 7 days ago.
           4. The line item has an absolute-based goal. {@link ProposalLineItem#deliveryIndicator} should be used to track its progress in this case. This attribute is read-only.
         • computedStatus - optional; type ComputedStatus - type string with restriction - enum { 'DELIVERY_EXTENDED', 'DELIVERING', 'READY', 'PAUSED', 'INACTIVE', 'PAUSED_INVENTORY_RELEASED', 'PENDING_APPROVAL', 'COMPLETED', 'DISAPPROVED', 'DRAFT', 'CANCELED' }
           The status of the {@link LineItem} generated from this proposal line item. This will be {@code null} if the proposal line item has not pushed to Ad Manager. This attribute is read-only.
         • lastModifiedDateTime - optional; type DateTime
           Represents a date combined with the time of day.
           • date - optional; type Date
             Represents a date.
             • year - optional; type int
               Year (e.g., 2009)
             • month - optional; type int
               Month (1..12)
             • day - optional; type int
               Day (1..31)
           • hour - optional; type int
           • minute - optional; type int
           • second - optional; type int
           • timeZoneId - optional; type string
           The date and time this {@code ProposalLineItem} was last modified.

           This attribute is assigned by Google when a {@code ProposalLineItem} is updated. This attribute is read-only.

         • reservationStatus - optional; type ReservationStatus - type string with restriction - enum { 'RESERVED', 'NOT_RESERVED', 'RELEASED', 'CHECK_LINE_ITEM_RESERVATION_STATUS', 'UNKNOWN' }
           The reservation status of the {@link ProposalLineItem}. This attribute is read-only.
         • lastReservationDateTime - optional; type DateTime
           Represents a date combined with the time of day.
           • date - optional; type Date
             Represents a date.
             • year - optional; type int
               Year (e.g., 2009)
             • month - optional; type int
               Month (1..12)
             • day - optional; type int
               Day (1..31)
           • hour - optional; type int
           • minute - optional; type int
           • second - optional; type int
           • timeZoneId - optional; type string
           The last {@link DateTime} when the {@link ProposalLineItem} reserved inventory. This attribute is read-only.
         • environmentType - optional; type EnvironmentType - type string with restriction - enum { 'BROWSER', 'VIDEO_PLAYER' }
           The environment that the {@code ProposalLineItem} is targeting. The default value is {@link EnvironmentType#BROWSER}. If this value is {@link EnvironmentType#VIDEO_PLAYER}, then this {@code ProposalLineItem} can only target {@link AdUnit ad units} that have {@link AdUnitSize sizes} whose {@link AdUnitSize#environmentType} is also {@link EnvironmentType#VIDEO_PLAYER}.

           This field is read-only and set to {@link Product#environmentType} of the product this proposal line item was created from.

         • allowedFormats - optional, unbounded; type AllowedFormats - type string with restriction - enum { 'AUDIO', 'UNKNOWN' }
           The set of {@link AllowedFormats} that this proposal line item can have. If the set is empty, this proposal line item allows all formats.
         • additionalTerms - optional; type string
           Additional terms shown to the buyer in Marketplace.
         • programmaticCreativeSource - optional; type ProgrammaticCreativeSource - type string with restriction - enum { 'PUBLISHER', 'ADVERTISER', 'UNKNOWN' }
           Indicates the {@link ProgrammaticCreativeSource} of the programmatic line item.
         • grpSettings - optional; type GrpSettings
           {@code GrpSettings} contains information for a line item that will have a target demographic when serving. This information will be used to set up tracking and enable reporting on the demographic information.
           • minTargetAge - optional; type long
             Specifies the minimum target age (in years) of the {@link LineItem}. This field is only applicable if {@link #provider} is not null.
           • maxTargetAge - optional; type long
             Specifies the maximum target age (in years) of the {@link LineItem}. This field is only applicable if {@link #provider} is not null.
           • targetGender - optional; type GrpTargetGender - type string with restriction - enum { 'UNKNOWN', 'MALE', 'FEMALE', 'BOTH' }
             Specifies the target gender of the {@link LineItem}. This field is only applicable if {@link #provider} is not null.
           • provider - optional; type GrpProvider - type string with restriction - enum { 'UNKNOWN', 'NIELSEN' }
             Specifies the GRP provider of the {@link LineItem}.
           • inTargetRatioEstimateMilliPercent - optional; type long
             Estimate for the in-target ratio given the line item's audience targeting. This field is only applicable if {@link #provider} is Nielsen, {@link LineItem#primaryGoal#unitType} is in-target impressions, and {@link LineItem#CostType} is in-target CPM. This field determines the in-target ratio to use for pacing Nielsen line items before Nielsen reporting data is available. Represented as a milli percent, so 55.7% becomes 55700.
           • nielsenCtvPacingType - optional; type NielsenCtvPacingType - type string with restriction - enum { 'UNKNOWN', 'NONE', 'COVIEW', 'STRICT_COVIEW' }
             Specifies which pacing computation to apply in pacing to impressions from connected devices. This field is required if {@code enableNielsenCoViewingSupport} is true.
           • pacingDeviceCategorizationType - optional; type PacingDeviceCategorizationType - type string with restriction - enum { 'UNKNOWN', 'GOOGLE', 'NIELSEN' }
             Specifies whether to use Google or Nielsen device breakdown in Nielsen Line Item auto pacing.
           • applyTrueCoview - optional; type boolean
             Specifies whether to apply true coviewing in Nielsen Line Item auto pacing. This field can only be true if NielsenCtvPacingType is not NONE.
           Contains the information for a proposal line item which has a target GRP demographic.
         • estimatedMinimumImpressions - optional; type long
           The estimated minimum impressions that should be delivered for a proposal line item.
         • thirdPartyMeasurementSettings - optional; type ThirdPartyMeasurementSettings
           Contains third party measurement settings for cross-sell Partners
           Contains third party auto-pixeling settings for cross-sell Partners.
           • viewabilityPartner - optional; type ThirdPartyViewabilityIntegrationPartner - type string with restriction - enum { 'NONE', 'MOAT', 'DOUBLE_VERIFY', 'INTEGRAL_AD_SCIENCE', 'COMSCORE', 'TELEMETRY', 'UNKNOWN' }
             A field to determine the type of ThirdPartyViewabilityIntegrationPartner. This field default is NONE.
           • viewabilityClientId - optional; type string
             The third party partner id for YouTube viewability verification.
           • viewabilityReportingId - optional; type string
             The reporting id that maps viewability partner data with a campaign (or a group of related campaigns) specific data.
           • publisherViewabilityPartner - optional; type ThirdPartyViewabilityIntegrationPartner - type string with restriction - enum { 'NONE', 'MOAT', 'DOUBLE_VERIFY', 'INTEGRAL_AD_SCIENCE', 'COMSCORE', 'TELEMETRY', 'UNKNOWN' }
             A field to determine the type of publisher's viewability partner. This field default is NONE.
           • publisherViewabilityClientId - optional; type string
             The third party partner id for YouTube viewability verification for publisher.
           • publisherViewabilityReportingId - optional; type string
             The reporting id that maps viewability partner data with a campaign (or a group of related campaigns) specific data for publisher.
           • brandLiftPartner - optional; type ThirdPartyBrandLiftIntegrationPartner - type string with restriction - enum { 'UNKNOWN', 'NONE', 'KANTAR_MILLWARD_BROWN', 'DYNATA', 'INTAGE', 'MACROMILL' }
             A field to determine the type of ThirdPartyBrandLiftIntegrationPartner. This field default is NONE.
           • brandLiftClientId - optional; type string
             The third party partner id for YouTube brand lift verification.
           • brandLiftReportingId - optional; type string
             The reporting id that maps brand lift partner data with a campaign (or a group of related campaigns) specific data.
           • reachPartner - optional; type ThirdPartyReachIntegrationPartner - type string with restriction - enum { 'NONE', 'COMSCORE', 'NIELSEN', 'KANTAR_MILLWARD_BROWN', 'VIDEO_RESEARCH', 'GEMIUS', 'VIDEO_AMP', 'ISPOT_TV', 'AUDIENCE_PROJECT', 'UNKNOWN' }
             A field to determine the type of advertiser's ThirdPartyReachIntegrationPartner. This field default is UNKNOWN.
           • reachClientId - optional; type string
             The third party partner id for YouTube reach verification for advertiser.
           • reachReportingId - optional; type string
             The reporting id that maps reach partner data with a campaign (or a group of related campaigns) specific data for advertiser.
           • publisherReachPartner - optional; type ThirdPartyReachIntegrationPartner - type string with restriction - enum { 'NONE', 'COMSCORE', 'NIELSEN', 'KANTAR_MILLWARD_BROWN', 'VIDEO_RESEARCH', 'GEMIUS', 'VIDEO_AMP', 'ISPOT_TV', 'AUDIENCE_PROJECT', 'UNKNOWN' }
             A field to determine the type of publisher's ThirdPartyReachIntegrationPartner. This field default is UNKNOWN.
           • publisherReachClientId - optional; type string
             The third party partner id for YouTube reach verification for publisher.
           • publisherReachReportingId - optional; type string
             The reporting id that maps reach partner data with a campaign (or a group of related campaigns) specific data for publisher.
         • makegoodInfo - optional; type ProposalLineItemMakegoodInfo
           Makegood info for this proposal line item. Immutable once created.

           Null if this proposal line item is not a makegood.

           Makegood info for a {@link ProposalLineItemDto}.
           • originalProposalLineItemId - optional; type long
             The ID of the original proposal line item on which this makegood is based. This attribute is read-only.
           • reason - optional; type string
             The publisher-provided reason why this makegood was initiated. This is free form text.

             The following predefined values can be used to render predefined options in the UI.

             UNDERDELIVERY: 'Impression underdelivery', SECONDARY_DELIVERY_TERMS: 'Did not meet secondary delivery terms ', PERFORMANCE: 'Performance issues',

         • hasMakegood - optional; type boolean
           Whether this proposal line item has an associated makegood. This attribute is read-only.
         • canCreateMakegood - optional; type boolean
           Whether a new makegood associated with this line item can be created. This attribute is read-only.
         • pauseRole - optional; type NegotiationRole - type string with restriction - enum { 'BUYER', 'SELLER', 'UNKNOWN' }
           The {@link NegotiationRole} that paused the proposal line item, i.e. {@link NegotiationRole#seller} or {@link NegotiationRole#buyer}, or {@code null} when the proposal is not paused. This attribute is read-only.
         • pauseReason - optional; type string
           The reason for pausing the {@link ProposalLineItem}, provided by the {@link pauseRole}. It is {@code null} when the {@link ProposalLineItem} is not paused. This attribute is read-only.
   Fault:
   ApiException (wsdlsoap:fault, use = literal)Source code
   ApiException type ApiExceptionFault

   Exception class for holding a list of service errors.

   Base class for exceptions.

   • message - optional; type string
     Error message.

   • errors - optional, unbounded; type ApiError
     The API error base class that provides details about an error that occurred while processing a service request.

     The OGNL field path is provided for parsers to identify the request data element that may have caused the error.

     • fieldPath - optional; type string
       The OGNL field path to identify cause of error.
     • fieldPathElements - optional, unbounded; type FieldPathElement
       A parsed copy of the field path. For example, the field path "operations[1].operand" corresponds to this list: {FieldPathElement(field = "operations", index = 1), FieldPathElement(field = "operand", index = null)}.
       A segment of a field path. Each dot in a field path defines a new segment.
       • field - optional; type string
         The name of a field in lower camelcase. (e.g. "biddingStrategy")
       • index - optional; type int
         For list fields, this is a 0-indexed position in the list. Null for non-list fields.
     • trigger - optional; type string
       The data that caused the error.
     • errorString - optional; type string
       A simple string representation of the error and reason.
     List of errors.

   A fault element of type ApiException.