type ProgrammaticError (v202408)
Stay organized with collections
Save and categorize content based on your preferences.
Errors associated with programmatic line items.
- Namespace
-
https://www.google.com/apis/ads/publisher/v202408
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.
|
ProgrammaticError
|
reason
|
ProgrammaticError.Reason
The error reason represented by an enum.
Enumerations
-
AUDIENCE_EXTENSION_NOT_SUPPORTED
- Audience extension is not supported by programmatic line items.
-
AUTO_EXTENSION_DAYS_NOT_SUPPORTED
- Auto extension days is not supported by programmatic line items.
-
VIDEO_NOT_SUPPORTED
- Video is currently not supported.
-
ROADBLOCKING_NOT_SUPPORTED
- Roadblocking is not supported by programmatic line items.
-
INVALID_CREATIVE_ROTATION
- Programmatic line items do not support CreativeRotationType.SEQUENTIAL.
-
INVALID_LINE_ITEM_TYPE
- Programmatic line items only support LineItemType.STANDARD and
LineItemType.SPONSORSHIP if the relevant feature is on.
-
INVALID_COST_TYPE
- Programmatic line items only support CostType.CPM.
-
SIZE_NOT_SUPPORTED
- Programmatic line items only support a creative size that is supported by AdX.
The list of supported sizes is maintained based on the list published in the help docs:
https://support.google.com/adxseller/answer/1100453
-
ZERO_COST_PER_UNIT_NOT_SUPPORTED
- Zero cost per unit is not supported by programmatic line items.
-
CANNOT_UPDATE_FIELD_FOR_APPROVED_LINE_ITEMS
- Some fields cannot be updated on approved line items.
-
CANNOT_CREATE_LINE_ITEM_FOR_APPROVED_ORDER
- Creating a new line item in an approved order is not allowed.
-
CANNOT_UPDATE_BACKFILL_WEB_PROPERTY_FOR_APPROVED_LINE_ITEMS
- Cannot change backfill web property for a programmatic line item whose order has been
approved.
-
COST_PER_UNIT_TOO_LOW
- Cost per unit is too low. It has to be at least 0.005 USD.
-
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 2025-08-06 UTC.
[null,null,["Last updated 2025-08-06 UTC."],[[["\u003cp\u003eForecastService.ProgrammaticError is an error type associated with programmatic line items in Google Ad Manager.\u003c/p\u003e\n"],["\u003cp\u003eThis error can occur due to various reasons, such as unsupported features (audience extension, auto extension days, video, roadblocking), invalid creative rotation, or line item types.\u003c/p\u003e\n"],["\u003cp\u003eProgrammatic line items have specific requirements for creative sizes, cost types, and cost per unit.\u003c/p\u003e\n"],["\u003cp\u003eCertain field updates are restricted for approved line items and orders.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003ereason\u003c/code\u003e field provides a specific enum value indicating the cause of the error.\u003c/p\u003e\n"]]],["The `ForecastService` API handles errors for various services, including `LineItemService`, `OrderService`, and `ProposalService`. It uses an inheritance structure, starting with `ApiError`, then branching into numerous specific error types like `AdUnitCodeError`, `AuthenticationError`, and `QuotaError`. `ProgrammaticError`, a distinct type of error, covers issues specific to programmatic line items. Enumerated reasons for programmatic errors include unsupported features like audience extension, video, creative rotation and invalid cost types or sizes. It also includes restrictions on updating fields or creating new line items in approved orders.\n"],null,[]]