--- title: "POST /v4/advertisers/{+advertiserId}/lineItems:bulkUpdate" method: POST path: "/v4/advertisers/{+advertiserId}/lineItems:bulkUpdate" tags: ["advertisers"] --- # POST /v4/advertisers/{+advertiserId}/lineItems:bulkUpdate `POST /v4/advertisers/{+advertiserId}/lineItems:bulkUpdate` Updates multiple line items. Requests to this endpoint cannot be made concurrently with the following requests updating the same line item: * BulkEditAssignedTargetingOptions * UpdateLineItem * assignedTargetingOptions.create * assignedTargetingOptions.delete YouTube & Partners line items cannot be created or updated using the API. ## Path parameters - `advertiserId` string, required ## Request body - BulkUpdateLineItemsRequest — Request message for LineItemService.BulkUpdateLineItems. - `lineItemIds` string[] — Required. IDs of line items to update. - `targetLineItem` LineItem — A single line item. - `bidStrategy` BiddingStrategy — Settings that control the bid strategy. Bid strategy determines the bid price. - `fixedBid` FixedBidStrategy — A strategy that uses a fixed bidding price. - `bidAmountMicros` string, int64 — The fixed bid amount, in micros of the advertiser's currency. For insertion order entity, bid_amount_micros should be set as 0. For line item entity, bid_amount_micros must be greater than or equal to billable unit of the given currency and smaller than or equal to the upper limit 1000000000. For example, 1500000 represents 1.5 standard units of the currency. - `performanceGoalAutoBid` PerformanceGoalBidStrategy — A strategy that automatically adjusts the bid to meet or beat a specified performance goal. - `performanceGoalAmountMicros` string, int64 — Required. The performance goal the bidding strategy will attempt to meet or beat, in micros of the advertiser's currency or in micro of the ROAS (Return On Advertising Spend) value which is also based on advertiser's currency. Must be greater than or equal to a billable unit of the given currency and smaller or equal to upper bounds. Each performance_goal_type has its upper bound: * when performance_goal_type is `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA`, upper bound is 10000.00 USD. * when performance_goal_type is `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC`, upper bound is 1000.00 USD. * when performance_goal_type is `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM`, upper bound is 1000.00 USD. * when performance_goal_type is `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO`, upper bound is 1000.00 and lower bound is 0.01. Example: If set to `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM`, the bid price will be based on the probability that each available impression will be viewable. For example, if viewable CPM target is $2 and an impression is 40% likely to be viewable, the bid price will be $0.80 CPM (40% of $2). For example, 1500000 represents 1.5 standard units of the currency or ROAS value. - `customBiddingAlgorithmId` string, int64 — The ID of the Custom Bidding Algorithm used by this strategy. Only applicable when performance_goal_type is set to `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO`. Assigning a custom bidding algorithm that uses floodlight activities not identified in floodlightActivityConfigs will return an error. - `performanceGoalType` 'BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_UNSPECIFIED' | 'BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA' | 'BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC' | 'BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM' | 'BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO' | 'BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA' | 'BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN' | 'BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED' | 'BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_REACH' — Required. The type of the performance goal that the bidding strategy will try to meet or beat. For line item level usage, the value must be one of: * `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA` * `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC` * `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM` * `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO`. - `maxAverageCpmBidAmountMicros` string, int64 — The maximum average CPM that may be bid, in micros of the advertiser's currency. Must be greater than or equal to a billable unit of the given currency. Not applicable when performance_goal_type is set to `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM`. For example, 1500000 represents 1.5 standard units of the currency. - `maximizeSpendAutoBid` MaximizeSpendBidStrategy — A strategy that automatically adjusts the bid to optimize a specified performance goal while spending the full budget. - `raiseBidForDeals` boolean — Whether the strategy takes deal floor prices into account. - `customBiddingAlgorithmId` string, int64 — The ID of the Custom Bidding Algorithm used by this strategy. Only applicable when performance_goal_type is set to `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO`. Assigning a custom bidding algorithm that uses floodlight activities not identified in floodlightActivityConfigs will return an error. - `maxAverageCpmBidAmountMicros` string, int64 — The maximum average CPM that may be bid, in micros of the advertiser's currency. Must be greater than or equal to a billable unit of the given currency. For example, 1500000 represents 1.5 standard units of the currency. - `performanceGoalType` 'BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_UNSPECIFIED' | 'BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA' | 'BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC' | 'BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM' | 'BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO' | 'BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA' | 'BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN' | 'BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED' | 'BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_REACH' — Required. The type of the performance goal that the bidding strategy tries to minimize while spending the full budget. `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM` is not supported for this strategy. - `demandGenBid` DemandGenBiddingStrategy — Settings that control the bid strategy for Demand Gen resources. - `value` string, int64 — Optional. The value used by the bidding strategy. This can be set when assigned to line items or ad groups. This field is only applicable for the following strategy types: * `DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPA` * `DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPC` * `DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_ROAS` Value of this field is in micros of the advertiser's currency or ROAS value. For example, 1000000 represents 1.0 standard units of the currency or 100% ROAS value. If not using an applicable strategy, the value of this field will be 0. - `effectiveBiddingValueSource` 'BIDDING_SOURCE_UNSPECIFIED' | 'BIDDING_SOURCE_LINE_ITEM' | 'BIDDING_SOURCE_AD_GROUP' — Output only. Source of the effective bidding value. - `type` 'DEMAND_GEN_BIDDING_STRATEGY_TYPE_UNSPECIFIED' | 'DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPA' | 'DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_ROAS' | 'DEMAND_GEN_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSIONS' | 'DEMAND_GEN_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSION_VALUE' | 'DEMAND_GEN_BIDDING_STRATEGY_TYPE_MAXIMIZE_CLICKS' | 'DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPC' — Optional. The type of the bidding strategy. This can only be set when assigned to a line item. Ad groups will inherit this value from their line item. - `effectiveBiddingValue` string, int64 — Output only. The value effectively used by the bidding strategy. This field will be the same as value if set. If value is not set and the strategy is assigned to an ad group, this field will be inherited from the line item's bidding strategy. If type is not `DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPA` or `DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_ROAS`, this field will be 0. - `youtubeAndPartnersBid` YoutubeAndPartnersBiddingStrategy — Settings that control the bid strategy for YouTube and Partners resources. - `type` 'YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_UNSPECIFIED' | 'YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MANUAL_CPV' | 'YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MANUAL_CPM' | 'YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPA' | 'YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM' | 'YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_RESERVE_CPM' | 'YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_LIFT' | 'YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSIONS' | 'YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPV' | 'YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS' | 'YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSION_VALUE' — The type of the bidding strategy. - `value` string, int64 — The value used by the bidding strategy. When the bidding strategy is assigned at the line item level, this field is only applicable for the following strategy types: * `YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPA` * `YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS` When the bidding strategy is assigned at the ad group level, this field is only applicable for the following strategy types: * `YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MANUAL_CPM` * `YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MANUAL_CPV` * `YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPA` * `YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM` * `YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_RESERVE_CPM` * `YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS` If not using an applicable strategy, the value of this field will be 0. - `adGroupEffectiveTargetCpaValue` string, int64 — Output only. The effective target CPA for ad group, in micros of advertiser's currency. - `adGroupEffectiveTargetCpaSource` 'BIDDING_SOURCE_UNSPECIFIED' | 'BIDDING_SOURCE_LINE_ITEM' | 'BIDDING_SOURCE_AD_GROUP' — Output only. Source of the effective target CPA value for ad group. - `targetingExpansion` TargetingExpansionConfig — Settings that control the [optimized targeting](//support.google.com/displayvideo/answer/12060859) settings of the line item. - `enableOptimizedTargeting` boolean — Required. Whether to enable Optimized Targeting for the line item. Optimized targeting is not compatible with all bid strategies. Attempting to set this field to `true` for a line item using the BiddingStrategy field fixed_bid or one of the following combinations of BiddingStrategy fields and BiddingStrategyPerformanceGoalType will result in an error: maximize_auto_spend_bid: * `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA` * `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN` * `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED` performance_goal_auto_bid: * `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM` This also applies if the line item inherits one of the above bid strategies from the parent insertion order. Bid strategies set at the insertion order-level will be inherited by their line items if the `InsertionOrder` budget field automationType is set to `INSERTION_ORDER_AUTOMATION_TYPE_BUDGET` or `INSERTION_ORDER_AUTOMATION_TYPE_BID_BUDGET`. - `excludeDemographicExpansion` boolean — Optional. Whether to exclude demographic expansion for Optimized Targeting. This field can only be set for Demand Gen ad groups. - `audienceExpansionSeedListExcluded` boolean — Output only. Whether to exclude seed list for audience expansion. This field only applies to YouTube and Partners line item and ad group resources. - `audienceExpansionLevel` 'UNKNOWN' | 'NO_REACH' | 'LEAST_REACH' | 'MID_REACH' | 'MOST_REACH' — Output only. Magnitude of expansion for eligible first-party user lists under this ad group. This field only applies to YouTube and Partners line item and ad group resources. - `updateTime` string, google-datetime — Output only. The timestamp when the line item was last updated. Assigned by the system. - `campaignId` string, int64 — Output only. The unique ID of the campaign that the line item belongs to. - `pacing` Pacing — Settings that control the rate at which a budget is spent. - `pacingPeriod` 'PACING_PERIOD_UNSPECIFIED' | 'PACING_PERIOD_DAILY' | 'PACING_PERIOD_FLIGHT' — Required. The time period in which the pacing budget will be spent. When automatic budget allocation is enabled at the insertion order via automationType, this field is output only and defaults to `PACING_PERIOD_FLIGHT`. - `dailyMaxMicros` string, int64 — Maximum currency amount to spend every day in micros of advertiser's currency. Applicable when the budget is currency based. Must be greater than 0. For example, for 1.5 standard unit of the currency, set this field to 1500000. The value assigned will be rounded to whole billable units for the relevant currency by the following rules: any positive value less than a single billable unit will be rounded up to one billable unit and any value larger than a single billable unit will be rounded down to the nearest billable value. For example, if the currency's billable unit is 0.01, and this field is set to 10257770, it will round down to 10250000, a value of 10.25. If set to 505, it will round up to 10000, a value of 0.01. - `pacingType` 'PACING_TYPE_UNSPECIFIED' | 'PACING_TYPE_AHEAD' | 'PACING_TYPE_ASAP' | 'PACING_TYPE_EVEN' — Required. The type of pacing that defines how the budget amount will be spent across the pacing_period. `PACING_TYPE_ASAP` is not compatible with pacing_period `PACING_PERIOD_FLIGHT` for insertion orders. - `dailyMaxImpressions` string, int64 — Maximum number of impressions to serve every day. Applicable when the budget is impression based. Must be greater than 0. - `partnerRevenueModel` PartnerRevenueModel — Settings that control how partner revenue is calculated. - `markupType` 'PARTNER_REVENUE_MODEL_MARKUP_TYPE_UNSPECIFIED' | 'PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM' | 'PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP' | 'PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP' — Required. The markup type of the partner revenue model. This field must be set to `PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP` for Demand Gen line items. - `markupAmount` string, int64 — Required. The markup amount of the partner revenue model. Must be greater than or equal to 0. * When the markup_type is set to be `PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM`, this field represents the CPM markup in micros of advertiser's currency. For example, 1500000 represents 1.5 standard units of the currency. * When the markup_type is set to be `PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP`, this field represents the media cost percent markup in millis. For example, 100 represents 0.1% (decimal 0.001). * When the markup_type is set to be `PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP`, this field represents the total media cost percent markup in millis. For example, 100 represents 0.1% (decimal 0.001). - `partnerCosts` PartnerCost[] — The partner costs associated with the line item. If absent or empty in CreateLineItem method, the newly created line item will inherit partner costs from its parent insertion order. - `costType` 'PARTNER_COST_TYPE_UNSPECIFIED' | 'PARTNER_COST_TYPE_ADLOOX' | 'PARTNER_COST_TYPE_ADLOOX_PREBID' | 'PARTNER_COST_TYPE_ADSAFE' | 'PARTNER_COST_TYPE_ADXPOSE' | 'PARTNER_COST_TYPE_AGGREGATE_KNOWLEDGE' | 'PARTNER_COST_TYPE_AGENCY_TRADING_DESK' | 'PARTNER_COST_TYPE_DV360_FEE' | 'PARTNER_COST_TYPE_COMSCORE_VCE' | 'PARTNER_COST_TYPE_DATA_MANAGEMENT_PLATFORM' | 'PARTNER_COST_TYPE_DEFAULT' | 'PARTNER_COST_TYPE_DOUBLE_VERIFY' | 'PARTNER_COST_TYPE_DOUBLE_VERIFY_PREBID' | 'PARTNER_COST_TYPE_EVIDON' | 'PARTNER_COST_TYPE_INTEGRAL_AD_SCIENCE_VIDEO' | 'PARTNER_COST_TYPE_INTEGRAL_AD_SCIENCE_PREBID' | 'PARTNER_COST_TYPE_MEDIA_COST_DATA' | 'PARTNER_COST_TYPE_MOAT_VIDEO' | 'PARTNER_COST_TYPE_NIELSEN_DAR' | 'PARTNER_COST_TYPE_SHOP_LOCAL' | 'PARTNER_COST_TYPE_TERACENT' | 'PARTNER_COST_TYPE_THIRD_PARTY_AD_SERVER' | 'PARTNER_COST_TYPE_TRUST_METRICS' | 'PARTNER_COST_TYPE_VIZU' | 'PARTNER_COST_TYPE_CUSTOM_FEE_1' | 'PARTNER_COST_TYPE_CUSTOM_FEE_2' | 'PARTNER_COST_TYPE_CUSTOM_FEE_3' | 'PARTNER_COST_TYPE_CUSTOM_FEE_4' | 'PARTNER_COST_TYPE_CUSTOM_FEE_5' | 'PARTNER_COST_TYPE_SCIBIDS_FEE' — Required. The type of the partner cost. - `feeAmount` string, int64 — The CPM fee amount in micros of advertiser's currency. Applicable when the fee_type is `PARTNER_FEE_TYPE_CPM_FEE`. Must be greater than or equal to 0. For example, for 1.5 standard unit of the advertiser's currency, set this field to 1500000. - `invoiceType` 'PARTNER_COST_INVOICE_TYPE_UNSPECIFIED' | 'PARTNER_COST_INVOICE_TYPE_DV360' | 'PARTNER_COST_INVOICE_TYPE_PARTNER' — The invoice type for this partner cost. * Required when cost_type is one of: - `PARTNER_COST_TYPE_ADLOOX` - `PARTNER_COST_TYPE_DOUBLE_VERIFY` - `PARTNER_COST_TYPE_INTEGRAL_AD_SCIENCE`. * Output only for other types. - `feeType` 'PARTNER_COST_FEE_TYPE_UNSPECIFIED' | 'PARTNER_COST_FEE_TYPE_CPM_FEE' | 'PARTNER_COST_FEE_TYPE_MEDIA_FEE' — Required. The fee type for this partner cost. - `feePercentageMillis` string, int64 — The media fee percentage in millis (1/1000 of a percent). Applicable when the fee_type is `PARTNER_FEE_TYPE_MEDIA_FEE`. Must be greater than or equal to 0. For example: 100 represents 0.1%. - `flight` LineItemFlight — Settings that control the active duration of a line item. - `flightDateType` 'LINE_ITEM_FLIGHT_DATE_TYPE_UNSPECIFIED' | 'LINE_ITEM_FLIGHT_DATE_TYPE_INHERITED' | 'LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM' — Required. The type of the line item's flight dates. - `dateRange` DateRange — A date range. - `startDate` Date — Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp - `year` integer — Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year. - `day` integer — Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant. - `month` integer — Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day. - `endDate` Date — Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp - `year` integer — Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year. - `day` integer — Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant. - `month` integer — Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day. - `name` string — Output only. The resource name of the line item. - `lineItemType` 'LINE_ITEM_TYPE_UNSPECIFIED' | 'LINE_ITEM_TYPE_DISPLAY_DEFAULT' | 'LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL' | 'LINE_ITEM_TYPE_VIDEO_DEFAULT' | 'LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL' | 'LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INVENTORY' | 'LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INVENTORY' | 'LINE_ITEM_TYPE_AUDIO_DEFAULT' | 'LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP' | 'LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION' | 'LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE' | 'LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE' | 'LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIO' | 'LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH' | 'LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE' | 'LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOP' | 'LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP' | 'LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOP' | 'LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCY' | 'LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIEW' | 'LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME' | 'LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME' | 'LINE_ITEM_TYPE_DEMAND_GEN' — Required. Immutable. The type of the line item. - `containsEuPoliticalAds` 'EU_POLITICAL_ADVERTISING_STATUS_UNKNOWN' | 'CONTAINS_EU_POLITICAL_ADVERTISING' | 'DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING' — Whether this line item will serve European Union political ads. If contains_eu_political_ads has been set to `DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING` in the parent advertiser, then this field will be assigned `DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING` if not otherwise specified. This field can then be updated using the UI, API, or Structured Data Files. This field must be assigned when creating a new line item. Otherwise, **the `advertisers.lineItems.create` request will fail**. - `demandGenSettings` DemandGenSettings — Settings for Demand Gen line items. - `linkedMerchantId` string, int64 — Optional. The ID of the Merchant Center account used to provide a product feed. This Merchant Center account must already be linked to the advertiser. - `thirdPartyMeasurementConfigs` ThirdPartyMeasurementConfigs — Settings that control what third-party vendors are measuring specific line item metrics. - `viewabilityVendorConfigs` ThirdPartyVendorConfig[] — Optional. The third-party vendors measuring viewability. The following third-party vendors are applicable: * `THIRD_PARTY_VENDOR_MOAT` * `THIRD_PARTY_VENDOR_DOUBLE_VERIFY` * `THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE` * `THIRD_PARTY_VENDOR_COMSCORE` * `THIRD_PARTY_VENDOR_TELEMETRY` * `THIRD_PARTY_VENDOR_MEETRICS` - `vendor` 'THIRD_PARTY_VENDOR_UNSPECIFIED' | 'THIRD_PARTY_VENDOR_MOAT' | 'THIRD_PARTY_VENDOR_DOUBLE_VERIFY' | 'THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE' | 'THIRD_PARTY_VENDOR_COMSCORE' | 'THIRD_PARTY_VENDOR_TELEMETRY' | 'THIRD_PARTY_VENDOR_MEETRICS' | 'THIRD_PARTY_VENDOR_ZEFR' | 'THIRD_PARTY_VENDOR_NIELSEN' | 'THIRD_PARTY_VENDOR_KANTAR' | 'THIRD_PARTY_VENDOR_DYNATA' | 'THIRD_PARTY_VENDOR_TRANSUNION' | 'THIRD_PARTY_VENDOR_ORIGIN' | 'THIRD_PARTY_VENDOR_GEMIUS' | 'THIRD_PARTY_VENDOR_MEDIA_SCOPE' | 'THIRD_PARTY_VENDOR_AUDIENCE_PROJECT' | 'THIRD_PARTY_VENDOR_VIDEO_AMP' | 'THIRD_PARTY_VENDOR_ISPOT_TV' | 'THIRD_PARTY_VENDOR_INTAGE' | 'THIRD_PARTY_VENDOR_MACROMILL' | 'THIRD_PARTY_VENDOR_VIDEO_RESEARCH' — The third-party measurement vendor. - `placementId` string — The ID used by the platform of the third-party vendor to identify the line item. - `reachVendorConfigs` ThirdPartyVendorConfig[] — Optional. The third-party vendors measuring reach. The following third-party vendors are applicable: * `THIRD_PARTY_VENDOR_NIELSEN` * `THIRD_PARTY_VENDOR_COMSCORE` * `THIRD_PARTY_VENDOR_KANTAR` * `THIRD_PARTY_VENDOR_VIDEO_RESEARCH` * `THIRD_PARTY_VENDOR_MEDIA_SCOPE` * `THIRD_PARTY_VENDOR_AUDIENCE_PROJECT` * `THIRD_PARTY_VENDOR_VIDEO_AMP` * `THIRD_PARTY_VENDOR_ISPOT_TV` * `THIRD_PARTY_VENDOR_GEMIUS` - `vendor` 'THIRD_PARTY_VENDOR_UNSPECIFIED' | 'THIRD_PARTY_VENDOR_MOAT' | 'THIRD_PARTY_VENDOR_DOUBLE_VERIFY' | 'THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE' | 'THIRD_PARTY_VENDOR_COMSCORE' | 'THIRD_PARTY_VENDOR_TELEMETRY' | 'THIRD_PARTY_VENDOR_MEETRICS' | 'THIRD_PARTY_VENDOR_ZEFR' | 'THIRD_PARTY_VENDOR_NIELSEN' | 'THIRD_PARTY_VENDOR_KANTAR' | 'THIRD_PARTY_VENDOR_DYNATA' | 'THIRD_PARTY_VENDOR_TRANSUNION' | 'THIRD_PARTY_VENDOR_ORIGIN' | 'THIRD_PARTY_VENDOR_GEMIUS' | 'THIRD_PARTY_VENDOR_MEDIA_SCOPE' | 'THIRD_PARTY_VENDOR_AUDIENCE_PROJECT' | 'THIRD_PARTY_VENDOR_VIDEO_AMP' | 'THIRD_PARTY_VENDOR_ISPOT_TV' | 'THIRD_PARTY_VENDOR_INTAGE' | 'THIRD_PARTY_VENDOR_MACROMILL' | 'THIRD_PARTY_VENDOR_VIDEO_RESEARCH' — The third-party measurement vendor. - `placementId` string — The ID used by the platform of the third-party vendor to identify the line item. - `brandLiftVendorConfigs` ThirdPartyVendorConfig[] — Optional. The third-party vendors measuring brand lift. The following third-party vendors are applicable: * `THIRD_PARTY_VENDOR_DYNATA` * `THIRD_PARTY_VENDOR_KANTAR` * `THIRD_PARTY_VENDOR_INTAGE` * `THIRD_PARTY_VENDOR_NIELSEN` * `THIRD_PARTY_VENDOR_MACROMILL` *Warning*: Starting **July 13, 2026**, this field will no longer support `THIRD_PARTY_VENDOR_NIELSEN`. - `vendor` 'THIRD_PARTY_VENDOR_UNSPECIFIED' | 'THIRD_PARTY_VENDOR_MOAT' | 'THIRD_PARTY_VENDOR_DOUBLE_VERIFY' | 'THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE' | 'THIRD_PARTY_VENDOR_COMSCORE' | 'THIRD_PARTY_VENDOR_TELEMETRY' | 'THIRD_PARTY_VENDOR_MEETRICS' | 'THIRD_PARTY_VENDOR_ZEFR' | 'THIRD_PARTY_VENDOR_NIELSEN' | 'THIRD_PARTY_VENDOR_KANTAR' | 'THIRD_PARTY_VENDOR_DYNATA' | 'THIRD_PARTY_VENDOR_TRANSUNION' | 'THIRD_PARTY_VENDOR_ORIGIN' | 'THIRD_PARTY_VENDOR_GEMIUS' | 'THIRD_PARTY_VENDOR_MEDIA_SCOPE' | 'THIRD_PARTY_VENDOR_AUDIENCE_PROJECT' | 'THIRD_PARTY_VENDOR_VIDEO_AMP' | 'THIRD_PARTY_VENDOR_ISPOT_TV' | 'THIRD_PARTY_VENDOR_INTAGE' | 'THIRD_PARTY_VENDOR_MACROMILL' | 'THIRD_PARTY_VENDOR_VIDEO_RESEARCH' — The third-party measurement vendor. - `placementId` string — The ID used by the platform of the third-party vendor to identify the line item. - `brandSafetyVendorConfigs` ThirdPartyVendorConfig[] — Optional. The third-party vendors measuring brand safety. The following third-party vendors are applicable: * `THIRD_PARTY_VENDOR_ZEFR` * `THIRD_PARTY_VENDOR_DOUBLE_VERIFY` * `THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE` - `vendor` 'THIRD_PARTY_VENDOR_UNSPECIFIED' | 'THIRD_PARTY_VENDOR_MOAT' | 'THIRD_PARTY_VENDOR_DOUBLE_VERIFY' | 'THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE' | 'THIRD_PARTY_VENDOR_COMSCORE' | 'THIRD_PARTY_VENDOR_TELEMETRY' | 'THIRD_PARTY_VENDOR_MEETRICS' | 'THIRD_PARTY_VENDOR_ZEFR' | 'THIRD_PARTY_VENDOR_NIELSEN' | 'THIRD_PARTY_VENDOR_KANTAR' | 'THIRD_PARTY_VENDOR_DYNATA' | 'THIRD_PARTY_VENDOR_TRANSUNION' | 'THIRD_PARTY_VENDOR_ORIGIN' | 'THIRD_PARTY_VENDOR_GEMIUS' | 'THIRD_PARTY_VENDOR_MEDIA_SCOPE' | 'THIRD_PARTY_VENDOR_AUDIENCE_PROJECT' | 'THIRD_PARTY_VENDOR_VIDEO_AMP' | 'THIRD_PARTY_VENDOR_ISPOT_TV' | 'THIRD_PARTY_VENDOR_INTAGE' | 'THIRD_PARTY_VENDOR_MACROMILL' | 'THIRD_PARTY_VENDOR_VIDEO_RESEARCH' — The third-party measurement vendor. - `placementId` string — The ID used by the platform of the third-party vendor to identify the line item. - `geoLanguageTargetingEnabled` boolean — Optional. Immutable. Whether location and language targeting can be set at the line item level. Otherwise, relevant targeting types must be assigned directly to ad groups. - `lineItemId` string, int64 — Output only. The unique ID of the line item. Assigned by the system. - `integrationDetails` IntegrationDetails — Integration details of an entry. - `integrationCode` string — An external identifier to be associated with the entry. The integration code will show up together with the entry in many places in the system, for example, reporting. Must be UTF-8 encoded with a length of no more than 500 characters. - `details` string — Additional details of the entry in string format. Must be UTF-8 encoded with a length of no more than 1000 characters. - `mobileApp` MobileApp — A mobile app promoted by a mobile app install line item. - `platform` 'PLATFORM_UNSPECIFIED' | 'IOS' | 'ANDROID' — Output only. The app platform. - `publisher` string — Output only. The app publisher. - `appId` string — Required. The ID of the app provided by the platform store. Android apps are identified by the bundle ID used by Android's Play store, such as `com.google.android.gm`. iOS apps are identified by a nine-digit app ID used by Apple's App store, such as `422689480`. - `displayName` string — Output only. The app name. - `youtubeAndPartnersSettings` YoutubeAndPartnersSettings — Settings for YouTube and Partners line items. - `thirdPartyMeasurementConfigs` ThirdPartyMeasurementConfigs — Settings that control what third-party vendors are measuring specific line item metrics. - `viewabilityVendorConfigs` ThirdPartyVendorConfig[] — Optional. The third-party vendors measuring viewability. The following third-party vendors are applicable: * `THIRD_PARTY_VENDOR_MOAT` * `THIRD_PARTY_VENDOR_DOUBLE_VERIFY` * `THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE` * `THIRD_PARTY_VENDOR_COMSCORE` * `THIRD_PARTY_VENDOR_TELEMETRY` * `THIRD_PARTY_VENDOR_MEETRICS` - `vendor` 'THIRD_PARTY_VENDOR_UNSPECIFIED' | 'THIRD_PARTY_VENDOR_MOAT' | 'THIRD_PARTY_VENDOR_DOUBLE_VERIFY' | 'THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE' | 'THIRD_PARTY_VENDOR_COMSCORE' | 'THIRD_PARTY_VENDOR_TELEMETRY' | 'THIRD_PARTY_VENDOR_MEETRICS' | 'THIRD_PARTY_VENDOR_ZEFR' | 'THIRD_PARTY_VENDOR_NIELSEN' | 'THIRD_PARTY_VENDOR_KANTAR' | 'THIRD_PARTY_VENDOR_DYNATA' | 'THIRD_PARTY_VENDOR_TRANSUNION' | 'THIRD_PARTY_VENDOR_ORIGIN' | 'THIRD_PARTY_VENDOR_GEMIUS' | 'THIRD_PARTY_VENDOR_MEDIA_SCOPE' | 'THIRD_PARTY_VENDOR_AUDIENCE_PROJECT' | 'THIRD_PARTY_VENDOR_VIDEO_AMP' | 'THIRD_PARTY_VENDOR_ISPOT_TV' | 'THIRD_PARTY_VENDOR_INTAGE' | 'THIRD_PARTY_VENDOR_MACROMILL' | 'THIRD_PARTY_VENDOR_VIDEO_RESEARCH' — The third-party measurement vendor. - `placementId` string — The ID used by the platform of the third-party vendor to identify the line item. - `reachVendorConfigs` ThirdPartyVendorConfig[] — Optional. The third-party vendors measuring reach. The following third-party vendors are applicable: * `THIRD_PARTY_VENDOR_NIELSEN` * `THIRD_PARTY_VENDOR_COMSCORE` * `THIRD_PARTY_VENDOR_KANTAR` * `THIRD_PARTY_VENDOR_VIDEO_RESEARCH` * `THIRD_PARTY_VENDOR_MEDIA_SCOPE` * `THIRD_PARTY_VENDOR_AUDIENCE_PROJECT` * `THIRD_PARTY_VENDOR_VIDEO_AMP` * `THIRD_PARTY_VENDOR_ISPOT_TV` * `THIRD_PARTY_VENDOR_GEMIUS` - `vendor` 'THIRD_PARTY_VENDOR_UNSPECIFIED' | 'THIRD_PARTY_VENDOR_MOAT' | 'THIRD_PARTY_VENDOR_DOUBLE_VERIFY' | 'THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE' | 'THIRD_PARTY_VENDOR_COMSCORE' | 'THIRD_PARTY_VENDOR_TELEMETRY' | 'THIRD_PARTY_VENDOR_MEETRICS' | 'THIRD_PARTY_VENDOR_ZEFR' | 'THIRD_PARTY_VENDOR_NIELSEN' | 'THIRD_PARTY_VENDOR_KANTAR' | 'THIRD_PARTY_VENDOR_DYNATA' | 'THIRD_PARTY_VENDOR_TRANSUNION' | 'THIRD_PARTY_VENDOR_ORIGIN' | 'THIRD_PARTY_VENDOR_GEMIUS' | 'THIRD_PARTY_VENDOR_MEDIA_SCOPE' | 'THIRD_PARTY_VENDOR_AUDIENCE_PROJECT' | 'THIRD_PARTY_VENDOR_VIDEO_AMP' | 'THIRD_PARTY_VENDOR_ISPOT_TV' | 'THIRD_PARTY_VENDOR_INTAGE' | 'THIRD_PARTY_VENDOR_MACROMILL' | 'THIRD_PARTY_VENDOR_VIDEO_RESEARCH' — The third-party measurement vendor. - `placementId` string — The ID used by the platform of the third-party vendor to identify the line item. - `brandLiftVendorConfigs` ThirdPartyVendorConfig[] — Optional. The third-party vendors measuring brand lift. The following third-party vendors are applicable: * `THIRD_PARTY_VENDOR_DYNATA` * `THIRD_PARTY_VENDOR_KANTAR` * `THIRD_PARTY_VENDOR_INTAGE` * `THIRD_PARTY_VENDOR_NIELSEN` * `THIRD_PARTY_VENDOR_MACROMILL` *Warning*: Starting **July 13, 2026**, this field will no longer support `THIRD_PARTY_VENDOR_NIELSEN`. - `vendor` 'THIRD_PARTY_VENDOR_UNSPECIFIED' | 'THIRD_PARTY_VENDOR_MOAT' | 'THIRD_PARTY_VENDOR_DOUBLE_VERIFY' | 'THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE' | 'THIRD_PARTY_VENDOR_COMSCORE' | 'THIRD_PARTY_VENDOR_TELEMETRY' | 'THIRD_PARTY_VENDOR_MEETRICS' | 'THIRD_PARTY_VENDOR_ZEFR' | 'THIRD_PARTY_VENDOR_NIELSEN' | 'THIRD_PARTY_VENDOR_KANTAR' | 'THIRD_PARTY_VENDOR_DYNATA' | 'THIRD_PARTY_VENDOR_TRANSUNION' | 'THIRD_PARTY_VENDOR_ORIGIN' | 'THIRD_PARTY_VENDOR_GEMIUS' | 'THIRD_PARTY_VENDOR_MEDIA_SCOPE' | 'THIRD_PARTY_VENDOR_AUDIENCE_PROJECT' | 'THIRD_PARTY_VENDOR_VIDEO_AMP' | 'THIRD_PARTY_VENDOR_ISPOT_TV' | 'THIRD_PARTY_VENDOR_INTAGE' | 'THIRD_PARTY_VENDOR_MACROMILL' | 'THIRD_PARTY_VENDOR_VIDEO_RESEARCH' — The third-party measurement vendor. - `placementId` string — The ID used by the platform of the third-party vendor to identify the line item. - `brandSafetyVendorConfigs` ThirdPartyVendorConfig[] — Optional. The third-party vendors measuring brand safety. The following third-party vendors are applicable: * `THIRD_PARTY_VENDOR_ZEFR` * `THIRD_PARTY_VENDOR_DOUBLE_VERIFY` * `THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE` - `vendor` 'THIRD_PARTY_VENDOR_UNSPECIFIED' | 'THIRD_PARTY_VENDOR_MOAT' | 'THIRD_PARTY_VENDOR_DOUBLE_VERIFY' | 'THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE' | 'THIRD_PARTY_VENDOR_COMSCORE' | 'THIRD_PARTY_VENDOR_TELEMETRY' | 'THIRD_PARTY_VENDOR_MEETRICS' | 'THIRD_PARTY_VENDOR_ZEFR' | 'THIRD_PARTY_VENDOR_NIELSEN' | 'THIRD_PARTY_VENDOR_KANTAR' | 'THIRD_PARTY_VENDOR_DYNATA' | 'THIRD_PARTY_VENDOR_TRANSUNION' | 'THIRD_PARTY_VENDOR_ORIGIN' | 'THIRD_PARTY_VENDOR_GEMIUS' | 'THIRD_PARTY_VENDOR_MEDIA_SCOPE' | 'THIRD_PARTY_VENDOR_AUDIENCE_PROJECT' | 'THIRD_PARTY_VENDOR_VIDEO_AMP' | 'THIRD_PARTY_VENDOR_ISPOT_TV' | 'THIRD_PARTY_VENDOR_INTAGE' | 'THIRD_PARTY_VENDOR_MACROMILL' | 'THIRD_PARTY_VENDOR_VIDEO_RESEARCH' — The third-party measurement vendor. - `placementId` string — The ID used by the platform of the third-party vendor to identify the line item. - `contentCategory` 'YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_UNSPECIFIED' | 'YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_STANDARD' | 'YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_EXPANDED' | 'YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_LIMITED' — Output only. The kind of content on which the YouTube and Partners ads will be shown. *Warning*: This field will be removed in the near future. Use effective_content_category instead. - `effectiveContentCategory` 'YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_UNSPECIFIED' | 'YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_STANDARD' | 'YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_EXPANDED' | 'YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_LIMITED' — Output only. The content category which takes effect when serving the line item. When content category is set in both line item and advertiser, the stricter one will take effect when serving the line item. New line items will only inherit the advertiser level setting. - `videoAdInventoryControl` VideoAdInventoryControl — The video ad inventory control used in certain YouTube line item types. - `allowInStream` boolean — Optional. Whether ads can serve as in-stream format. - `allowNonSkippableInStream` boolean — Optional. Indicates whether ads can serve as non-skippable in-stream format. - `allowInFeed` boolean — Optional. Whether ads can serve as in-feed format. - `allowShorts` boolean — Optional. Whether ads can serve as shorts format. - `leadFormId` string, int64 — Optional. The ID of the form to generate leads. - `viewFrequencyCap` FrequencyCap — Settings that control the number of times a user may be shown with the same ad during a given time period. - `maxViews` integer — Optional. The maximum number of times a user may click-through or fully view an ad during this period until it is no longer served to them. Must be greater than 0. Only applicable to YouTube and Partners resources. Required when unlimited is `false` and max_impressions is not set. - `unlimited` boolean — Whether unlimited frequency capping is applied. When this field is set to `true`, the remaining frequency cap fields are not applicable. - `timeUnitCount` integer — The number of time_unit the frequency cap will last. Required when unlimited is `false`. The following restrictions apply based on the value of time_unit: * `TIME_UNIT_MONTHS` - must be 1 * `TIME_UNIT_WEEKS` - must be between 1 and 4 * `TIME_UNIT_DAYS` - must be between 1 and 6 * `TIME_UNIT_HOURS` - must be between 1 and 23 * `TIME_UNIT_MINUTES` - must be between 1 and 59 - `maxImpressions` integer — The maximum number of times a user may be shown the same ad during this period. Must be greater than 0. Required when unlimited is `false` and max_views is not set. - `timeUnit` 'TIME_UNIT_UNSPECIFIED' | 'TIME_UNIT_LIFETIME' | 'TIME_UNIT_MONTHS' | 'TIME_UNIT_WEEKS' | 'TIME_UNIT_DAYS' | 'TIME_UNIT_HOURS' | 'TIME_UNIT_MINUTES' — The time unit in which the frequency cap will be applied. Required when unlimited is `false`. - `inventorySourceSettings` YoutubeAndPartnersInventorySourceConfig — Settings that control what YouTube related inventories the YouTube and Partners line item will target. - `includeGoogleTv` boolean — Optional. Whether to target inventory in video apps available with Google TV. - `includeYoutubeVideoPartners` boolean — Whether to target inventory on a collection of partner sites and apps that follow the same brand safety standards as YouTube. - `includeYoutube` boolean — Optional. Whether to target inventory on YouTube. This includes both search, channels and videos. - `relatedVideoIds` string[] — Optional. The IDs of the videos appear below the primary video ad when the ad is playing in the YouTube app on mobile devices. - `targetFrequency` TargetFrequency — Setting that controls the average number of times the ads will show to the same person over a certain period of time. - `targetCount` string, int64 — The target number of times, on average, the ads will be shown to the same person in the timespan dictated by time_unit and time_unit_count. - `timeUnit` 'TIME_UNIT_UNSPECIFIED' | 'TIME_UNIT_LIFETIME' | 'TIME_UNIT_MONTHS' | 'TIME_UNIT_WEEKS' | 'TIME_UNIT_DAYS' | 'TIME_UNIT_HOURS' | 'TIME_UNIT_MINUTES' — The unit of time in which the target frequency will be applied. The following time unit is applicable: * `TIME_UNIT_WEEKS` - `timeUnitCount` integer — The number of time_unit the target frequency will last. The following restrictions apply based on the value of time_unit: * `TIME_UNIT_WEEKS` - must be 1 - `videoAdSequenceSettings` VideoAdSequenceSettings — Settings related to VideoAdSequence. - `minimumDuration` 'VIDEO_AD_SEQUENCE_MINIMUM_DURATION_UNSPECIFIED' | 'VIDEO_AD_SEQUENCE_MINIMUM_DURATION_WEEK' | 'VIDEO_AD_SEQUENCE_MINIMUM_DURATION_MONTH' — The minimum time interval before the same user sees this sequence again. - `steps` VideoAdSequenceStep[] — The steps of which the sequence consists. - `adGroupId` string, int64 — The ID of the corresponding ad group of the step. - `stepId` string, int64 — The ID of the step. - `previousStepId` string, int64 — The ID of the previous step. The first step does not have previous step. - `interactionType` 'INTERACTION_TYPE_UNSPECIFIED' | 'INTERACTION_TYPE_PAID_VIEW' | 'INTERACTION_TYPE_SKIP' | 'INTERACTION_TYPE_IMPRESSION' | 'INTERACTION_TYPE_ENGAGED_IMPRESSION' — The interaction on the previous step that will lead the viewer to this step. The first step does not have interaction_type. - `linkedMerchantId` string, int64 — Optional. The ID of the Merchant Center account used to provide a product feed. This Merchant Center account must already be linked to the advertiser. - `optimizeFixedBidding` boolean — Optional. Whether to enable DV360's bid optimization for fixed bid line items. By default, DV360 optimizes your fixed bid by automatically lowering bids for impressions that are less likely to perform well. This optimization is enabled by default (value is true). When this field is set to `false`, this optimization is disabled, and the bid will not be lowered for any reason. This setting only applies to line items with a `bidding_strategy` of type `FIXED_BID`. - `displayName` string — Required. The display name of the line item. Must be UTF-8 encoded with a maximum size of 240 bytes. - `warningMessages` string[] — Output only. The warning messages generated by the line item. These warnings do not block saving the line item, but some may block the line item from running. - `excludeNewExchanges` boolean — Whether to exclude new exchanges from automatically being targeted by the line item. This field is false by default. - `creativeIds` string[] — The IDs of the creatives associated with the line item. - `entityStatus` 'ENTITY_STATUS_UNSPECIFIED' | 'ENTITY_STATUS_ACTIVE' | 'ENTITY_STATUS_ARCHIVED' | 'ENTITY_STATUS_DRAFT' | 'ENTITY_STATUS_PAUSED' | 'ENTITY_STATUS_SCHEDULED_FOR_DELETION' — Required. Controls whether or not the line item can spend its budget and bid on inventory. * For CreateLineItem method, only `ENTITY_STATUS_DRAFT` is allowed. To activate a line item, use UpdateLineItem method and update the status to `ENTITY_STATUS_ACTIVE` after creation. * A line item cannot be changed back to `ENTITY_STATUS_DRAFT` status from any other status. * If the line item's parent insertion order is not active, the line item can't spend its budget even if its own status is `ENTITY_STATUS_ACTIVE`. - `reservationType` 'RESERVATION_TYPE_UNSPECIFIED' | 'RESERVATION_TYPE_NOT_GUARANTEED' | 'RESERVATION_TYPE_PROGRAMMATIC_GUARANTEED' | 'RESERVATION_TYPE_TAG_GUARANTEED' | 'RESERVATION_TYPE_PETRA_VIRAL' | 'RESERVATION_TYPE_INSTANT_RESERVE' — Output only. The reservation type of the line item. - `budget` LineItemBudget — Settings that control how budget is allocated. - `maxAmount` string, int64 — The maximum budget amount the line item will spend. Must be greater than 0. When budget_allocation_type is: * `LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC`, this field is immutable and is set by the system. * `LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED`, if budget_unit is: - `BUDGET_UNIT_CURRENCY`, this field represents maximum budget amount to spend, in micros of the advertiser's currency. For example, 1500000 represents 1.5 standard units of the currency. - `BUDGET_UNIT_IMPRESSIONS`, this field represents the maximum number of impressions to serve. * `LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED`, this field is not applicable and will be ignored by the system. - `budgetAllocationType` 'LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNSPECIFIED' | 'LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC' | 'LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED' | 'LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED' — Required. The type of the budget allocation. `LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC` is only applicable when automatic budget allocation is enabled for the parent insertion order. This field must be set to `LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED` for Demand Gen line items. - `budgetUnit` 'BUDGET_UNIT_UNSPECIFIED' | 'BUDGET_UNIT_CURRENCY' | 'BUDGET_UNIT_IMPRESSIONS' — Output only. The budget unit specifies whether the budget is currency based or impression based. This value is inherited from the parent insertion order. - `insertionOrderId` string, int64 — Required. Immutable. The unique ID of the insertion order that the line item belongs to. - `conversionCounting` ConversionCountingConfig — Settings that control how conversions are counted. All post-click conversions will be counted. A percentage value can be set for post-view conversions counting. - `postViewCountPercentageMillis` string, int64 — The percentage of post-view conversions to count, in millis (1/1000 of a percent). Must be between 0 and 100000 inclusive. For example, to track 50% of the post-click conversions, set a value of 50000. - `primaryAttributionModelId` string, int64 — Optional. The attribution model to use for conversion measurement. This attribution model will determine how conversions are counted. The Primary model can be set by you for a floodlight config or group. More details [here](https://support.google.com/displayvideo/answer/7409983). Only applicable to Demand Gen line items. - `floodlightActivityConfigs` TrackingFloodlightActivityConfig[] — The Floodlight activity configs used to track conversions. The number of conversions counted is the sum of all of the conversions counted by all of the Floodlight activity IDs specified in this field. This field can't be updated if a custom bidding algorithm is assigned to the line item. If you set this field and assign a custom bidding algorithm in the same request, the floodlight activities must match the ones used by the custom bidding algorithm. - `floodlightActivityId` string, int64 — Required. The ID of the Floodlight activity. - `postClickLookbackWindowDays` integer — Required. The number of days after an ad has been clicked in which a conversion may be counted. Must be between 0 and 90 inclusive. - `postViewLookbackWindowDays` integer — Required. The number of days after an ad has been viewed in which a conversion may be counted. Must be between 0 and 90 inclusive. - `frequencyCap` FrequencyCap — Settings that control the number of times a user may be shown with the same ad during a given time period. - `maxViews` integer — Optional. The maximum number of times a user may click-through or fully view an ad during this period until it is no longer served to them. Must be greater than 0. Only applicable to YouTube and Partners resources. Required when unlimited is `false` and max_impressions is not set. - `unlimited` boolean — Whether unlimited frequency capping is applied. When this field is set to `true`, the remaining frequency cap fields are not applicable. - `timeUnitCount` integer — The number of time_unit the frequency cap will last. Required when unlimited is `false`. The following restrictions apply based on the value of time_unit: * `TIME_UNIT_MONTHS` - must be 1 * `TIME_UNIT_WEEKS` - must be between 1 and 4 * `TIME_UNIT_DAYS` - must be between 1 and 6 * `TIME_UNIT_HOURS` - must be between 1 and 23 * `TIME_UNIT_MINUTES` - must be between 1 and 59 - `maxImpressions` integer — The maximum number of times a user may be shown the same ad during this period. Must be greater than 0. Required when unlimited is `false` and max_views is not set. - `timeUnit` 'TIME_UNIT_UNSPECIFIED' | 'TIME_UNIT_LIFETIME' | 'TIME_UNIT_MONTHS' | 'TIME_UNIT_WEEKS' | 'TIME_UNIT_DAYS' | 'TIME_UNIT_HOURS' | 'TIME_UNIT_MINUTES' — The time unit in which the frequency cap will be applied. Required when unlimited is `false`. - `advertiserId` string, int64 — Output only. The unique ID of the advertiser the line item belongs to. - `updateMask` string, google-fieldmask — Required. A field mask identifying which fields to update. Only the following fields are currently supported: * entityStatus * containsEuPoliticalAds ## Response `200` Successful response --- [API](https://skmtc.dev/google/apis/displayvideo.md) · [All operations](https://skmtc.dev/google/apis/displayvideo/llms.txt) · [OpenAPI document](https://skmtc.dev/google/apis/displayvideo/revisions/68b64e49eced?raw)