type AudienceExtensionError (v202505)

AI-generated Key Takeaways

• AudienceExtensionError is an error type used across various services including ForecastService, LineItemCreativeAssociationService, LineItemService, LineItemTemplateService, and OrderService.

• This error indicates issues specifically related to line items that have audience extension enabled.

• AudienceExtensionError inherits from ApiError and includes fields like fieldPath, fieldPathElements, trigger, and errorString.

• Specific reasons for AudienceExtensionError include limitations on frequency caps, targeting restrictions to geography and specific inventory units, invalid creative rotation types, invalid external entity IDs, and restrictions on line item types and max bids.

• Other reasons for this error involve issues with bulk updates, exceeding daily budgets, attempting to create multiple campaigns for the same line item, missing feature enablement or linked accounts, and limitations on creative size and field overrides.

• Additional restrictions causing this error are related to the number of creative placeholders allowed, having multiple audience extension line items on an order, limitations when copying line items and creatives, and the deprecation of the audience extension feature.

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/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.