AI-generated Key Takeaways
-
The
CustomTargetingErrorclass in the Ad Manager API (v202505) indicates issues withCustomTargetingKeyandCustomTargetingValueobjects across several services. -
This error class inherits from
ApiErrorand includes fields likefieldPath,trigger, anderrorStringto help identify the error's cause. -
Common error reasons relate to issues with the existence, count, naming, length, characters, status, or usage of both keys and values.
-
Errors can also occur due to invalid targeting expressions or issues with targeting audience segments.
Service
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
InvalidEmailError
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
TemplateInstantiatedCreativ...
TimeZoneError
TranscodingError
TypeError
UniqueError
UserDomainTargetingError
VideoPositionTargetingError
Lists all errors related to CustomTargetingKey and CustomTargetingValue objects.
- 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
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.
CustomTargetingError
reason
Enumerations
-
KEY_NOT_FOUND - Requested CustomTargetingKey is not found.
-
KEY_COUNT_TOO_LARGE - Number of CustomTargetingKey objects created exceeds the limit allowed for the network.
-
KEY_NAME_DUPLICATE - CustomTargetingKey with the same CustomTargetingKey.name already exists.
-
KEY_NAME_EMPTY - CustomTargetingKey.name is empty.
-
KEY_NAME_INVALID_LENGTH - CustomTargetingKey.name is too long.
-
KEY_NAME_INVALID_CHARS - CustomTargetingKey.name contains unsupported or reserved characters.
-
KEY_NAME_RESERVED - CustomTargetingKey.name matches one of the reserved custom targeting key names.
-
KEY_DISPLAY_NAME_INVALID_LENGTH - CustomTargetingKey.displayName is too long.
-
KEY_STATUS_NOT_ACTIVE - Key is not active.
-
VALUE_NOT_FOUND - Requested CustomTargetingValue is not found.
-
GET_VALUES_BY_STATEMENT_MUST_CONTAIN_KEY_ID - The
WHEREclause in the Statement.query must always contain CustomTargetingValue.customTargetingKeyId as one of its columns in a way that it is AND'ed with the rest of the query. -
VALUE_COUNT_FOR_KEY_TOO_LARGE - The number of CustomTargetingValue
objects associated with a CustomTargetingKey
exceeds the network limit. This is only
applicable for keys of type
CustomTargetingKey.Type#PREDEFINED. -
VALUE_NAME_DUPLICATE - CustomTargetingValue with the same CustomTargetingValue.name already exists.
-
VALUE_NAME_EMPTY - CustomTargetingValue.name is empty.
-
VALUE_NAME_INVALID_LENGTH - CustomTargetingValue.name is too long.
-
VALUE_NAME_INVALID_CHARS - CustomTargetingValue.name contains unsupported or reserved characters.
-
VALUE_DISPLAY_NAME_INVALID_LENGTH - CustomTargetingValue.displayName is too long.
-
VALUE_MATCH_TYPE_NOT_ALLOWED - Only Ad Manager 360 networks can have CustomTargetingValue.matchType other than CustomTargetingValue.MatchType.EXACT .
-
VALUE_MATCH_TYPE_NOT_EXACT_FOR_PREDEFINED_KEY - You can only create CustomTargetingValue objects with match type CustomTargetingValue.MatchType.EXACT when associating with CustomTargetingKey objects of type CustomTargetingKey.Type.PREDEFINED
-
SUFFIX_MATCH_TYPE_NOT_ALLOWED - CustomTargetingValue object cannot have match type of CustomTargetingValue.MatchType.SUFFIX when adding a CustomTargetingValue to a line item.
-
CONTAINS_MATCH_TYPE_NOT_ALLOWED - CustomTargetingValue object cannot have match type of CustomTargetingValue.MatchType.CONTAINS when adding a CustomTargetingValue to targeting expression of a line item.
-
VALUE_STATUS_NOT_ACTIVE - Value is not active.
-
KEY_WITH_MISSING_VALUES - The CustomTargetingKey does not have any CustomTargetingValue associated with it.
-
INVALID_VALUE_FOR_KEY - The CustomTargetingKey has a CustomTargetingValue specified for which the value is not a valid child.
-
CANNOT_OR_DIFFERENT_KEYS - CustomCriteriaSet.LogicalOperator.OR operation cannot be applied to values with different keys.
-
INVALID_TARGETING_EXPRESSION - Targeting expression is invalid. This can happen if the sequence of operators is wrong, or a node contains invalid number of children.
-
DELETED_KEY_CANNOT_BE_USED_FOR_TARGETING - The key has been deleted. CustomCriteria cannot have deleted keys.
-
DELETED_VALUE_CANNOT_BE_USED_FOR_TARGETING - The value has been deleted. CustomCriteria cannot have deleted values.
-
VIDEO_BROWSE_BY_KEY_CANNOT_BE_USED_FOR_CUSTOM_TARGETING - The key is set as the video browse-by key, which cannot be used for custom targeting.
-
CANNOT_DELETE_CUSTOM_KEY_USED_IN_PARTNER_ASSIGNMENT_TARGETING - Cannot delete a custom criteria key that is targeted by an active partner assignment.
-
CANNOT_DELETE_CUSTOM_VALUE_USED_IN_PARTNER_ASSIGNMENT_TARGETING - Cannot delete a custom criteria value that is targeted by an active partner assignment.
-
CANNOT_TARGET_AUDIENCE_SEGMENT - AudienceSegment object cannot be targeted.
-
CANNOT_TARGET_THIRD_PARTY_AUDIENCE_SEGMENT - Third party AudienceSegment cannot be targeted.
-
CANNOT_TARGET_INACTIVE_AUDIENCE_SEGMENT - Inactive AudienceSegment object cannot be targeted.
-
INVALID_AUDIENCE_SEGMENTS - Targeted AudienceSegment object is not valid.
-
CANNOT_TARGET_MAPPED_METADATA - Mapped metadata key-values are deprecated and cannot be targeted.
-
ONLY_APPROVED_AUDIENCE_SEGMENTS_CAN_BE_TARGETED - Targeted AudienceSegment objects have not been approved.
-
UNKNOWN - The value returned if the actual value is not exposed by the requested API version.
