type SetTopBoxLineItemError (v202502)
    
    
      
    
    
      
      Stay organized with collections
    
    
      
      Save and categorize content based on your preferences.
    
  
  
      
    
  
  
  
  
  
    
  
  
    
    
      
         
         
         
         Errors associated with set-top box line items.
         
         
            - Namespace
- 
               https://www.google.com/apis/ads/publisher/v202502
               
                  
                     | Field | 
               
               
                  
                     | ApiError(inherited) | 
                  
                     | 
                           fieldPath | 
                           
                              xsd:string The OGNL field path to identify cause of error.
 | 
                  
                     | 
                           fieldPathElements | 
                           
                              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)}.
 | 
                  
                     | 
                           trigger | 
                           
                              xsd:string The data that caused the error.
 | 
                  
                     | 
                           errorString | 
                           
                              xsd:string A simple string representation of the error and reason.
 | 
                  
                     | SetTopBoxLineItemError | 
                  
                     | 
                           reason | 
                           
                              SetTopBoxLineItemError.Reason
                            The error reason represented by an enum.
 Enumerations
 
                              
                                 NON_SET_TOP_BOX_AD_UNIT_TARGETEDThe set-top box line item cannot target an ad unit that doesn't have an external
                set-top box channel ID.
                                 AT_LEAST_ONE_AD_UNIT_MUST_BE_TARGETEDThe set-top box line item must target at least one ad unit.
                                 CANNOT_EXCLUDE_AD_UNITSThe set-top box line item cannot exclude ad units.
                                 POD_POSITION_OUT_OF_RANGEThe set-top box line item can only target pod positions 1 - 15.
                                 MIDROLL_POSITION_OUT_OF_RANGEThe set-top box line item can only target midroll positions 4 - 100.
                                 FEATURE_NOT_ENABLEDThe set-top box feature is not enabled.
                                 INVALID_ENVIRONMENT_TYPEOnly EnvironmentType.VIDEO_PLAYER is supported for set-top box line items.
                                 COMPANIONS_NOT_SUPPORTEDCompanions are not supported for set-top box line items.
                                 INVALID_CREATIVE_SIZESet-top box line items only support sizes supported by Canoe.
                                 INVALID_LINE_ITEM_TYPESet-top box line items only support LineItemType.STANDARD,
                LineItemType.HOUSE, and LineItemType.SPONSORSHIP line item types.
                                 ORDERS_WITH_STANDARD_LINE_ITEMS_CANNOT_CONTAIN_HOUSE_OR_SPONSORSHIP_LINE_ITEMS
                                 orders containing LineItemType.STANDARD set-top box line items cannot
                contain set-top box line items of type LineItemType.HOUSE or
                LineItemType.SPONSORSHIP.
                                 INVALID_COST_TYPESet-top box line items only support CostType.CPM.
                                 COST_PER_UNIT_NOT_ALLOWEDSet-top box line items do not support a cost per unit.
                                 DISCOUNT_NOT_ALLOWEDSet-top box line items do not support discounts.
                                 FRONTLOADED_DELIVERY_RATE_NOT_SUPPORTEDSet-top box line items do not support DeliveryRateType.FRONTLOADED.
                                 INVALID_LINE_ITEM_STATUS_CHANGESet-top box line items cannot go from a state that is ready to be synced to a
                state that is not ready to be synced.
                                 INVALID_LINE_ITEM_PRIORITYSet-top box line items can only have certain priorities for different
                reservation types:
                                    
                                       ReservationType.SPONSORSHIP=> 1
                                       ReservationType.HOUSE=> 16
                                       ReservationType.STANDARD=> Between 1 and 16 inclusive.
                                 SYNC_REVISION_NOT_INCREASINGWhen a set-top box line item is pushed to Canoe, a revision number is used to keep track of
                the last version of the line item that Ad Manager synced with Canoe. The only change
                allowed on revisions within Ad Manager is increasing the revision number.
                                 SYNC_REVISION_MUST_BE_GREATER_THAN_ZEROWhen a set-top box line item is pushed to Canoe, a revision number is used to keep track of
                the last version of the line item that Ad Manager synced with Canoe. Sync revisions begin
                at one and can only increase in value.
                                 CANNOT_UNARCHIVE_SET_TOP_BOX_LINE_ITEMSSet Top box line items cannot be unarchived.
                                 COPY_SET_TOP_BOX_ENABLED_LINE_ITEM_NOT_ALLOWEDSet-top box enabled line items cannot be copied for V0 of the video Canoe campaign push.
                                 INVALID_LINE_ITEM_TYPE_CHANGEStandard set-top box line items cannot be updated to be LineItemType.House or
                LineItemType.Sponsorship line items and vice versa.
                                 CREATIVE_ROTATION_TYPE_MUST_BE_EVENLY_OR_WEIGHTEDSet-top box line items can only have a creative rotation type of
                CreativeRotationType.EVENor CreativeRotationType.MANUAL.
                                 INVALID_FREQUENCY_CAP_TIME_UNITSet-top box line items can only have frequency capping with time units of
                TimeUnit.DAY, TimeUnit.HOUR, TimeUnit.POD, or
                TimeUnit.STREAM.
                                 INVALID_FREQUENCY_CAP_TIME_RANGESet-top box line items can only have specific time ranges for certain time units:
                
                              
                                 INVALID_PRIMARY_GOAL_UNIT_TYPESet-top box line items can only have a unit type of UnitType.IMPRESSIONS.
                                 UNKNOWNThe value returned if the actual value is not exposed by the requested API version.
 | 
               
            
         
       
   
  
  
    
  
 
  
    
    
      
       
    
    
  
  
  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 provided content outlines error types and service operations within an ad management API, specifically focusing on `SetTopBoxLineItemError`. It details that set-top box line items have constraints, including limitations on ad unit targeting, supported environments, creative types, and cost models. Key restrictions include not supporting excluded ad units, companions, or discounts, with only specific line item types (STANDARD, HOUSE, SPONSORSHIP) and cost types (CPM) allowed. Also, frequency capping, and creative rotation. Finally, sync revision tracking is used to manage changes.\n"]]