type ProgrammaticError (v202502)

AI-generated Key Takeaways

• ProgrammaticError is an error type specifically for programmatic line items.

• It inherits properties from the ApiError class, including field path, trigger, and error string.

• ProgrammaticError has a specific reason field which is an enum indicating the cause of the error.

• Specific error reasons include unsupported features like audience extension, auto extension days, video, and roadblocks, as well as invalid configurations such as creative rotation, line item type, and cost type.

• There are also errors related to size support, cost per unit, and updating approved line items or orders.

Service

ForecastService LineItemService LineItemTemplateService OrderService ProposalLineItemService ProposalService

Inheritance

ApiError

▼

AdUnitCodeError ApiVersionError AssetError AudienceExtensionError AudienceSegmentError AuthenticationError ClickTrackingLineItemError CollectionSizeError CommonError CompanyCreditStatusError CreativeError CrossSellError CurrencyCodeError CustomFieldValueError CustomTargetingError DateError DateTimeRangeTargetingError DayPartTargetingError EntityChildrenLimitReachedE... EntityLimitReachedError FeatureError ForecastError FrequencyCapError GenericTargetingError GeoTargetingError GrpSettingsError ImageError InternalApiError InvalidUrlError InventoryTargetingError InventoryUnitError LabelEntityAssociationError LineItemActivityAssociation... LineItemCreativeAssociation... LineItemError LineItemFlightDateError LineItemOperationError MobileApplicationTargetingE... NotNullError NullError OrderActionError OrderError ParseError PermissionError PrecisionError ProgrammaticError PublisherQueryLanguageConte... PublisherQueryLanguageSynta... QuotaError RangeError RegExError RequestPlatformTargetingError RequiredCollectionError RequiredError RequiredNumberError RequiredSizeError ReservationDetailsError ServerError SetTopBoxLineItemError StatementError StringFormatError StringLengthError TeamError TechnologyTargetingError TimeZoneError TranscodingError TypeError UniqueError UserDomainTargetingError VideoPositionTargetingError

Errors associated with programmatic 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.
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.