Web Service: ProposalService

Port type ProposalServiceInterfaceSource code

1. createProposals
   Source code
   Description:
   Creates new {@link Proposal} objects.

   For each proposal, the following fields are required:

   • {@link Proposal#name}
   Operation type:
   Request-response. The endpoint receives a message, and sends a correlated message.
   Input:
   createProposalsRequest (wsdlsoap:header, use = literal, part = RequestHeader)Source code
   parameters type createProposals

   Creates new {@link Proposal} objects.

   For each proposal, the following fields are required:

   • {@link Proposal#name}

   • proposals - optional, unbounded; type Proposal
     A {@code Proposal} represents an agreement between an interactive advertising seller and a buyer that specifies the details of an advertising campaign.
     • id - optional; type long
       The unique ID of the {@code Proposal}. This attribute is read-only.
     • isProgrammatic - optional; type boolean
       Flag that specifies whether this {@code Proposal} is for programmatic deals. This value is default to {@code false}.
     • dfpOrderId - optional; type long
       The unique ID of corresponding {@link Order}. This will be {@code null} if the {@code Proposal} has not been pushed to Ad Manager. This attribute is read-only.
     • name - optional; type string
       The name of the {@code Proposal}. This value has a maximum length of 255 characters. This value is copied to {@link Order#name} when the proposal turns into an order. 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 order and line items associated with the {@code Proposal} are eligible to begin serving. This attribute is derived from the proposal line item of the proposal which has the earliest {@link ProposalLineItem#startDateTime}. This attribute will be null, if this proposal has no related line items, or none of its line items have a start time. This attribute is read-only.
     • 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 order and line items associated with the {@code Proposal} stop being served. This attribute is derived from the proposal line item of the proposal which has the latest {@link ProposalLineItem#endDateTime}. This attribute will be null, if this proposal has no related line items, or none of its line items have an end time. This attribute is read-only.
     • status - optional; type ProposalStatus - type string with restriction - enum { 'DRAFT', 'PENDING_APPROVAL', 'APPROVED', 'REJECTED', 'UNKNOWN' }
       The status of the {@code Proposal}. This attribute is read-only.
     • isArchived - optional; type boolean
       The archival status of the {@code Proposal}. This attribute is read-only.
     • advertiser - optional; type ProposalCompanyAssociation
       A {@code ProposalCompanyAssociation} represents a {@link Company} associated with the {@link Proposal} and a set of {@link Contact} objects belonging to the company.
       • companyId - optional; type long
         The unique ID of the {@link Company} associated with the {@link Proposal}. This attribute is required.
       • type - optional; type ProposalCompanyAssociationType - type string with restriction - enum { 'PRIMARY_AGENCY', 'BILLING_AGENCY', 'BRANDING_AGENCY', 'OTHER_AGENCY', 'ADVERTISER', 'UNKNOWN' }
         The association type of the {@link Company} and {@link Proposal}. This attribute is required.
       • contactIds - optional, unbounded; type long
         List of unique IDs for {@link Contact} objects of the {@link Company}.
       The advertiser, to which this {@code Proposal} belongs, and a set of {@link Contact} objects associated with the advertiser. The {@link ProposalCompanyAssociation#type} of this attribute should be {@link ProposalCompanyAssociationType#ADVERTISER}. This attribute is required when the proposal turns into an order, and its {@link ProposalCompanyAssociation#companyId} will be copied to {@link Order#advertiserId}. This attribute becomes readonly once the {@code Proposal} has been pushed.
     • agencies - optional, unbounded; type ProposalCompanyAssociation
       A {@code ProposalCompanyAssociation} represents a {@link Company} associated with the {@link Proposal} and a set of {@link Contact} objects belonging to the company.
       • companyId - optional; type long
         The unique ID of the {@link Company} associated with the {@link Proposal}. This attribute is required.
       • type - optional; type ProposalCompanyAssociationType - type string with restriction - enum { 'PRIMARY_AGENCY', 'BILLING_AGENCY', 'BRANDING_AGENCY', 'OTHER_AGENCY', 'ADVERTISER', 'UNKNOWN' }
         The association type of the {@link Company} and {@link Proposal}. This attribute is required.
       • contactIds - optional, unbounded; type long
         List of unique IDs for {@link Contact} objects of the {@link Company}.
       List of agencies and the set of {@link Contact} objects associated with each agency. This attribute is optional. A {@code Proposal} only has at most one {@link Company} with {@link ProposalCompanyAssociationType#PRIMARY_AGENCY} type, but a {@link Company} can appear more than once with different {@link ProposalCompanyAssociationType} values. If primary agency exists, its {@link ProposalCompanyAssociation#companyId} will be copied to {@link Order#agencyId} when the proposal turns into an order.
     • internalNotes - optional; type string
       Provides any additional notes that may annotate the {@code Proposal}. 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.
     • primarySalesperson - optional; type SalespersonSplit
       The primary salesperson who brokered the transaction with the {@link #advertiser}. This attribute is required when the proposal turns into an order. This attribute can be configured as editable after the proposal has been submitted. Please check with your network administrator for editable fields configuration.
       A {@code SalespersonSplit} represents a salesperson.
       • userId - optional; type long
         The unique ID of the {@link User} responsible for the sales of the {@link Proposal}. This attribute is required.
     • salesPlannerIds - optional, unbounded; type long
       List of unique IDs of {@link User} objects who are the sales planners of the {@code Proposal}. This attribute is optional. A proposal could have 8 sales planners at most. This attribute can be configured as editable after the proposal has been submitted. Please check with your network administrator for editable fields configuration.
     • primaryTraffickerId - optional; type long
       The unique ID of the {@link User} who is primary trafficker and is responsible for trafficking the {@code Proposal}. This attribute is required when the proposal turns into an order, and will be copied to {@link Order#primaryTraffickerId} . This attribute can be configured as editable after the proposal has been submitted. Please check with your network administrator for editable fields configuration.
     • sellerContactIds - optional, unbounded; type long
       {@link User users} who are the seller's contacts.
     • appliedTeamIds - optional, unbounded; type long
       The IDs of all teams that the {@code Proposal} is on directly. 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.
     • 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 Proposal}. 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 Proposal}. 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.
     • currencyCode - optional; type string
       The currency code of this {@code Proposal}. This attribute is optional and defaults to network's currency code.
     • isSold - optional; type boolean
       Indicates whether the proposal has been sold, i.e., corresponds to whether the status of an {@link Order} is {@link OrderStatus#APPROVED} or {@link OrderStatus#PAUSED}. 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 Proposal} was last modified. This attribute is read-only.
     • marketplaceInfo - optional; type ProposalMarketplaceInfo
       Marketplace info for a proposal with a corresponding order in Marketplace.
       • marketplaceId - optional; type string
         The marketplace ID of this proposal. This is a shared ID between Ad Manager and the buy-side platform. This value is null if the proposal has not been sent to the buyer. This attribute is read-only.
       • hasLocalVersionEdits - optional; type boolean
         Whether the non-free-editable fields of a {@link Proposal} are opened for edit. A proposal that is open for edit will not receive buyer updates from Marketplace. If the buyer updates the proposal while this is open for local editing, Google will set {@link #isNewVersionFromBuyer} to {@code true}. You will then need to call {@link DiscardProposalDrafts} to revert your edits to get the buyer's latest changes. This attribute is read-only.
       • negotiationStatus - optional; type NegotiationStatus - type string with restriction - enum { 'SELLER_INITIATED', 'BUYER_INITIATED', 'AWAITING_SELLER_REVIEW', 'AWAITING_BUYER_REVIEW', 'ONLY_SELLER_ACCEPTED', 'FINALIZED', 'CANCELLED', 'UNKNOWN' }
         The negotiation status of the {@link Proposal}. This attribute is read-only.
       • marketplaceComment - optional; type string
         The comment on the {@link Proposal} to be sent to the buyer.
       • isNewVersionFromBuyer - optional; type boolean
         Indicates that the buyer has made updates to the proposal on Marketplace. This attribute is only meaningful if the proposal is open for edit (i.e., {@link #hasLocalVersionEdits} is {@code true}) This attribute is read-only.
       • buyerAccountId - optional; type long
         The Authorized Buyers ID of the buyer that this {@code Proposal} is being negotiated with. This attribute is required.
       • partnerClientId - optional; type string
         The ID used to represent Display & Video 360 client buyer partner ID (if Display & Video 360) or Authorized Buyers client buyer account ID. This field is readonly and assigned by Google. This attribute is read-only.
       The marketplace info of this proposal if it has a corresponding order in Marketplace.
     • buyerRfp - optional; type BuyerRfp
       Represents the buyer RFP information associated with a {@link Proposal} describing the requirements from the buyer.
       • costPerUnit - optional; type Money
         CPM for the {@link Proposal} in question. Given that this field belongs to a request for proposal (for which initially a {@link Proposal} does not yet exist), this field should serve as guidance for publishers to create a {@link Proposal} with {@link LineItem}s reflecting this CPM. This attribute is read-only.
         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.
       • units - optional; type long
         The number of impressions per day that a buyer wishes to see in the {@link Proposal} derived from the request for proposal in question. This attribute is read-only.
       • budget - optional; type Money
         Total amount of {@link Money} available to spend on this deal. In the case of Preferred Deal, the budget is equal to the maximum amount of money a buyer is willing to spend on a given {@link Proposal}, even though the budget might not be spent entirely, as impressions are not guaranteed. This attribute is read-only.
         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.
       • currencyCode - optional; type string
         Currency code for this deal's budget and CPM. This attribute is read-only.
       • startDateTime - optional; type DateTime
         The {@link DateTime} in which the proposed deal should start serving. This attribute is read-only.
         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
       • endDateTime - optional; type DateTime
         The {@link DateTime} in which the proposed deal should end serving. This attribute is read-only.
         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
       • description - optional; type string
         A description of the proposed deal. This can be used for the buyer to tell the publisher more detailed information about the deal in question. This attribute is read-only.
       • creativePlaceholders - optional, unbounded; type CreativePlaceholder
         A list of inventory sizes in which creatives will be eventually served. This attribute is read-only.
         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.

       • targeting - optional; type Targeting
         Targeting information for the proposal in question. Currently this field only contains {@link GeoTargeting} information. This attribute is read-only.
         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}.
           • additionalTerms - optional; type string
             Additional terms of the deal in question. This field can be used to state more specific targeting information for the deal, as well as any additional information regarding this deal. Given that this field belongs to a request for proposal (for which initially a {@link Proposal} does not yet exist), this field can be populated by buyers to specify additional information that they wish publishers to incorporate into the {@link Proposal} derived from this request for proposal. This attribute is read-only.
           • adExchangeEnvironment - optional; type AdExchangeEnvironment - type string with restriction - enum { 'DISPLAY', 'VIDEO', 'GAMES', 'MOBILE', 'MOBILE_OUTSTREAM_VIDEO', 'DISPLAY_OUTSTREAM_VIDEO', 'UNKNOWN' }
             Identifies the format of the inventory or "channel" through which the ad serves. Environments currently supported include {@link AdExchangeEnvironment#DISPLAY}, {@link AdExchangeEnvironment#VIDEO}, and {@link AdExchangeEnvironment#MOBILE}. This attribute is read-only.
           • rfpType - optional; type RfpType - type string with restriction - enum { 'UNKNOWN', 'PROGRAMMATIC_GUARANTEED', 'PREFERRED_DEAL' }
             Deal type; either Programmatic Guaranteed or Preferred Deal. This field corresponds to the type of {@link Proposal} that a buyer wishes to negotiate with a seller. This attribute is read-only.
           The buyer RFP associated with this {@code Proposal}, which is optional. This field will be null if the proposal is not initiated from RFP.
         • hasBuyerRfp - optional; type boolean
           Whether a {@link Proposal} contains a {@link BuyerRfp} field. If this field is true, it indicates that the {@link Proposal} in question orignated from a buyer.
         • deliveryPausingEnabled - optional; type boolean
           Whether pausing is consented for the {@code Proposal}. This field is optional and defaults to true. If false, it indicates that the buyer and the seller agree that the proposal should not be paused.
   Output:
   createProposalsResponse (wsdlsoap:header, use = literal, part = ResponseHeader)Source code
   parameters type createProposalsResponse

   • rval - optional, unbounded; type Proposal
     A {@code Proposal} represents an agreement between an interactive advertising seller and a buyer that specifies the details of an advertising campaign.
     • id - optional; type long
       The unique ID of the {@code Proposal}. This attribute is read-only.
     • isProgrammatic - optional; type boolean
       Flag that specifies whether this {@code Proposal} is for programmatic deals. This value is default to {@code false}.
     • dfpOrderId - optional; type long
       The unique ID of corresponding {@link Order}. This will be {@code null} if the {@code Proposal} has not been pushed to Ad Manager. This attribute is read-only.
     • name - optional; type string
       The name of the {@code Proposal}. This value has a maximum length of 255 characters. This value is copied to {@link Order#name} when the proposal turns into an order. 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 order and line items associated with the {@code Proposal} are eligible to begin serving. This attribute is derived from the proposal line item of the proposal which has the earliest {@link ProposalLineItem#startDateTime}. This attribute will be null, if this proposal has no related line items, or none of its line items have a start time. This attribute is read-only.
     • 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 order and line items associated with the {@code Proposal} stop being served. This attribute is derived from the proposal line item of the proposal which has the latest {@link ProposalLineItem#endDateTime}. This attribute will be null, if this proposal has no related line items, or none of its line items have an end time. This attribute is read-only.
     • status - optional; type ProposalStatus - type string with restriction - enum { 'DRAFT', 'PENDING_APPROVAL', 'APPROVED', 'REJECTED', 'UNKNOWN' }
       The status of the {@code Proposal}. This attribute is read-only.
     • isArchived - optional; type boolean
       The archival status of the {@code Proposal}. This attribute is read-only.
     • advertiser - optional; type ProposalCompanyAssociation
       A {@code ProposalCompanyAssociation} represents a {@link Company} associated with the {@link Proposal} and a set of {@link Contact} objects belonging to the company.
       • companyId - optional; type long
         The unique ID of the {@link Company} associated with the {@link Proposal}. This attribute is required.
       • type - optional; type ProposalCompanyAssociationType - type string with restriction - enum { 'PRIMARY_AGENCY', 'BILLING_AGENCY', 'BRANDING_AGENCY', 'OTHER_AGENCY', 'ADVERTISER', 'UNKNOWN' }
         The association type of the {@link Company} and {@link Proposal}. This attribute is required.
       • contactIds - optional, unbounded; type long
         List of unique IDs for {@link Contact} objects of the {@link Company}.
       The advertiser, to which this {@code Proposal} belongs, and a set of {@link Contact} objects associated with the advertiser. The {@link ProposalCompanyAssociation#type} of this attribute should be {@link ProposalCompanyAssociationType#ADVERTISER}. This attribute is required when the proposal turns into an order, and its {@link ProposalCompanyAssociation#companyId} will be copied to {@link Order#advertiserId}. This attribute becomes readonly once the {@code Proposal} has been pushed.
     • agencies - optional, unbounded; type ProposalCompanyAssociation
       A {@code ProposalCompanyAssociation} represents a {@link Company} associated with the {@link Proposal} and a set of {@link Contact} objects belonging to the company.
       • companyId - optional; type long
         The unique ID of the {@link Company} associated with the {@link Proposal}. This attribute is required.
       • type - optional; type ProposalCompanyAssociationType - type string with restriction - enum { 'PRIMARY_AGENCY', 'BILLING_AGENCY', 'BRANDING_AGENCY', 'OTHER_AGENCY', 'ADVERTISER', 'UNKNOWN' }
         The association type of the {@link Company} and {@link Proposal}. This attribute is required.
       • contactIds - optional, unbounded; type long
         List of unique IDs for {@link Contact} objects of the {@link Company}.
       List of agencies and the set of {@link Contact} objects associated with each agency. This attribute is optional. A {@code Proposal} only has at most one {@link Company} with {@link ProposalCompanyAssociationType#PRIMARY_AGENCY} type, but a {@link Company} can appear more than once with different {@link ProposalCompanyAssociationType} values. If primary agency exists, its {@link ProposalCompanyAssociation#companyId} will be copied to {@link Order#agencyId} when the proposal turns into an order.
     • internalNotes - optional; type string
       Provides any additional notes that may annotate the {@code Proposal}. 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.
     • primarySalesperson - optional; type SalespersonSplit
       The primary salesperson who brokered the transaction with the {@link #advertiser}. This attribute is required when the proposal turns into an order. This attribute can be configured as editable after the proposal has been submitted. Please check with your network administrator for editable fields configuration.
       A {@code SalespersonSplit} represents a salesperson.
       • userId - optional; type long
         The unique ID of the {@link User} responsible for the sales of the {@link Proposal}. This attribute is required.
     • salesPlannerIds - optional, unbounded; type long
       List of unique IDs of {@link User} objects who are the sales planners of the {@code Proposal}. This attribute is optional. A proposal could have 8 sales planners at most. This attribute can be configured as editable after the proposal has been submitted. Please check with your network administrator for editable fields configuration.
     • primaryTraffickerId - optional; type long
       The unique ID of the {@link User} who is primary trafficker and is responsible for trafficking the {@code Proposal}. This attribute is required when the proposal turns into an order, and will be copied to {@link Order#primaryTraffickerId} . This attribute can be configured as editable after the proposal has been submitted. Please check with your network administrator for editable fields configuration.
     • sellerContactIds - optional, unbounded; type long
       {@link User users} who are the seller's contacts.
     • appliedTeamIds - optional, unbounded; type long
       The IDs of all teams that the {@code Proposal} is on directly. 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.
     • 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 Proposal}. 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 Proposal}. 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.
     • currencyCode - optional; type string
       The currency code of this {@code Proposal}. This attribute is optional and defaults to network's currency code.
     • isSold - optional; type boolean
       Indicates whether the proposal has been sold, i.e., corresponds to whether the status of an {@link Order} is {@link OrderStatus#APPROVED} or {@link OrderStatus#PAUSED}. 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 Proposal} was last modified. This attribute is read-only.
     • marketplaceInfo - optional; type ProposalMarketplaceInfo
       Marketplace info for a proposal with a corresponding order in Marketplace.
       • marketplaceId - optional; type string
         The marketplace ID of this proposal. This is a shared ID between Ad Manager and the buy-side platform. This value is null if the proposal has not been sent to the buyer. This attribute is read-only.
       • hasLocalVersionEdits - optional; type boolean
         Whether the non-free-editable fields of a {@link Proposal} are opened for edit. A proposal that is open for edit will not receive buyer updates from Marketplace. If the buyer updates the proposal while this is open for local editing, Google will set {@link #isNewVersionFromBuyer} to {@code true}. You will then need to call {@link DiscardProposalDrafts} to revert your edits to get the buyer's latest changes. This attribute is read-only.
       • negotiationStatus - optional; type NegotiationStatus - type string with restriction - enum { 'SELLER_INITIATED', 'BUYER_INITIATED', 'AWAITING_SELLER_REVIEW', 'AWAITING_BUYER_REVIEW', 'ONLY_SELLER_ACCEPTED', 'FINALIZED', 'CANCELLED', 'UNKNOWN' }
         The negotiation status of the {@link Proposal}. This attribute is read-only.
       • marketplaceComment - optional; type string
         The comment on the {@link Proposal} to be sent to the buyer.
       • isNewVersionFromBuyer - optional; type boolean
         Indicates that the buyer has made updates to the proposal on Marketplace. This attribute is only meaningful if the proposal is open for edit (i.e., {@link #hasLocalVersionEdits} is {@code true}) This attribute is read-only.
       • buyerAccountId - optional; type long
         The Authorized Buyers ID of the buyer that this {@code Proposal} is being negotiated with. This attribute is required.
       • partnerClientId - optional; type string
         The ID used to represent Display & Video 360 client buyer partner ID (if Display & Video 360) or Authorized Buyers client buyer account ID. This field is readonly and assigned by Google. This attribute is read-only.
       The marketplace info of this proposal if it has a corresponding order in Marketplace.
     • buyerRfp - optional; type BuyerRfp
       Represents the buyer RFP information associated with a {@link Proposal} describing the requirements from the buyer.
       • costPerUnit - optional; type Money
         CPM for the {@link Proposal} in question. Given that this field belongs to a request for proposal (for which initially a {@link Proposal} does not yet exist), this field should serve as guidance for publishers to create a {@link Proposal} with {@link LineItem}s reflecting this CPM. This attribute is read-only.
         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.
       • units - optional; type long
         The number of impressions per day that a buyer wishes to see in the {@link Proposal} derived from the request for proposal in question. This attribute is read-only.
       • budget - optional; type Money
         Total amount of {@link Money} available to spend on this deal. In the case of Preferred Deal, the budget is equal to the maximum amount of money a buyer is willing to spend on a given {@link Proposal}, even though the budget might not be spent entirely, as impressions are not guaranteed. This attribute is read-only.
         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.
       • currencyCode - optional; type string
         Currency code for this deal's budget and CPM. This attribute is read-only.
       • startDateTime - optional; type DateTime
         The {@link DateTime} in which the proposed deal should start serving. This attribute is read-only.
         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
       • endDateTime - optional; type DateTime
         The {@link DateTime} in which the proposed deal should end serving. This attribute is read-only.
         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
       • description - optional; type string
         A description of the proposed deal. This can be used for the buyer to tell the publisher more detailed information about the deal in question. This attribute is read-only.
       • creativePlaceholders - optional, unbounded; type CreativePlaceholder
         A list of inventory sizes in which creatives will be eventually served. This attribute is read-only.
         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.

       • targeting - optional; type Targeting
         Targeting information for the proposal in question. Currently this field only contains {@link GeoTargeting} information. This attribute is read-only.
         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}.
           • additionalTerms - optional; type string
             Additional terms of the deal in question. This field can be used to state more specific targeting information for the deal, as well as any additional information regarding this deal. Given that this field belongs to a request for proposal (for which initially a {@link Proposal} does not yet exist), this field can be populated by buyers to specify additional information that they wish publishers to incorporate into the {@link Proposal} derived from this request for proposal. This attribute is read-only.
           • adExchangeEnvironment - optional; type AdExchangeEnvironment - type string with restriction - enum { 'DISPLAY', 'VIDEO', 'GAMES', 'MOBILE', 'MOBILE_OUTSTREAM_VIDEO', 'DISPLAY_OUTSTREAM_VIDEO', 'UNKNOWN' }
             Identifies the format of the inventory or "channel" through which the ad serves. Environments currently supported include {@link AdExchangeEnvironment#DISPLAY}, {@link AdExchangeEnvironment#VIDEO}, and {@link AdExchangeEnvironment#MOBILE}. This attribute is read-only.
           • rfpType - optional; type RfpType - type string with restriction - enum { 'UNKNOWN', 'PROGRAMMATIC_GUARANTEED', 'PREFERRED_DEAL' }
             Deal type; either Programmatic Guaranteed or Preferred Deal. This field corresponds to the type of {@link Proposal} that a buyer wishes to negotiate with a seller. This attribute is read-only.
           The buyer RFP associated with this {@code Proposal}, which is optional. This field will be null if the proposal is not initiated from RFP.
         • hasBuyerRfp - optional; type boolean
           Whether a {@link Proposal} contains a {@link BuyerRfp} field. If this field is true, it indicates that the {@link Proposal} in question orignated from a buyer.
         • deliveryPausingEnabled - optional; type boolean
           Whether pausing is consented for the {@code Proposal}. This field is optional and defaults to true. If false, it indicates that the buyer and the seller agree that the proposal should not be paused.
   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. getMarketplaceCommentsByStatement
   Source code
   Description:
   Gets a {@link MarketplaceCommentPage} of {@link MarketplaceComment} objects that satisfy the given {@link Statement#query}. This method only returns comments already sent to Marketplace, local draft {@link ProposalMarketplaceInfo#marketplaceComment} are not included. The following fields are supported for filtering:

   PQL Property	Object Property
   {@code proposalId}	{@link MarketplaceComment#proposalId}

   The query must specify a {@code proposalId}, and only supports a subset of PQL syntax:
   [WHERE {AND ...}]
[ORDER BY [ASC | DESC]]
[LIMIT {[,] } | { OFFSET }]
   

   
        := =
:= IN
   Only supports {@code ORDER BY} {@link MarketplaceComment#creationTime}.

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

   Gets a {@link MarketplaceCommentPage} of {@link MarketplaceComment} objects that satisfy the given {@link Statement#query}. This method only returns comments already sent to Marketplace, local draft {@link ProposalMarketplaceInfo#marketplaceComment} are not included. The following fields are supported for filtering:

   PQL Property	Object Property
   {@code proposalId}	{@link MarketplaceComment#proposalId}

   The query must specify a {@code proposalId}, and only supports a subset of PQL syntax:
   [WHERE {AND ...}]
[ORDER BY [ASC | DESC]]
[LIMIT {[,] } | { OFFSET }]
   

   
        := =
:= IN
   Only supports {@code ORDER BY} {@link MarketplaceComment#creationTime}.

   • 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:
   getMarketplaceCommentsByStatementResponse (wsdlsoap:header, use = literal, part = ResponseHeader)Source code
   parameters type getMarketplaceCommentsByStatementResponse

   • rval - optional; type MarketplaceCommentPage
     Captures a page of {@link MarketplaceComment} objects.
     • startIndex - optional; type int
       The absolute index in the total result set on which this page begins.
     • results - optional, unbounded; type MarketplaceComment
       A comment associated with a programmatic {@link Proposal} that has been sent to Marketplace.
       • proposalId - optional; type long
         The unique ID of the {@link Proposal} the comment belongs to.
       • comment - optional; type string
         The comment made on the {@link Proposal}.
       • creationTime - 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 creation {@link DateTime} of this {@code MarketplaceComment}.
       • createdBySeller - optional; type boolean
         Indicates whether the {@code MarketplaceComment} was created by seller.
       The collection of results contained within this page.
   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. getProposalsByStatement
   Source code
   Description:
   Gets a {@link ProposalPage} of {@link Proposal} objects that satisfy the given {@link Statement#query}. The following fields are supported for filtering:

   PQL Property	Object Property
   {@code id}	{@link Proposal#id}
   {@code dfpOrderId}	{@link Proposal#dfpOrderId}
   {@code name}	{@link Proposal#name}
   {@code status}	{@link Proposal#status}
   {@code isArchived}	{@link Proposal#isArchived}
   {@code approvalStatus} Only applicable for proposals using sales management	{@link Proposal#approvalStatus}
   {@code lastModifiedDateTime}	{@link Proposal#lastModifiedDateTime}
   {@code isProgrammatic}	{@link Proposal#isProgrammatic}
   {@code negotiationStatus} Only applicable for programmatic proposals	{@link ProposalMarketplaceInfo#negotiationStatus}

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

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

   PQL Property	Object Property
   {@code id}	{@link Proposal#id}
   {@code dfpOrderId}	{@link Proposal#dfpOrderId}
   {@code name}	{@link Proposal#name}
   {@code status}	{@link Proposal#status}
   {@code isArchived}	{@link Proposal#isArchived}
   {@code approvalStatus} Only applicable for proposals using sales management	{@link Proposal#approvalStatus}
   {@code lastModifiedDateTime}	{@link Proposal#lastModifiedDateTime}
   {@code isProgrammatic}	{@link Proposal#isProgrammatic}
   {@code negotiationStatus} Only applicable for programmatic proposals	{@link ProposalMarketplaceInfo#negotiationStatus}

   • 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:
   getProposalsByStatementResponse (wsdlsoap:header, use = literal, part = ResponseHeader)Source code
   parameters type getProposalsByStatementResponse

   • rval - optional; type ProposalPage
     Captures a page of {@link Proposal} objects.
     • totalResultSetSize - optional; type int
       The size of the total result set to which this page belongs.
     • startIndex - optional; type int
       The absolute index in the total result set on which this page begins.
     • results - optional, unbounded; type Proposal
       A {@code Proposal} represents an agreement between an interactive advertising seller and a buyer that specifies the details of an advertising campaign.
       • id - optional; type long
         The unique ID of the {@code Proposal}. This attribute is read-only.
       • isProgrammatic - optional; type boolean
         Flag that specifies whether this {@code Proposal} is for programmatic deals. This value is default to {@code false}.
       • dfpOrderId - optional; type long
         The unique ID of corresponding {@link Order}. This will be {@code null} if the {@code Proposal} has not been pushed to Ad Manager. This attribute is read-only.
       • name - optional; type string
         The name of the {@code Proposal}. This value has a maximum length of 255 characters. This value is copied to {@link Order#name} when the proposal turns into an order. 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 order and line items associated with the {@code Proposal} are eligible to begin serving. This attribute is derived from the proposal line item of the proposal which has the earliest {@link ProposalLineItem#startDateTime}. This attribute will be null, if this proposal has no related line items, or none of its line items have a start time. This attribute is read-only.
       • 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 order and line items associated with the {@code Proposal} stop being served. This attribute is derived from the proposal line item of the proposal which has the latest {@link ProposalLineItem#endDateTime}. This attribute will be null, if this proposal has no related line items, or none of its line items have an end time. This attribute is read-only.
       • status - optional; type ProposalStatus - type string with restriction - enum { 'DRAFT', 'PENDING_APPROVAL', 'APPROVED', 'REJECTED', 'UNKNOWN' }
         The status of the {@code Proposal}. This attribute is read-only.
       • isArchived - optional; type boolean
         The archival status of the {@code Proposal}. This attribute is read-only.
       • advertiser - optional; type ProposalCompanyAssociation
         A {@code ProposalCompanyAssociation} represents a {@link Company} associated with the {@link Proposal} and a set of {@link Contact} objects belonging to the company.
         • companyId - optional; type long
           The unique ID of the {@link Company} associated with the {@link Proposal}. This attribute is required.
         • type - optional; type ProposalCompanyAssociationType - type string with restriction - enum { 'PRIMARY_AGENCY', 'BILLING_AGENCY', 'BRANDING_AGENCY', 'OTHER_AGENCY', 'ADVERTISER', 'UNKNOWN' }
           The association type of the {@link Company} and {@link Proposal}. This attribute is required.
         • contactIds - optional, unbounded; type long
           List of unique IDs for {@link Contact} objects of the {@link Company}.
         The advertiser, to which this {@code Proposal} belongs, and a set of {@link Contact} objects associated with the advertiser. The {@link ProposalCompanyAssociation#type} of this attribute should be {@link ProposalCompanyAssociationType#ADVERTISER}. This attribute is required when the proposal turns into an order, and its {@link ProposalCompanyAssociation#companyId} will be copied to {@link Order#advertiserId}. This attribute becomes readonly once the {@code Proposal} has been pushed.
       • agencies - optional, unbounded; type ProposalCompanyAssociation
         A {@code ProposalCompanyAssociation} represents a {@link Company} associated with the {@link Proposal} and a set of {@link Contact} objects belonging to the company.
         • companyId - optional; type long
           The unique ID of the {@link Company} associated with the {@link Proposal}. This attribute is required.
         • type - optional; type ProposalCompanyAssociationType - type string with restriction - enum { 'PRIMARY_AGENCY', 'BILLING_AGENCY', 'BRANDING_AGENCY', 'OTHER_AGENCY', 'ADVERTISER', 'UNKNOWN' }
           The association type of the {@link Company} and {@link Proposal}. This attribute is required.
         • contactIds - optional, unbounded; type long
           List of unique IDs for {@link Contact} objects of the {@link Company}.
         List of agencies and the set of {@link Contact} objects associated with each agency. This attribute is optional. A {@code Proposal} only has at most one {@link Company} with {@link ProposalCompanyAssociationType#PRIMARY_AGENCY} type, but a {@link Company} can appear more than once with different {@link ProposalCompanyAssociationType} values. If primary agency exists, its {@link ProposalCompanyAssociation#companyId} will be copied to {@link Order#agencyId} when the proposal turns into an order.
       • internalNotes - optional; type string
         Provides any additional notes that may annotate the {@code Proposal}. 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.
       • primarySalesperson - optional; type SalespersonSplit
         The primary salesperson who brokered the transaction with the {@link #advertiser}. This attribute is required when the proposal turns into an order. This attribute can be configured as editable after the proposal has been submitted. Please check with your network administrator for editable fields configuration.
         A {@code SalespersonSplit} represents a salesperson.
         • userId - optional; type long
           The unique ID of the {@link User} responsible for the sales of the {@link Proposal}. This attribute is required.
       • salesPlannerIds - optional, unbounded; type long
         List of unique IDs of {@link User} objects who are the sales planners of the {@code Proposal}. This attribute is optional. A proposal could have 8 sales planners at most. This attribute can be configured as editable after the proposal has been submitted. Please check with your network administrator for editable fields configuration.
       • primaryTraffickerId - optional; type long
         The unique ID of the {@link User} who is primary trafficker and is responsible for trafficking the {@code Proposal}. This attribute is required when the proposal turns into an order, and will be copied to {@link Order#primaryTraffickerId} . This attribute can be configured as editable after the proposal has been submitted. Please check with your network administrator for editable fields configuration.
       • sellerContactIds - optional, unbounded; type long
         {@link User users} who are the seller's contacts.
       • appliedTeamIds - optional, unbounded; type long
         The IDs of all teams that the {@code Proposal} is on directly. 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.
       • 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 Proposal}. 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 Proposal}. 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.
       • currencyCode - optional; type string
         The currency code of this {@code Proposal}. This attribute is optional and defaults to network's currency code.
       • isSold - optional; type boolean
         Indicates whether the proposal has been sold, i.e., corresponds to whether the status of an {@link Order} is {@link OrderStatus#APPROVED} or {@link OrderStatus#PAUSED}. 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 Proposal} was last modified. This attribute is read-only.
       • marketplaceInfo - optional; type ProposalMarketplaceInfo
         Marketplace info for a proposal with a corresponding order in Marketplace.
         • marketplaceId - optional; type string
           The marketplace ID of this proposal. This is a shared ID between Ad Manager and the buy-side platform. This value is null if the proposal has not been sent to the buyer. This attribute is read-only.
         • hasLocalVersionEdits - optional; type boolean
           Whether the non-free-editable fields of a {@link Proposal} are opened for edit. A proposal that is open for edit will not receive buyer updates from Marketplace. If the buyer updates the proposal while this is open for local editing, Google will set {@link #isNewVersionFromBuyer} to {@code true}. You will then need to call {@link DiscardProposalDrafts} to revert your edits to get the buyer's latest changes. This attribute is read-only.
         • negotiationStatus - optional; type NegotiationStatus - type string with restriction - enum { 'SELLER_INITIATED', 'BUYER_INITIATED', 'AWAITING_SELLER_REVIEW', 'AWAITING_BUYER_REVIEW', 'ONLY_SELLER_ACCEPTED', 'FINALIZED', 'CANCELLED', 'UNKNOWN' }
           The negotiation status of the {@link Proposal}. This attribute is read-only.
         • marketplaceComment - optional; type string
           The comment on the {@link Proposal} to be sent to the buyer.
         • isNewVersionFromBuyer - optional; type boolean
           Indicates that the buyer has made updates to the proposal on Marketplace. This attribute is only meaningful if the proposal is open for edit (i.e., {@link #hasLocalVersionEdits} is {@code true}) This attribute is read-only.
         • buyerAccountId - optional; type long
           The Authorized Buyers ID of the buyer that this {@code Proposal} is being negotiated with. This attribute is required.
         • partnerClientId - optional; type string
           The ID used to represent Display & Video 360 client buyer partner ID (if Display & Video 360) or Authorized Buyers client buyer account ID. This field is readonly and assigned by Google. This attribute is read-only.
         The marketplace info of this proposal if it has a corresponding order in Marketplace.
       • buyerRfp - optional; type BuyerRfp
         Represents the buyer RFP information associated with a {@link Proposal} describing the requirements from the buyer.
         • costPerUnit - optional; type Money
           CPM for the {@link Proposal} in question. Given that this field belongs to a request for proposal (for which initially a {@link Proposal} does not yet exist), this field should serve as guidance for publishers to create a {@link Proposal} with {@link LineItem}s reflecting this CPM. This attribute is read-only.
           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.
         • units - optional; type long
           The number of impressions per day that a buyer wishes to see in the {@link Proposal} derived from the request for proposal in question. This attribute is read-only.
         • budget - optional; type Money
           Total amount of {@link Money} available to spend on this deal. In the case of Preferred Deal, the budget is equal to the maximum amount of money a buyer is willing to spend on a given {@link Proposal}, even though the budget might not be spent entirely, as impressions are not guaranteed. This attribute is read-only.
           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.
         • currencyCode - optional; type string
           Currency code for this deal's budget and CPM. This attribute is read-only.
         • startDateTime - optional; type DateTime
           The {@link DateTime} in which the proposed deal should start serving. This attribute is read-only.
           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
         • endDateTime - optional; type DateTime
           The {@link DateTime} in which the proposed deal should end serving. This attribute is read-only.
           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
         • description - optional; type string
           A description of the proposed deal. This can be used for the buyer to tell the publisher more detailed information about the deal in question. This attribute is read-only.
         • creativePlaceholders - optional, unbounded; type CreativePlaceholder
           A list of inventory sizes in which creatives will be eventually served. This attribute is read-only.
           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.

         • targeting - optional; type Targeting
           Targeting information for the proposal in question. Currently this field only contains {@link GeoTargeting} information. This attribute is read-only.
           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}.
             • additionalTerms - optional; type string
               Additional terms of the deal in question. This field can be used to state more specific targeting information for the deal, as well as any additional information regarding this deal. Given that this field belongs to a request for proposal (for which initially a {@link Proposal} does not yet exist), this field can be populated by buyers to specify additional information that they wish publishers to incorporate into the {@link Proposal} derived from this request for proposal. This attribute is read-only.
             • adExchangeEnvironment - optional; type AdExchangeEnvironment - type string with restriction - enum { 'DISPLAY', 'VIDEO', 'GAMES', 'MOBILE', 'MOBILE_OUTSTREAM_VIDEO', 'DISPLAY_OUTSTREAM_VIDEO', 'UNKNOWN' }
               Identifies the format of the inventory or "channel" through which the ad serves. Environments currently supported include {@link AdExchangeEnvironment#DISPLAY}, {@link AdExchangeEnvironment#VIDEO}, and {@link AdExchangeEnvironment#MOBILE}. This attribute is read-only.
             • rfpType - optional; type RfpType - type string with restriction - enum { 'UNKNOWN', 'PROGRAMMATIC_GUARANTEED', 'PREFERRED_DEAL' }
               Deal type; either Programmatic Guaranteed or Preferred Deal. This field corresponds to the type of {@link Proposal} that a buyer wishes to negotiate with a seller. This attribute is read-only.
             The buyer RFP associated with this {@code Proposal}, which is optional. This field will be null if the proposal is not initiated from RFP.
           • hasBuyerRfp - optional; type boolean
             Whether a {@link Proposal} contains a {@link BuyerRfp} field. If this field is true, it indicates that the {@link Proposal} in question orignated from a buyer.
           • deliveryPausingEnabled - optional; type boolean
             Whether pausing is consented for the {@code Proposal}. This field is optional and defaults to true. If false, it indicates that the buyer and the seller agree that the proposal should not be paused.
           The collection of proposals contained within this page.
   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. performProposalAction
   Source code
   Description:
   Performs actions on {@link Proposal} objects that match the given {@link Statement#query}.

   The following fields are also required when submitting proposals for approval:

   • {@link Proposal#advertiser}
   • {@link Proposal#primarySalesperson}
   • {@link Proposal#primaryTraffickerId}
   Operation type:
   Request-response. The endpoint receives a message, and sends a correlated message.
   Input:
   performProposalActionRequest (wsdlsoap:header, use = literal, part = RequestHeader)Source code
   parameters type performProposalAction

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

   The following fields are also required when submitting proposals for approval:

   • {@link Proposal#advertiser}
   • {@link Proposal#primarySalesperson}
   • {@link Proposal#primaryTraffickerId}

   • proposalAction - optional; type ProposalAction
     Represents the actions that can be performed on {@link Proposal} 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:
   performProposalActionResponse (wsdlsoap:header, use = literal, part = ResponseHeader)Source code
   parameters type performProposalActionResponse

   • 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. updateProposals
   Source code
   Description:
   Updates the specified {@link Proposal} objects.
   Operation type:
   Request-response. The endpoint receives a message, and sends a correlated message.
   Input:
   updateProposalsRequest (wsdlsoap:header, use = literal, part = RequestHeader)Source code
   parameters type updateProposals

   Updates the specified {@link Proposal} objects.

   • proposals - optional, unbounded; type Proposal
     A {@code Proposal} represents an agreement between an interactive advertising seller and a buyer that specifies the details of an advertising campaign.
     • id - optional; type long
       The unique ID of the {@code Proposal}. This attribute is read-only.
     • isProgrammatic - optional; type boolean
       Flag that specifies whether this {@code Proposal} is for programmatic deals. This value is default to {@code false}.
     • dfpOrderId - optional; type long
       The unique ID of corresponding {@link Order}. This will be {@code null} if the {@code Proposal} has not been pushed to Ad Manager. This attribute is read-only.
     • name - optional; type string
       The name of the {@code Proposal}. This value has a maximum length of 255 characters. This value is copied to {@link Order#name} when the proposal turns into an order. 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 order and line items associated with the {@code Proposal} are eligible to begin serving. This attribute is derived from the proposal line item of the proposal which has the earliest {@link ProposalLineItem#startDateTime}. This attribute will be null, if this proposal has no related line items, or none of its line items have a start time. This attribute is read-only.
     • 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 order and line items associated with the {@code Proposal} stop being served. This attribute is derived from the proposal line item of the proposal which has the latest {@link ProposalLineItem#endDateTime}. This attribute will be null, if this proposal has no related line items, or none of its line items have an end time. This attribute is read-only.
     • status - optional; type ProposalStatus - type string with restriction - enum { 'DRAFT', 'PENDING_APPROVAL', 'APPROVED', 'REJECTED', 'UNKNOWN' }
       The status of the {@code Proposal}. This attribute is read-only.
     • isArchived - optional; type boolean
       The archival status of the {@code Proposal}. This attribute is read-only.
     • advertiser - optional; type ProposalCompanyAssociation
       A {@code ProposalCompanyAssociation} represents a {@link Company} associated with the {@link Proposal} and a set of {@link Contact} objects belonging to the company.
       • companyId - optional; type long
         The unique ID of the {@link Company} associated with the {@link Proposal}. This attribute is required.
       • type - optional; type ProposalCompanyAssociationType - type string with restriction - enum { 'PRIMARY_AGENCY', 'BILLING_AGENCY', 'BRANDING_AGENCY', 'OTHER_AGENCY', 'ADVERTISER', 'UNKNOWN' }
         The association type of the {@link Company} and {@link Proposal}. This attribute is required.
       • contactIds - optional, unbounded; type long
         List of unique IDs for {@link Contact} objects of the {@link Company}.
       The advertiser, to which this {@code Proposal} belongs, and a set of {@link Contact} objects associated with the advertiser. The {@link ProposalCompanyAssociation#type} of this attribute should be {@link ProposalCompanyAssociationType#ADVERTISER}. This attribute is required when the proposal turns into an order, and its {@link ProposalCompanyAssociation#companyId} will be copied to {@link Order#advertiserId}. This attribute becomes readonly once the {@code Proposal} has been pushed.
     • agencies - optional, unbounded; type ProposalCompanyAssociation
       A {@code ProposalCompanyAssociation} represents a {@link Company} associated with the {@link Proposal} and a set of {@link Contact} objects belonging to the company.
       • companyId - optional; type long
         The unique ID of the {@link Company} associated with the {@link Proposal}. This attribute is required.
       • type - optional; type ProposalCompanyAssociationType - type string with restriction - enum { 'PRIMARY_AGENCY', 'BILLING_AGENCY', 'BRANDING_AGENCY', 'OTHER_AGENCY', 'ADVERTISER', 'UNKNOWN' }
         The association type of the {@link Company} and {@link Proposal}. This attribute is required.
       • contactIds - optional, unbounded; type long
         List of unique IDs for {@link Contact} objects of the {@link Company}.
       List of agencies and the set of {@link Contact} objects associated with each agency. This attribute is optional. A {@code Proposal} only has at most one {@link Company} with {@link ProposalCompanyAssociationType#PRIMARY_AGENCY} type, but a {@link Company} can appear more than once with different {@link ProposalCompanyAssociationType} values. If primary agency exists, its {@link ProposalCompanyAssociation#companyId} will be copied to {@link Order#agencyId} when the proposal turns into an order.
     • internalNotes - optional; type string
       Provides any additional notes that may annotate the {@code Proposal}. 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.
     • primarySalesperson - optional; type SalespersonSplit
       The primary salesperson who brokered the transaction with the {@link #advertiser}. This attribute is required when the proposal turns into an order. This attribute can be configured as editable after the proposal has been submitted. Please check with your network administrator for editable fields configuration.
       A {@code SalespersonSplit} represents a salesperson.
       • userId - optional; type long
         The unique ID of the {@link User} responsible for the sales of the {@link Proposal}. This attribute is required.
     • salesPlannerIds - optional, unbounded; type long
       List of unique IDs of {@link User} objects who are the sales planners of the {@code Proposal}. This attribute is optional. A proposal could have 8 sales planners at most. This attribute can be configured as editable after the proposal has been submitted. Please check with your network administrator for editable fields configuration.
     • primaryTraffickerId - optional; type long
       The unique ID of the {@link User} who is primary trafficker and is responsible for trafficking the {@code Proposal}. This attribute is required when the proposal turns into an order, and will be copied to {@link Order#primaryTraffickerId} . This attribute can be configured as editable after the proposal has been submitted. Please check with your network administrator for editable fields configuration.
     • sellerContactIds - optional, unbounded; type long
       {@link User users} who are the seller's contacts.
     • appliedTeamIds - optional, unbounded; type long
       The IDs of all teams that the {@code Proposal} is on directly. 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.
     • 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 Proposal}. 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 Proposal}. 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.
     • currencyCode - optional; type string
       The currency code of this {@code Proposal}. This attribute is optional and defaults to network's currency code.
     • isSold - optional; type boolean
       Indicates whether the proposal has been sold, i.e., corresponds to whether the status of an {@link Order} is {@link OrderStatus#APPROVED} or {@link OrderStatus#PAUSED}. 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 Proposal} was last modified. This attribute is read-only.
     • marketplaceInfo - optional; type ProposalMarketplaceInfo
       Marketplace info for a proposal with a corresponding order in Marketplace.
       • marketplaceId - optional; type string
         The marketplace ID of this proposal. This is a shared ID between Ad Manager and the buy-side platform. This value is null if the proposal has not been sent to the buyer. This attribute is read-only.
       • hasLocalVersionEdits - optional; type boolean
         Whether the non-free-editable fields of a {@link Proposal} are opened for edit. A proposal that is open for edit will not receive buyer updates from Marketplace. If the buyer updates the proposal while this is open for local editing, Google will set {@link #isNewVersionFromBuyer} to {@code true}. You will then need to call {@link DiscardProposalDrafts} to revert your edits to get the buyer's latest changes. This attribute is read-only.
       • negotiationStatus - optional; type NegotiationStatus - type string with restriction - enum { 'SELLER_INITIATED', 'BUYER_INITIATED', 'AWAITING_SELLER_REVIEW', 'AWAITING_BUYER_REVIEW', 'ONLY_SELLER_ACCEPTED', 'FINALIZED', 'CANCELLED', 'UNKNOWN' }
         The negotiation status of the {@link Proposal}. This attribute is read-only.
       • marketplaceComment - optional; type string
         The comment on the {@link Proposal} to be sent to the buyer.
       • isNewVersionFromBuyer - optional; type boolean
         Indicates that the buyer has made updates to the proposal on Marketplace. This attribute is only meaningful if the proposal is open for edit (i.e., {@link #hasLocalVersionEdits} is {@code true}) This attribute is read-only.
       • buyerAccountId - optional; type long
         The Authorized Buyers ID of the buyer that this {@code Proposal} is being negotiated with. This attribute is required.
       • partnerClientId - optional; type string
         The ID used to represent Display & Video 360 client buyer partner ID (if Display & Video 360) or Authorized Buyers client buyer account ID. This field is readonly and assigned by Google. This attribute is read-only.
       The marketplace info of this proposal if it has a corresponding order in Marketplace.
     • buyerRfp - optional; type BuyerRfp
       Represents the buyer RFP information associated with a {@link Proposal} describing the requirements from the buyer.
       • costPerUnit - optional; type Money
         CPM for the {@link Proposal} in question. Given that this field belongs to a request for proposal (for which initially a {@link Proposal} does not yet exist), this field should serve as guidance for publishers to create a {@link Proposal} with {@link LineItem}s reflecting this CPM. This attribute is read-only.
         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.
       • units - optional; type long
         The number of impressions per day that a buyer wishes to see in the {@link Proposal} derived from the request for proposal in question. This attribute is read-only.
       • budget - optional; type Money
         Total amount of {@link Money} available to spend on this deal. In the case of Preferred Deal, the budget is equal to the maximum amount of money a buyer is willing to spend on a given {@link Proposal}, even though the budget might not be spent entirely, as impressions are not guaranteed. This attribute is read-only.
         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.
       • currencyCode - optional; type string
         Currency code for this deal's budget and CPM. This attribute is read-only.
       • startDateTime - optional; type DateTime
         The {@link DateTime} in which the proposed deal should start serving. This attribute is read-only.
         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
       • endDateTime - optional; type DateTime
         The {@link DateTime} in which the proposed deal should end serving. This attribute is read-only.
         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
       • description - optional; type string
         A description of the proposed deal. This can be used for the buyer to tell the publisher more detailed information about the deal in question. This attribute is read-only.
       • creativePlaceholders - optional, unbounded; type CreativePlaceholder
         A list of inventory sizes in which creatives will be eventually served. This attribute is read-only.
         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.

       • targeting - optional; type Targeting
         Targeting information for the proposal in question. Currently this field only contains {@link GeoTargeting} information. This attribute is read-only.
         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}.
           • additionalTerms - optional; type string
             Additional terms of the deal in question. This field can be used to state more specific targeting information for the deal, as well as any additional information regarding this deal. Given that this field belongs to a request for proposal (for which initially a {@link Proposal} does not yet exist), this field can be populated by buyers to specify additional information that they wish publishers to incorporate into the {@link Proposal} derived from this request for proposal. This attribute is read-only.
           • adExchangeEnvironment - optional; type AdExchangeEnvironment - type string with restriction - enum { 'DISPLAY', 'VIDEO', 'GAMES', 'MOBILE', 'MOBILE_OUTSTREAM_VIDEO', 'DISPLAY_OUTSTREAM_VIDEO', 'UNKNOWN' }
             Identifies the format of the inventory or "channel" through which the ad serves. Environments currently supported include {@link AdExchangeEnvironment#DISPLAY}, {@link AdExchangeEnvironment#VIDEO}, and {@link AdExchangeEnvironment#MOBILE}. This attribute is read-only.
           • rfpType - optional; type RfpType - type string with restriction - enum { 'UNKNOWN', 'PROGRAMMATIC_GUARANTEED', 'PREFERRED_DEAL' }
             Deal type; either Programmatic Guaranteed or Preferred Deal. This field corresponds to the type of {@link Proposal} that a buyer wishes to negotiate with a seller. This attribute is read-only.
           The buyer RFP associated with this {@code Proposal}, which is optional. This field will be null if the proposal is not initiated from RFP.
         • hasBuyerRfp - optional; type boolean
           Whether a {@link Proposal} contains a {@link BuyerRfp} field. If this field is true, it indicates that the {@link Proposal} in question orignated from a buyer.
         • deliveryPausingEnabled - optional; type boolean
           Whether pausing is consented for the {@code Proposal}. This field is optional and defaults to true. If false, it indicates that the buyer and the seller agree that the proposal should not be paused.
   Output:
   updateProposalsResponse (wsdlsoap:header, use = literal, part = ResponseHeader)Source code
   parameters type updateProposalsResponse

   • rval - optional, unbounded; type Proposal
     A {@code Proposal} represents an agreement between an interactive advertising seller and a buyer that specifies the details of an advertising campaign.
     • id - optional; type long
       The unique ID of the {@code Proposal}. This attribute is read-only.
     • isProgrammatic - optional; type boolean
       Flag that specifies whether this {@code Proposal} is for programmatic deals. This value is default to {@code false}.
     • dfpOrderId - optional; type long
       The unique ID of corresponding {@link Order}. This will be {@code null} if the {@code Proposal} has not been pushed to Ad Manager. This attribute is read-only.
     • name - optional; type string
       The name of the {@code Proposal}. This value has a maximum length of 255 characters. This value is copied to {@link Order#name} when the proposal turns into an order. 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 order and line items associated with the {@code Proposal} are eligible to begin serving. This attribute is derived from the proposal line item of the proposal which has the earliest {@link ProposalLineItem#startDateTime}. This attribute will be null, if this proposal has no related line items, or none of its line items have a start time. This attribute is read-only.
     • 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 order and line items associated with the {@code Proposal} stop being served. This attribute is derived from the proposal line item of the proposal which has the latest {@link ProposalLineItem#endDateTime}. This attribute will be null, if this proposal has no related line items, or none of its line items have an end time. This attribute is read-only.
     • status - optional; type ProposalStatus - type string with restriction - enum { 'DRAFT', 'PENDING_APPROVAL', 'APPROVED', 'REJECTED', 'UNKNOWN' }
       The status of the {@code Proposal}. This attribute is read-only.
     • isArchived - optional; type boolean
       The archival status of the {@code Proposal}. This attribute is read-only.
     • advertiser - optional; type ProposalCompanyAssociation
       A {@code ProposalCompanyAssociation} represents a {@link Company} associated with the {@link Proposal} and a set of {@link Contact} objects belonging to the company.
       • companyId - optional; type long
         The unique ID of the {@link Company} associated with the {@link Proposal}. This attribute is required.
       • type - optional; type ProposalCompanyAssociationType - type string with restriction - enum { 'PRIMARY_AGENCY', 'BILLING_AGENCY', 'BRANDING_AGENCY', 'OTHER_AGENCY', 'ADVERTISER', 'UNKNOWN' }
         The association type of the {@link Company} and {@link Proposal}. This attribute is required.
       • contactIds - optional, unbounded; type long
         List of unique IDs for {@link Contact} objects of the {@link Company}.
       The advertiser, to which this {@code Proposal} belongs, and a set of {@link Contact} objects associated with the advertiser. The {@link ProposalCompanyAssociation#type} of this attribute should be {@link ProposalCompanyAssociationType#ADVERTISER}. This attribute is required when the proposal turns into an order, and its {@link ProposalCompanyAssociation#companyId} will be copied to {@link Order#advertiserId}. This attribute becomes readonly once the {@code Proposal} has been pushed.
     • agencies - optional, unbounded; type ProposalCompanyAssociation
       A {@code ProposalCompanyAssociation} represents a {@link Company} associated with the {@link Proposal} and a set of {@link Contact} objects belonging to the company.
       • companyId - optional; type long
         The unique ID of the {@link Company} associated with the {@link Proposal}. This attribute is required.
       • type - optional; type ProposalCompanyAssociationType - type string with restriction - enum { 'PRIMARY_AGENCY', 'BILLING_AGENCY', 'BRANDING_AGENCY', 'OTHER_AGENCY', 'ADVERTISER', 'UNKNOWN' }
         The association type of the {@link Company} and {@link Proposal}. This attribute is required.
       • contactIds - optional, unbounded; type long
         List of unique IDs for {@link Contact} objects of the {@link Company}.
       List of agencies and the set of {@link Contact} objects associated with each agency. This attribute is optional. A {@code Proposal} only has at most one {@link Company} with {@link ProposalCompanyAssociationType#PRIMARY_AGENCY} type, but a {@link Company} can appear more than once with different {@link ProposalCompanyAssociationType} values. If primary agency exists, its {@link ProposalCompanyAssociation#companyId} will be copied to {@link Order#agencyId} when the proposal turns into an order.
     • internalNotes - optional; type string
       Provides any additional notes that may annotate the {@code Proposal}. 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.
     • primarySalesperson - optional; type SalespersonSplit
       The primary salesperson who brokered the transaction with the {@link #advertiser}. This attribute is required when the proposal turns into an order. This attribute can be configured as editable after the proposal has been submitted. Please check with your network administrator for editable fields configuration.
       A {@code SalespersonSplit} represents a salesperson.
       • userId - optional; type long
         The unique ID of the {@link User} responsible for the sales of the {@link Proposal}. This attribute is required.
     • salesPlannerIds - optional, unbounded; type long
       List of unique IDs of {@link User} objects who are the sales planners of the {@code Proposal}. This attribute is optional. A proposal could have 8 sales planners at most. This attribute can be configured as editable after the proposal has been submitted. Please check with your network administrator for editable fields configuration.
     • primaryTraffickerId - optional; type long
       The unique ID of the {@link User} who is primary trafficker and is responsible for trafficking the {@code Proposal}. This attribute is required when the proposal turns into an order, and will be copied to {@link Order#primaryTraffickerId} . This attribute can be configured as editable after the proposal has been submitted. Please check with your network administrator for editable fields configuration.
     • sellerContactIds - optional, unbounded; type long
       {@link User users} who are the seller's contacts.
     • appliedTeamIds - optional, unbounded; type long
       The IDs of all teams that the {@code Proposal} is on directly. 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.
     • 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 Proposal}. 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 Proposal}. 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.
     • currencyCode - optional; type string
       The currency code of this {@code Proposal}. This attribute is optional and defaults to network's currency code.
     • isSold - optional; type boolean
       Indicates whether the proposal has been sold, i.e., corresponds to whether the status of an {@link Order} is {@link OrderStatus#APPROVED} or {@link OrderStatus#PAUSED}. 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 Proposal} was last modified. This attribute is read-only.
     • marketplaceInfo - optional; type ProposalMarketplaceInfo
       Marketplace info for a proposal with a corresponding order in Marketplace.
       • marketplaceId - optional; type string
         The marketplace ID of this proposal. This is a shared ID between Ad Manager and the buy-side platform. This value is null if the proposal has not been sent to the buyer. This attribute is read-only.
       • hasLocalVersionEdits - optional; type boolean
         Whether the non-free-editable fields of a {@link Proposal} are opened for edit. A proposal that is open for edit will not receive buyer updates from Marketplace. If the buyer updates the proposal while this is open for local editing, Google will set {@link #isNewVersionFromBuyer} to {@code true}. You will then need to call {@link DiscardProposalDrafts} to revert your edits to get the buyer's latest changes. This attribute is read-only.
       • negotiationStatus - optional; type NegotiationStatus - type string with restriction - enum { 'SELLER_INITIATED', 'BUYER_INITIATED', 'AWAITING_SELLER_REVIEW', 'AWAITING_BUYER_REVIEW', 'ONLY_SELLER_ACCEPTED', 'FINALIZED', 'CANCELLED', 'UNKNOWN' }
         The negotiation status of the {@link Proposal}. This attribute is read-only.
       • marketplaceComment - optional; type string
         The comment on the {@link Proposal} to be sent to the buyer.
       • isNewVersionFromBuyer - optional; type boolean
         Indicates that the buyer has made updates to the proposal on Marketplace. This attribute is only meaningful if the proposal is open for edit (i.e., {@link #hasLocalVersionEdits} is {@code true}) This attribute is read-only.
       • buyerAccountId - optional; type long
         The Authorized Buyers ID of the buyer that this {@code Proposal} is being negotiated with. This attribute is required.
       • partnerClientId - optional; type string
         The ID used to represent Display & Video 360 client buyer partner ID (if Display & Video 360) or Authorized Buyers client buyer account ID. This field is readonly and assigned by Google. This attribute is read-only.
       The marketplace info of this proposal if it has a corresponding order in Marketplace.
     • buyerRfp - optional; type BuyerRfp
       Represents the buyer RFP information associated with a {@link Proposal} describing the requirements from the buyer.
       • costPerUnit - optional; type Money
         CPM for the {@link Proposal} in question. Given that this field belongs to a request for proposal (for which initially a {@link Proposal} does not yet exist), this field should serve as guidance for publishers to create a {@link Proposal} with {@link LineItem}s reflecting this CPM. This attribute is read-only.
         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.
       • units - optional; type long
         The number of impressions per day that a buyer wishes to see in the {@link Proposal} derived from the request for proposal in question. This attribute is read-only.
       • budget - optional; type Money
         Total amount of {@link Money} available to spend on this deal. In the case of Preferred Deal, the budget is equal to the maximum amount of money a buyer is willing to spend on a given {@link Proposal}, even though the budget might not be spent entirely, as impressions are not guaranteed. This attribute is read-only.
         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.
       • currencyCode - optional; type string
         Currency code for this deal's budget and CPM. This attribute is read-only.
       • startDateTime - optional; type DateTime
         The {@link DateTime} in which the proposed deal should start serving. This attribute is read-only.
         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
       • endDateTime - optional; type DateTime
         The {@link DateTime} in which the proposed deal should end serving. This attribute is read-only.
         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
       • description - optional; type string
         A description of the proposed deal. This can be used for the buyer to tell the publisher more detailed information about the deal in question. This attribute is read-only.
       • creativePlaceholders - optional, unbounded; type CreativePlaceholder
         A list of inventory sizes in which creatives will be eventually served. This attribute is read-only.
         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.

       • targeting - optional; type Targeting
         Targeting information for the proposal in question. Currently this field only contains {@link GeoTargeting} information. This attribute is read-only.
         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}.
           • additionalTerms - optional; type string
             Additional terms of the deal in question. This field can be used to state more specific targeting information for the deal, as well as any additional information regarding this deal. Given that this field belongs to a request for proposal (for which initially a {@link Proposal} does not yet exist), this field can be populated by buyers to specify additional information that they wish publishers to incorporate into the {@link Proposal} derived from this request for proposal. This attribute is read-only.
           • adExchangeEnvironment - optional; type AdExchangeEnvironment - type string with restriction - enum { 'DISPLAY', 'VIDEO', 'GAMES', 'MOBILE', 'MOBILE_OUTSTREAM_VIDEO', 'DISPLAY_OUTSTREAM_VIDEO', 'UNKNOWN' }
             Identifies the format of the inventory or "channel" through which the ad serves. Environments currently supported include {@link AdExchangeEnvironment#DISPLAY}, {@link AdExchangeEnvironment#VIDEO}, and {@link AdExchangeEnvironment#MOBILE}. This attribute is read-only.
           • rfpType - optional; type RfpType - type string with restriction - enum { 'UNKNOWN', 'PROGRAMMATIC_GUARANTEED', 'PREFERRED_DEAL' }
             Deal type; either Programmatic Guaranteed or Preferred Deal. This field corresponds to the type of {@link Proposal} that a buyer wishes to negotiate with a seller. This attribute is read-only.
           The buyer RFP associated with this {@code Proposal}, which is optional. This field will be null if the proposal is not initiated from RFP.
         • hasBuyerRfp - optional; type boolean
           Whether a {@link Proposal} contains a {@link BuyerRfp} field. If this field is true, it indicates that the {@link Proposal} in question orignated from a buyer.
         • deliveryPausingEnabled - optional; type boolean
           Whether pausing is consented for the {@code Proposal}. This field is optional and defaults to true. If false, it indicates that the buyer and the seller agree that the proposal should not be paused.
   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.