type AudienceExtensionError (v202505)

  • AudienceExtensionError is associated with errors occurring in audience extension enabled line items within the Ad Manager API.

  • This error type inherits from ApiError and includes fields such as fieldPath, fieldPathElements, trigger, and errorString to provide details about the error.

  • The reason field of AudienceExtensionError specifies the cause of the error using an enum, listing various reasons like invalid targeting, unsupported features, and budget issues.

  • Several specific reasons for AudienceExtensionError indicate restrictions or limitations on audience extension line items, such as not supporting frequency caps or certain creative rotations.
Service
ForecastService LineItemCreativeAssociationService LineItemService LineItemTemplateService OrderService
Inheritance
ApiError
▼
ApiVersionError AssetError AudienceExtensionError AudienceSegmentError AuthenticationError ClickTrackingLineItemError CollectionSizeError CommonError CompanyCreditStatusError CreativeError CrossSellError CurrencyCodeError CustomFieldValueError CustomTargetingError DateTimeRangeTargetingError DayPartTargetingError EntityChildrenLimitReachedE... EntityLimitReachedError FeatureError ForecastError FrequencyCapError GenericTargetingError GeoTargetingError GrpSettingsError ImageError InternalApiError InvalidUrlError InventoryTargetingError 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 audience extension enabled line items

Namespace
https://www.google.com/apis/ads/publisher/v202505

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.

AudienceExtensionError

reason

AudienceExtensionError.Reason

The error reason represented by an enum.

Enumerations
FREQUENCY_CAPS_NOT_SUPPORTED
Frequency caps are not supported by audience extension line items
INVALID_TARGETING
Audience extension line items can only target geography
INVENTORY_UNIT_TARGETING_INVALID
Audience extension line items can only target audience extension inventory units
INVALID_CREATIVE_ROTATION
Audience extension line items do not support CreativeRotationType.SEQUENTIAL.
INVALID_EXTERNAL_ENTITY_ID
The given ID of the external entity is not valid
INVALID_LINE_ITEM_TYPE
Audience extension line items only support LineItemType.STANDARD.
INVALID_MAX_BID
Audience extension max bid is invalid when it is greater then the max budget.
AUDIENCE_EXTENSION_BULK_UPDATE_NOT_ALLOWED
Bulk update for audience extension line items is not allowed.
UNEXPECTED_AUDIENCE_EXTENSION_ERROR
An unexpected error occurred.
MAX_DAILY_BUDGET_AMOUNT_EXCEEDED
The value entered for the maximum daily budget on an audience extension line item exceeds the maximum allowed.
EXTERNAL_CAMPAIGN_ALREADY_EXISTS
Creating a campaign for a line item that already has an associated campaign is not allowed.
AUDIENCE_EXTENSION_WITHOUT_FEATURE
Audience extension was specified on a line item but the feature was not enabled.
AUDIENCE_EXTENSION_WITHOUT_LINKED_ACCOUNT
Audience extension was specified on a line item but no audience extension account has been linked.
CANNOT_OVERRIDE_CREATIVE_SIZE_WITH_AUDIENCE_EXTENSION
Assocation creative size overrides are not allowed with audience extension.
CANNOT_OVERRIDE_FIELD_WITH_AUDIENCE_EXTENSION
Some association overrides are not allowed with audience extension.
ONLY_ONE_CREATIVE_PLACEHOLDER_ALLOWED
Only one creative placeholder is allowed for an audience extension line item.
MULTIPLE_AUDIENCE_EXTENSION_LINE_ITEMS_ON_ORDER
Only one audience extension line item can be associated with a given order.
CANNOT_COPY_AUDIENCE_EXTENSION_LINE_ITEMS_AND_CREATIVES_TOGETHER
Audience extension line items must be copied separately from their associated creatives.
FEATURE_DEPRECATED
Audience extension is no longer supported and cannot be used.
UNKNOWN
The value returned if the actual value is not exposed by the requested API version.