REST Resource: advertisers.lineItems

    Resource: LineItem

    A single line item.

    JSON representation 
     { 
 "name" 
 : 
 string 
 , 
 "advertiserId" 
 : 
 string 
 , 
 "campaignId" 
 : 
 string 
 , 
 "insertionOrderId" 
 : 
 string 
 , 
 "lineItemId" 
 : 
 string 
 , 
 "displayName" 
 : 
 string 
 , 
 "lineItemType" 
 : 
 enum (  LineItemType 
 
) 
 , 
 "entityStatus" 
 : 
 enum (  EntityStatus 
 
) 
 , 
 "updateTime" 
 : 
 string 
 , 
 "partnerCosts" 
 : 
 [ 
 { 
 object (  PartnerCost 
 
) 
 } 
 ] 
 , 
 "flight" 
 : 
 { 
 object (  LineItemFlight 
 
) 
 } 
 , 
 "budget" 
 : 
 { 
 object (  LineItemBudget 
 
) 
 } 
 , 
 "pacing" 
 : 
 { 
 object (  Pacing 
 
) 
 } 
 , 
 "frequencyCap" 
 : 
 { 
 object (  FrequencyCap 
 
) 
 } 
 , 
 "partnerRevenueModel" 
 : 
 { 
 object (  PartnerRevenueModel 
 
) 
 } 
 , 
 "conversionCounting" 
 : 
 { 
 object (  ConversionCountingConfig 
 
) 
 } 
 , 
 "creativeIds" 
 : 
 [ 
 string 
 ] 
 , 
 "bidStrategy" 
 : 
 { 
 object (  BiddingStrategy 
 
) 
 } 
 , 
 "integrationDetails" 
 : 
 { 
 object (  IntegrationDetails 
 
) 
 } 
 , 
 "targetingExpansion" 
 : 
 { 
 object (  TargetingExpansionConfig 
 
) 
 } 
 , 
 "warningMessages" 
 : 
 [ 
 enum (  LineItemWarningMessage 
 
) 
 ] 
 , 
 "mobileApp" 
 : 
 { 
 object (  MobileApp 
 
) 
 } 
 , 
 "reservationType" 
 : 
 enum (  ReservationType 
 
) 
 , 
 "excludeNewExchanges" 
 : 
 boolean 
 , 
 "youtubeAndPartnersSettings" 
 : 
 { 
 object (  YoutubeAndPartnersSettings 
 
) 
 } 
 , 
 "containsEuPoliticalAds" 
 : 
 enum (  EuPoliticalAdvertisingStatus 
 
) 
 }
    Fields
    name

    string

    Output only. The resource name of the line item.

    advertiserId

    string ( int64 format)

    Output only. The unique ID of the advertiser the line item belongs to.

    campaignId

    string ( int64 format)

    Output only. The unique ID of the campaign that the line item belongs to.

    insertionOrderId

    string ( int64 format)

    Required. Immutable. The unique ID of the insertion order that the line item belongs to.

    lineItemId

    string ( int64 format)

    Output only. The unique ID of the line item. Assigned by the system.

    displayName

    string

    Required. The display name of the line item.

    Must be UTF-8 encoded with a maximum size of 240 bytes.

    lineItemType

    enum ( LineItemType )

    Required. Immutable. The type of the line item.

    entityStatus

    enum ( EntityStatus )

    Required. Controls whether or not the line item can spend its budget and bid on inventory.

    • For lineItems.create method, only ENTITY_STATUS_DRAFT is allowed. To activate a line item, use lineItems.patch method and update the status to ENTITY_STATUS_ACTIVE after creation.
    • A line item cannot be changed back to ENTITY_STATUS_DRAFT status from any other status.
    • If the line item's parent insertion order is not active, the line item can't spend its budget even if its own status is ENTITY_STATUS_ACTIVE .
    updateTime

    string ( Timestamp format)

    Output only. The timestamp when the line item was last updated. Assigned by the system.

    Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30" .

    partnerCosts[]

    object ( PartnerCost )

    The partner costs associated with the line item.

    If absent or empty in lineItems.create method, the newly created line item will inherit partner costs from its parent insertion order.

    flight

    object ( LineItemFlight )

    Required. The start and end time of the line item's flight.

    budget

    object ( LineItemBudget )

    Required. The budget allocation setting of the line item.

    pacing

    object ( Pacing )

    Required. The budget spending speed setting of the line item.

    frequencyCap

    object ( FrequencyCap )

    Required. The impression frequency cap settings of the line item.

    The maxImpressions field in this settings object must be used if assigning a limited cap.

    partnerRevenueModel

    object ( PartnerRevenueModel )

    Required. The partner revenue model setting of the line item.

    conversionCounting

    object ( ConversionCountingConfig )

    The conversion tracking setting of the line item.

    creativeIds[]

    string ( int64 format)

    The IDs of the creatives associated with the line item.

    bidStrategy

    object ( BiddingStrategy )

    Required. The bidding strategy of the line item.

    integrationDetails

    object ( IntegrationDetails )

    Integration details of the line item.

    targetingExpansion

    object ( TargetingExpansionConfig )

    The optimized targeting settings of the line item.

    This config is only applicable for display, video, or audio line items that use automated bidding and positively target eligible audience lists.

    warningMessages[]

    enum ( LineItemWarningMessage )

    Output only. The warning messages generated by the line item. These warnings do not block saving the line item, but some may block the line item from running.

    mobileApp

    object ( MobileApp )

    The mobile app promoted by the line item.

    This is applicable only when lineItemType is either LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL or LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL .

    reservationType

    enum ( ReservationType )

    Output only. The reservation type of the line item.

    excludeNewExchanges

    boolean

    Whether to exclude new exchanges from automatically being targeted by the line item. This field is false by default.

    youtubeAndPartnersSettings

    object ( YoutubeAndPartnersSettings )

    Output only. Settings specific to YouTube and Partners line items.

    containsEuPoliticalAds

    enum ( EuPoliticalAdvertisingStatus )

    Whether this line item will serve European Union political ads.

    If containsEuPoliticalAds 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.

    LineItemType

    Possible types of a line item.

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

    Enums
    LINE_ITEM_TYPE_UNSPECIFIED

    Type value is not specified or is unknown in this version.

    Line items of this type and their targeting cannot be created or updated using the API.
    LINE_ITEM_TYPE_DISPLAY_DEFAULT Image, HTML5, native, or rich media ads.
    LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL Display ads that drive installs of an app.
    LINE_ITEM_TYPE_VIDEO_DEFAULT Video ads sold on a CPM basis for a variety of environments.
    LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL Video ads that drive installs of an app.
    LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INVENTORY

    Display ads served on mobile app inventory.

    Line items of this type and their targeting cannot be created or updated using the API.
    LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INVENTORY

    Video ads served on mobile app inventory.

    Line items of this type and their targeting cannot be created or updated using the API.
    LINE_ITEM_TYPE_AUDIO_DEFAULT RTB Audio ads sold for a variety of environments.
    LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP Over-the-top ads present in OTT insertion orders. This type is only applicable to line items with an insertion order of insertionOrderType OVER_THE_TOP .
    LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION

    YouTube video ads that promote conversions.

    Line items of this type and their targeting cannot be created or updated using the API.
    LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE

    YouTube video ads (up to 15 seconds) that cannot be skipped.

    Line items of this type and their targeting cannot be created or updated using the API.
    LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE

    YouTube video ads that show a story in a particular sequence using a mix of formats.

    Line items of this type and their targeting cannot be created or updated using the API.
    LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIO

    YouTube audio ads.

    Line items of this type and their targeting cannot be created or updated using the API.
    LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH

    YouTube video ads that optimize reaching more unique users at lower cost. May include bumper ads, skippable in-stream ads, or a mix of types.

    Line items of this type and their targeting cannot be created or updated using the API.
    LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE

    Default YouTube video ads.

    Line items of this type and their targeting cannot be created or updated using the API.
    LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOP

    Connected TV youTube video ads (up to 15 seconds) that cannot be skipped.

    Line items of this type and their targeting cannot be created or updated using the API.
    LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP

    Connected TV youTube video ads that optimize reaching more unique users at lower cost. May include bumper ads, skippable in-stream ads, or a mix of types.

    Line items of this type and their targeting cannot be created or updated using the API.
    LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOP

    Connected TV default YouTube video ads. Only include in-stream ad-format.

    Line items of this type and their targeting cannot be created or updated using the API.
    LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCY

    The goal of this line item type is to show the YouTube ads target number of times to the same person in a certain period of time.

    Line items of this type and their targeting cannot be created or updated using the API.
    LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIEW

    YouTube video ads that aim to get more views with a variety of ad formats.

    Line items of this type and their targeting cannot be created or updated using the API.
    LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME

    Display ads served on digital-out-of-home inventory.

    Line items of this type and their targeting cannot be created or updated using the API.
    LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME

    Video ads served on digital-out-of-home inventory.

    Line items of this type and their targeting cannot be created or updated using the API.

    LineItemFlight

    Settings that control the active duration of a line item.

    JSON representation 
     { 
 "flightDateType" 
 : 
 enum (  LineItemFlightDateType 
 
) 
 , 
 "dateRange" 
 : 
 { 
 object (  DateRange 
 
) 
 } 
 }
    Fields
    flightDateType

    enum ( LineItemFlightDateType )

    Required. The type of the line item's flight dates.

    dateRange

    object ( DateRange )

    The flight start and end dates of the line item. They are resolved relative to the parent advertiser's time zone.

    • Required when flightDateType is LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM . Output only otherwise.
    • When creating a new flight, both startDate and endDate must be in the future.
    • An existing flight with a startDate in the past has a mutable endDate but an immutable startDate .
    • endDate must be the startDate or later, both before the year 2037.

    LineItemFlightDateType

    Possible types of a line item's flight dates.

    Enums
    LINE_ITEM_FLIGHT_DATE_TYPE_UNSPECIFIED Type value is not specified or is unknown in this version.
    LINE_ITEM_FLIGHT_DATE_TYPE_INHERITED The line item's flight dates are inherited from its parent insertion order.
    LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM The line item uses its own custom flight dates.

    LineItemBudget

    Settings that control how budget is allocated.

    JSON representation 
     { 
 "budgetAllocationType" 
 : 
 enum (  LineItemBudgetAllocationType 
 
) 
 , 
 "budgetUnit" 
 : 
 enum (  BudgetUnit 
 
) 
 , 
 "maxAmount" 
 : 
 string 
 }
    Fields
    budgetAllocationType

    enum ( LineItemBudgetAllocationType )

    Required. The type of the budget allocation.

    LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC is only applicable when automatic budget allocation is enabled for the parent insertion order.

    budgetUnit

    enum ( BudgetUnit )

    Output only. The budget unit specifies whether the budget is currency based or impression based. This value is inherited from the parent insertion order.

    maxAmount

    string ( int64 format)

    The maximum budget amount the line item will spend. Must be greater than 0.

    When budgetAllocationType is:

    • LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC , this field is immutable and is set by the system.
    • LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED , if budgetUnit is:
      • BUDGET_UNIT_CURRENCY , this field represents maximum budget amount to spend, in micros of the advertiser's currency. For example, 1500000 represents 1.5 standard units of the currency.
      • BUDGET_UNIT_IMPRESSIONS , this field represents the maximum number of impressions to serve.
    • LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED , this field is not applicable and will be ignored by the system.

    LineItemBudgetAllocationType

    Possible types of the budget allocation.

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

    PartnerRevenueModel

    Settings that control how partner revenue is calculated.

    JSON representation 
     { 
 "markupType" 
 : 
 enum (  PartnerRevenueModelMarkupType 
 
) 
 , 
 "markupAmount" 
 : 
 string 
 }
    Fields
    markupType

    enum ( PartnerRevenueModelMarkupType )

    Required. The markup type of the partner revenue model.

    markupAmount

    string ( int64 format)

    Required. The markup amount of the partner revenue model. Must be greater than or equal to 0.

    • When the markupType 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 markupType 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 markupType is set to be PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP , this field represents the total media cost percent markup in millis. For example, 100 represents 0.1% (decimal 0.001).

    PartnerRevenueModelMarkupType

    Possible markup types of the partner revenue model.

    Enums
    PARTNER_REVENUE_MODEL_MARKUP_TYPE_UNSPECIFIED Type value is not specified or is unknown in this version.
    PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM Calculate the partner revenue based on a fixed CPM.
    PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP

    Calculate the partner revenue based on a percentage surcharge of its media cost.
    PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP Calculate the partner revenue based on a percentage surcharge of its total media cost, which includes all partner costs and data costs.

    ConversionCountingConfig

    Settings that control how conversions are counted.

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

    JSON representation 
     { 
 "postViewCountPercentageMillis" 
 : 
 string 
 , 
 "floodlightActivityConfigs" 
 : 
 [ 
 { 
 object (  TrackingFloodlightActivityConfig 
 
) 
 } 
 ] 
 }
    Fields
    postViewCountPercentageMillis

    string ( int64 format)

    The percentage of post-view conversions to count, in millis (1/1000 of a percent). Must be between 0 and 100000 inclusive.

    For example, to track 50% of the post-click conversions, set a value of 50000.
    floodlightActivityConfigs[]

    object ( 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.

    TrackingFloodlightActivityConfig

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

    JSON representation 
     { 
 "floodlightActivityId" 
 : 
 string 
 , 
 "postClickLookbackWindowDays" 
 : 
 integer 
 , 
 "postViewLookbackWindowDays" 
 : 
 integer 
 }
    Fields
    floodlightActivityId

    string ( int64 format)

    Required. The ID of the Floodlight activity.
    postClickLookbackWindowDays

    integer

    Required. The number of days after an ad has been clicked in which a conversion may be counted. Must be between 0 and 90 inclusive.
    postViewLookbackWindowDays

    integer

    Required. The number of days after an ad has been viewed in which a conversion may be counted. Must be between 0 and 90 inclusive.

    LineItemWarningMessage

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

    Enums
    LINE_ITEM_WARNING_MESSAGE_UNSPECIFIED Not specified or is unknown.
    INVALID_FLIGHT_DATES This line item has invalid flight dates. The line item will not run.
    EXPIRED This line item's end date is in the past.
    PENDING_FLIGHT This line item will begin running in the future.
    ALL_PARTNER_ENABLED_EXCHANGES_NEGATIVELY_TARGETED All partner enabled exchanges are negatively targeted. The line item will not run.
    INVALID_INVENTORY_SOURCE No active inventory sources are being targeted. The line item will not run.
    APP_INVENTORY_INVALID_SITE_TARGETING This line item's Apps & URLs targeting doesn't include any mobile apps. This line item's type requires you to include mobile apps in your channel, sitelist, or apps targeting. The line item will not run.
    APP_INVENTORY_INVALID_AUDIENCE_LISTS This line item isn't targeting any mobile users. This line item's type requires you to target a user list with mobile users. The line item will not run.
    NO_VALID_CREATIVE This line item does not contain any valid creative. The line item will not run.
    PARENT_INSERTION_ORDER_PAUSED The insertion order of this line item is paused. The line item will not run.
    PARENT_INSERTION_ORDER_EXPIRED The insertion order of this line item has its end date set in the past. The line item will not run.

    MobileApp

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

    JSON representation 
     { 
 "appId" 
 : 
 string 
 , 
 "platform" 
 : 
 enum (  Platform 
 
) 
 , 
 "displayName" 
 : 
 string 
 , 
 "publisher" 
 : 
 string 
 }
    Fields
    appId

    string

    Required. The ID of the app provided by the platform store.

    Android apps are identified by the bundle ID used by Android's Play store, such as com.google.android.gm .

    iOS apps are identified by a nine-digit app ID used by Apple's App store, such as 422689480 .
    platform

    enum ( Platform )

    Output only. The app platform.
    displayName

    string

    Output only. The app name.
    publisher

    string

    Output only. The app publisher.

    Platform

    Possible mobile app platforms.

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

    YoutubeAndPartnersSettings

    Settings for YouTube and Partners line items.

    JSON representation 
     { 
 "viewFrequencyCap" 
 : 
 { 
 object (  FrequencyCap 
 
) 
 } 
 , 
 "thirdPartyMeasurementConfigs" 
 : 
 { 
 object (  ThirdPartyMeasurementConfigs 
 
) 
 } 
 , 
 "inventorySourceSettings" 
 : 
 { 
 object (  YoutubeAndPartnersInventorySourceConfig 
 
) 
 } 
 , 
 "contentCategory" 
 : 
 enum (  YoutubeAndPartnersContentCategory 
 
) 
 , 
 "effectiveContentCategory" 
 : 
 enum (  YoutubeAndPartnersContentCategory 
 
) 
 , 
 "targetFrequency" 
 : 
 { 
 object (  TargetFrequency 
 
) 
 } 
 , 
 "linkedMerchantId" 
 : 
 string 
 , 
 "relatedVideoIds" 
 : 
 [ 
 string 
 ] 
 , 
 "leadFormId" 
 : 
 string 
 , 
 "videoAdSequenceSettings" 
 : 
 { 
 object (  VideoAdSequenceSettings 
 
) 
 } 
 , 
 "videoAdInventoryControl" 
 : 
 { 
 object (  VideoAdInventoryControl 
 
) 
 } 
 }
    Fields
    viewFrequencyCap

    object ( FrequencyCap )

    The view frequency cap settings of the line item.

    The maxViews field in this settings object must be used if assigning a limited cap.
    thirdPartyMeasurementConfigs

    object ( ThirdPartyMeasurementConfigs )

    Optional. The third-party measurement configs of the line item.
    inventorySourceSettings

    object ( YoutubeAndPartnersInventorySourceConfig )

    Settings that control what YouTube and Partners inventories the line item will target.
    contentCategory

    enum ( YoutubeAndPartnersContentCategory )

    Output only. The kind of content on which the YouTube and Partners ads will be shown.
    effectiveContentCategory

    enum ( YoutubeAndPartnersContentCategory )

    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.
    targetFrequency

    object ( TargetFrequency )

    Optional. The average number of times you want ads from this line item to show to the same person over a certain period of time.
    linkedMerchantId

    string ( int64 format)

    Optional. The ID of the merchant which is linked to the line item for product feed.
    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.
    leadFormId

    string ( int64 format)

    Optional. The ID of the form to generate leads.
    videoAdSequenceSettings

    object ( VideoAdSequenceSettings )

    Optional. The settings related to VideoAdSequence.
    videoAdInventoryControl

    object ( VideoAdInventoryControl )

    Optional. The settings to control which inventory is allowed for this line item.

    ThirdPartyMeasurementConfigs

    Settings that control what third-party vendors are measuring specific line item metrics.

    JSON representation 
     { 
 "viewabilityVendorConfigs" 
 : 
 [ 
 { 
 object (  ThirdPartyVendorConfig 
 
) 
 } 
 ] 
 , 
 "brandSafetyVendorConfigs" 
 : 
 [ 
 { 
 object (  ThirdPartyVendorConfig 
 
) 
 } 
 ] 
 , 
 "reachVendorConfigs" 
 : 
 [ 
 { 
 object (  ThirdPartyVendorConfig 
 
) 
 } 
 ] 
 , 
 "brandLiftVendorConfigs" 
 : 
 [ 
 { 
 object (  ThirdPartyVendorConfig 
 
) 
 } 
 ] 
 }
    Fields
    viewabilityVendorConfigs[]

    object ( 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
    brandSafetyVendorConfigs[]

    object ( 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
    reachVendorConfigs[]

    object ( 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
    brandLiftVendorConfigs[]

    object ( 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_NIELSEN

    ThirdPartyVendorConfig

    Settings that control how third-party measurement vendors are configured.

    JSON representation 
     { 
 "vendor" 
 : 
 enum (  ThirdPartyVendor 
 
) 
 , 
 "placementId" 
 : 
 string 
 }
    Fields
    vendor

    enum ( ThirdPartyVendor )

    The third-party measurement vendor.
    placementId

    string

    The ID used by the platform of the third-party vendor to identify the line item.

    ThirdPartyVendor

    Vendors who perform third-party measurement.

    Enums
    THIRD_PARTY_VENDOR_UNSPECIFIED Unknown third-party vendor.
    THIRD_PARTY_VENDOR_MOAT Moat.
    THIRD_PARTY_VENDOR_DOUBLE_VERIFY DoubleVerify.
    THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE Integral Ad Science.
    THIRD_PARTY_VENDOR_COMSCORE Comscore.
    THIRD_PARTY_VENDOR_TELEMETRY Telemetry.
    THIRD_PARTY_VENDOR_MEETRICS Meetrics.
    THIRD_PARTY_VENDOR_ZEFR ZEFR.
    THIRD_PARTY_VENDOR_NIELSEN Nielsen.
    THIRD_PARTY_VENDOR_KANTAR Kantar.
    THIRD_PARTY_VENDOR_DYNATA Dynata.
    THIRD_PARTY_VENDOR_TRANSUNION Transunion.

    YoutubeAndPartnersInventorySourceConfig

    Settings that control what YouTube related inventories the YouTube and Partners line item will target.

    JSON representation 
     { 
 "includeYoutube" 
 : 
 boolean 
 , 
 "includeGoogleTv" 
 : 
 boolean 
 , 
 "includeYoutubeVideoPartners" 
 : 
 boolean 
 }
    Fields
    includeYoutube

    boolean

    Optional. Whether to target inventory on YouTube. This includes both search, channels and videos.
    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.

    YoutubeAndPartnersContentCategory

    Brand safety categories for YouTube and Partners content.

    Enums
    YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_UNSPECIFIED Content category is not specified or is unknown in this version.
    YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_STANDARD A category consisting of a wide range of content appropriate for most brands. The content is based off of YouTube's advertiser-friendly content guidelines .
    YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_EXPANDED A category including all content across YouTube and video partners that meets standards for monetization.
    YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_LIMITED A category consisting of a reduced range of content that meets heightened requirements, especially regarding inappropriate language and sexual suggestiveness.

    TargetFrequency

    Setting that controls the average number of times the ads will show to the same person over a certain period of time.

    JSON representation 
     { 
 "targetCount" 
 : 
 string 
 , 
 "timeUnit" 
 : 
 enum (  TimeUnit 
 
) 
 , 
 "timeUnitCount" 
 : 
 integer 
 }
    Fields
    targetCount

    string ( int64 format)

    The target number of times, on average, the ads will be shown to the same person in the timespan dictated by timeUnit and timeUnitCount .

    timeUnit

    enum ( TimeUnit )

    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 timeUnit the target frequency will last.

    The following restrictions apply based on the value of timeUnit :

    • TIME_UNIT_WEEKS - must be 1

    VideoAdSequenceSettings

    Settings related to VideoAdSequence.

    JSON representation 
     { 
 "minimumDuration" 
 : 
 enum (  VideoAdSequenceMinimumDuration 
 
) 
 , 
 "steps" 
 : 
 [ 
 { 
 object (  VideoAdSequenceStep 
 
) 
 } 
 ] 
 }
    Fields
    minimumDuration

    enum ( VideoAdSequenceMinimumDuration )

    The minimum time interval before the same user sees this sequence again.
    steps[]

    object ( VideoAdSequenceStep )

    The steps of which the sequence consists.

    VideoAdSequenceMinimumDuration

    The enum for possible minimum interval time before the same user sees the VideoAdSequence again.

    Enums
    VIDEO_AD_SEQUENCE_MINIMUM_DURATION_UNSPECIFIED Unspecified or unknown.
    VIDEO_AD_SEQUENCE_MINIMUM_DURATION_WEEK 7 days.
    VIDEO_AD_SEQUENCE_MINIMUM_DURATION_MONTH 30 days.

    VideoAdSequenceStep

    The detail of a single step in a VideoAdSequence.

    JSON representation 
     { 
 "stepId" 
 : 
 string 
 , 
 "adGroupId" 
 : 
 string 
 , 
 "previousStepId" 
 : 
 string 
 , 
 "interactionType" 
 : 
 enum (  InteractionType 
 
) 
 }
    Fields
    stepId

    string ( int64 format)

    The ID of the step.
    adGroupId

    string ( int64 format)

    The ID of the corresponding ad group of the step.
    previousStepId

    string ( int64 format)

    The ID of the previous step. The first step does not have previous step.
    interactionType

    enum ( InteractionType )

    The interaction on the previous step that will lead the viewer to this step. The first step does not have interactionType.

    InteractionType

    The types of the interaction on a step.

    Enums
    INTERACTION_TYPE_UNSPECIFIED Unspecified or unknown
    INTERACTION_TYPE_PAID_VIEW A paid view.
    INTERACTION_TYPE_SKIP Skipped by the viewer.
    INTERACTION_TYPE_IMPRESSION A (viewed) ad impression.
    INTERACTION_TYPE_ENGAGED_IMPRESSION An ad impression that was not immediately skipped by the viewer, but didn't reach the billable event either.

    VideoAdInventoryControl

    The video ad inventory control used in certain YouTube line item types.

    JSON representation 
     { 
 "allowInStream" 
 : 
 boolean 
 , 
 "allowInFeed" 
 : 
 boolean 
 , 
 "allowShorts" 
 : 
 boolean 
 }
    Fields
    allowInStream

    boolean

    Optional. Whether ads can serve as in-stream format.
    allowInFeed

    boolean

    Optional. Whether ads can serve as in-feed format.
    allowShorts

    boolean

    Optional. Whether ads can serve as shorts format.

    Methods

    bulkEditAssignedTargetingOptions

    		Bulk edits targeting options under multiple line items.

    bulkListAssignedTargetingOptions

    		Lists assigned targeting options for multiple line items across targeting types.

    bulkUpdate

    		Updates multiple line items.

    create

    		Creates a new line item.

    delete

    		Deletes a line item.

    duplicate

    		Duplicates a line item.

    generateDefault

    		Creates a new line item with settings (including targeting) inherited from the insertion order and an ENTITY_STATUS_DRAFT entity_status .

    get

    		Gets a line item.

    list

    		Lists line items in an advertiser.

    patch

    		Updates an existing line item.
    Create a Mobile Website
    View Site in Mobile | Classic
    Share by: