type SetTopBoxLineItemError (v202308)
Errors associated with set-top box line items.
- Namespace
-
https://www.google.com/apis/ads/publisher/v202308
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_TARGETED
- The 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_TARGETED
- The set-top box line item must target at least one ad unit.
-
CANNOT_EXCLUDE_AD_UNITS
- The set-top box line item cannot exclude ad units.
-
POD_POSITION_OUT_OF_RANGE
- The set-top box line item can only target pod positions 1 - 15.
-
MIDROLL_POSITION_OUT_OF_RANGE
- The set-top box line item can only target midroll positions 4 - 100.
-
FEATURE_NOT_ENABLED
- The set-top box feature is not enabled.
-
INVALID_ENVIRONMENT_TYPE
- Only EnvironmentType.VIDEO_PLAYER is supported for set-top box line items.
-
COMPANIONS_NOT_SUPPORTED
- Companions are not supported for set-top box line items.
-
INVALID_CREATIVE_SIZE
- Set-top box line items only support sizes supported by Canoe.
-
INVALID_LINE_ITEM_TYPE
- Set-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_TYPE
- Set-top box line items only support CostType.CPM.
-
COST_PER_UNIT_NOT_ALLOWED
- Set-top box line items do not support a cost per unit.
-
DISCOUNT_NOT_ALLOWED
- Set-top box line items do not support discounts.
-
FRONTLOADED_DELIVERY_RATE_NOT_SUPPORTED
- Set-top box line items do not support DeliveryRateType.FRONTLOADED.
-
INVALID_LINE_ITEM_STATUS_CHANGE
- Set-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_PRIORITY
- Set-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_INCREASING
- When 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_ZERO
- When 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_ITEMS
- Set Top box line items cannot be unarchived.
-
COPY_SET_TOP_BOX_ENABLED_LINE_ITEM_NOT_ALLOWED
- Set-top box enabled line items cannot be copied for V0 of the video Canoe campaign push.
-
INVALID_LINE_ITEM_TYPE_CHANGE
- Standard 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_WEIGHTED
- Set-top box line items can only have a creative rotation type of
CreativeRotationType.EVEN or CreativeRotationType.MANUAL.
-
INVALID_FREQUENCY_CAP_TIME_UNIT
- Set-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_RANGE
- Set-top box line items can only have specific time ranges for certain time units:
-
INVALID_PRIMARY_GOAL_UNIT_TYPE
- Set-top box line items can only have a unit type of UnitType.IMPRESSIONS.
-
UNKNOWN
- The 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 2023-08-22 UTC.
[null,null,["Last updated 2023-08-22 UTC."],[[["Set-top box line items can only target ad units with external set-top box channel IDs and must target at least one ad unit without exclusions."],["They support specific line item types, cost types, creative sizes, and priorities, and are subject to restrictions on companions, discounts, and delivery rates."],["These line items use a revision number for synchronization with Canoe, requiring increasing values for updates, and cannot be unarchived or copied in V0 of the video Canoe campaign push."],["Frequency capping is restricted to specific time units and ranges, primary goals are limited to impressions, and creative rotation must be even or weighted."],["Standard set-top box line items cannot be changed to House or Sponsorship types, and orders containing Standard type items cannot include House or Sponsorship types."]]],[]]