type AudienceExtensionError (v202508)

AI-generated Key Takeaways

• AudienceExtensionError is an error type in the ForecastService and other services that deals with audience extension enabled line items.

• This error type inherits from ApiError, which includes fields like fieldPath, fieldPathElements, trigger, and errorString.

• AudienceExtensionError has a specific 'reason' field which is an enum indicating the cause of the error, such as invalid targeting, unsupported features, or exceeding limits.

• Possible reasons for this error include issues with frequency caps, targeting, inventory units, creative rotation, external entity IDs, line item types, max bid, bulk updates, daily budget, existing external campaigns, feature enablement, linked accounts, creative size overrides, and the feature being deprecated.

• The AudienceExtension feature is no longer supported and cannot be used, which is a possible reason for this error.

Service

ForecastService LineItemCreativeAssociationService LineItemService LineItemTemplateService OrderService

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 audience extension enabled line items

---

Namespace

https://www.google.com/apis/ads/publisher/v202508

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.