type LineItemTemplate (v202502)
    
    
      
    
    
      
      Stay organized with collections
    
    
      
      Save and categorize content based on your preferences.
    
  
  
      
    
  
  
  
  
  
    
  
  
    
    
      
         
         
         
            
               
                  Service
               
               
                  LineItemTemplateService
               
            
            
         
         Represents the template that populates the fields of a new line item being created.
         
         
            - Namespace
- 
               https://www.google.com/apis/ads/publisher/v202502
               
                  
                     | Field | 
               
               
                  
                     | 
                           id | 
                           
                              xsd:long Uniquely identifies the LineItemTemplate. This attribute is read-only and is assigned
                by Google when a template is created. | 
                  
                     | 
                           name | 
                           
                              xsd:string The name of the LineItemTemplate. This attribute is required. | 
                  
                     | 
                           isDefault | 
                           
                              xsd:boolean Whether or not the LineItemTemplaterepresents the default choices for creating aLineItem. Only one defaultLineItemTemplateis allowed perNetwork.
                This attribute is readonly. | 
                  
                     | 
                           lineItemName | 
                           
                              xsd:string The default name of a new LineItem. This attribute is optional
                and has a maximum length of 127 characters. | 
                  
                     | 
                           enabledForSameAdvertiserException | 
                           
                              xsd:boolean The default value for the LineItem.enabledForSameAdvertiserException field of a new
                LineItem. This attribute is required. | 
                  
                     | 
                           notes | 
                           
                              xsd:string The default notes for a new LineItem. This attribute is optional
                and has a maximum length of 65,535 characters. | 
                  
                     | 
                           lineItemType | 
                           
                              LineItemType
                            The default type of a new LineItem. This attribute is
                required. Enumerations
 
                              
                                 SPONSORSHIPThe type of LineItem for which a percentage of all the impressions that are being sold
                are reserved.
                                 STANDARDThe type of LineItem for which a fixed quantity of impressions or clicks are reserved.
                                 NETWORKThe type of LineItem most commonly used to fill a site's unsold
                inventory if not contractually obligated to deliver a requested number of
                impressions. Users specify the daily percentage of unsold impressions or
                clicks when creating this line item.
                                 BULKThe type of LineItem for which a fixed quantity of impressions or
                clicks will be delivered at a priority lower than the
                LineItemType.STANDARD type.
                                 PRICE_PRIORITYThe type of LineItem most commonly used to fill a site's unsold
                inventory if not contractually obligated to deliver a requested number of
                impressions. Users specify the fixed quantity of unsold impressions or
                clicks when creating this line item.
                                 HOUSEThe type of LineItem typically used for ads that promote products
                and services chosen by the publisher. These usually do not generate revenue
                and have the lowest delivery priority.
                                 LEGACY_DFPRepresents a legacy LineItem that has been migrated from the DFP
                system. Such line items cannot be created any more. Also, these line items
                cannot be activated or resumed.
                                 CLICK_TRACKINGThe type of LineItem used for ads that track ads being served
                externally of Ad Manager, for example an email newsletter. The click through would
                reference this ad, and the click would be tracked via this ad.
                                 ADSENSEA LineItem using dynamic allocation backed by AdSense.
                                 AD_EXCHANGEA LineItem using dynamic allocation backed by the Google Ad Exchange.
                                 BUMPERRepresents a non-monetizable video LineItem that targets one or
                more bumper positions, which are short house video messages used by
                publishers to separate content from ad breaks.
                                 ADMOBA LineItem using dynamic allocation backed by AdMob.
                                 PREFERRED_DEALThe type of LineItem for which there are no impressions reserved, and will serve for a
                second price bid. All LineItems of type LineItemType.PREFERRED_DEAL should
                be created via a ProposalLineItem with a matching  type. When creating a
                LineItem of type LineItemType.PREFERRED_DEAL, the
                ProposalLineItem.estimatedMinimumImpressions field is required.
                                 UNKNOWNThe value returned if the actual value is not exposed by the requested API
                version.
 | 
                  
                     | 
                           deliveryRateType | 
                           
                              DeliveryRateType
                            The default delivery strategy for a new LineItem.
                This attribute is required. Enumerations
 
                              
                                 EVENLYLine items are served as evenly as possible across the number of
                days specified in a line item's LineItem.duration.
                                 FRONTLOADEDLine items are served more aggressively in the beginning of the flight
                date.
                                 AS_FAST_AS_POSSIBLEThe booked impressions for a line item may be delivered well before the
                LineItem.endDateTime. Other lower-priority or lower-value line
                items will be stopped from delivering until this line item meets the number
                of impressions or clicks it is booked for.
 | 
                  
                     | 
                           roadblockingType | 
                           
                              RoadblockingType
                            The default roadblocking strategy for a new LineItem.
                This attribute is required. Enumerations
 
                              
                                 ONLY_ONEOnly one creative from a line item can serve at a time.
                                 ONE_OR_MOREAny number of creatives from a line item can serve together at a time.
                                 AS_MANY_AS_POSSIBLEAs many creatives from a line item as can fit on a page will serve. This
                could mean anywhere from one to all of a line item's creatives given the
                size constraints of ad slots on a page.
                                 ALL_ROADBLOCKAll or none of the creatives from a line item will serve. This option will only work if
                served to a GPT tag using SRA (single request architecture mode).
                                 CREATIVE_SETA master/companion CreativeSet roadblocking type.
                A LineItem.creativePlaceholders must be set accordingly.
 | 
                  
                     | 
                           creativeRotationType | 
                           
                              CreativeRotationType
                            The default creative rotation strategy for a new LineItem. This attribute is required. Enumerations
 
                              
                                 EVENCreatives are displayed roughly the same number of times over
                the duration of the line item.
                                 OPTIMIZEDCreatives are served roughly proportionally to their performance.
                                 MANUALCreatives are served roughly proportionally to their weights, set on the
                LineItemCreativeAssociation.
                                 SEQUENTIALCreatives are served exactly in sequential order, aka Storyboarding.
                Set on the LineItemCreativeAssociation.
 | 
               
            
         
       
   
  
  
    
  
 
  
    
    
      
       
    
    
  
  
  Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
  Last updated 2025-08-06 UTC.
  
  
  
    
      [null,null,["Last updated 2025-08-06 UTC."],[],["The `LineItemTemplateService` manages templates for creating new line items. Key attributes include: `id` (read-only unique identifier), `name` (required), `isDefault` (read-only default indicator), `lineItemName` (optional default name), `enabledForSameAdvertiserException` (required), `notes` (optional), `lineItemType` (required), `deliveryRateType` (required), `roadblockingType` (required), and `creativeRotationType` (required). These attributes define the default configurations for new `LineItem` creation, such as delivery strategy, roadblocking, and creative rotation. The `LineItemType` and the other type parameters have several possible enumerations to select.\n"]]