type AudienceSegmentError (v202508)

AI-generated Key Takeaways

• AudienceSegmentError indicates errors that can occur specifically on audience segment related requests.

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

• Specific reasons for AudienceSegmentError include issues with first-party segments, rule validity, segment name and description, pageview and recency values, membership expiration, and custom targeting key/value validity.

• Nested audience segments, shared selling partner roots, and inactive segments are also potential causes of AudienceSegmentError.

• Policy violations and licensing issues can also trigger an AudienceSegmentError.

Service

AudienceSegmentService ForecastService LineItemService LineItemTemplateService OrderService ProposalLineItemService ProposalService PublisherQueryLanguageService

Inheritance

ApiError

▼

ApiVersionError AudienceSegmentError AuthenticationError CollectionSizeError CommonError CustomTargetingError EntityChildrenLimitReachedE... EntityLimitReachedError FeatureError InternalApiError NotNullError ParseError PermissionError PublisherQueryLanguageConte... PublisherQueryLanguageSynta... QuotaError RequiredCollectionError RequiredError ServerError StatementError StringFormatError StringLengthError TypeError

Errors that could occur on audience segment related requests.

---

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.
AudienceSegmentError
reason	AudienceSegmentError.Reason Enumerations FIRST_PARTY_AUDIENCE_SEGMENT_NOT_SUPPORTED First party audience segment is not supported. ONLY_RULE_BASED_FIRST_PARTY_AUDIENCE_SEGMENTS_CAN_BE_CREATED Only rule-based first-party audience segments can be created. AUDIENCE_SEGMENT_ID_NOT_FOUND Audience segment for the given id is not found. INVALID_AUDIENCE_SEGMENT_RULE Audience segment rule is invalid. AUDIENCE_SEGMENT_RULE_TOO_LONG Audience segment rule contains too many ad units and/or custom criteria. INVALID_AUDIENCE_SEGMENT_NAME Audience segment name is invalid. DUPLICATE_AUDIENCE_SEGMENT_NAME Audience segment with this name already exists. INVALID_AUDIENCE_SEGMENT_DESCRIPTION Audience segment description is invalid. INVALID_AUDIENCE_SEGMENT_PAGEVIEWS Audience segment pageviews value is invalid. It must be between 1 and 12. INVALID_AUDIENCE_SEGMENT_RECENCY Audience segment recency value is invalid. It must be between 1 and 90 if pageviews > 1. INVALID_AUDIENCE_SEGMENT_MEMBERSHIP_EXPIRATION Audience segment membership expiration value is invalid. It must be between 1 and 180. INVALID_AUDIENCE_SEGMENT_CUSTOM_KEY_NAME The given custom key cannot be part of audience segment rule due to unsupported characters. INVALID_AUDIENCE_SEGMENT_CUSTOM_VALUE_NAME The given custom value cannot be part of audience segment rule due to unsupported characters. INVALID_AUDIENCE_SEGMENT_CUSTOM_VALUE_MATCH_TYPE Broad-match custom value cannot be part of audience segment rule. INVALID_NESTED_FIRST_PARTY_AUDIENCE_SEGMENT Audience segment rule cannot contain itself. SHARED_SELLING_PARTNER_ROOT_CANNOT_BE_INCLUDED Audience segment rule cannot contain shared selling inventory unit. INVALID_NESTED_THIRD_PARTY_AUDIENCE_SEGMENT Audience segment rule cannot contain a nested third-party segment. INACTIVE_NESTED_AUDIENCE_SEGMENT Audience segment rule cannot contain a nested inactive segment. AUDIENCE_SEGMENT_GLOBAL_LICENSE_ERROR An error occurred when purchasing global licenses. SEGMENT_VIOLATED_POLICY Segment cannot be activated as it violates Google's Platform Policy. UNKNOWN The value returned if the actual value is not exposed by the requested API version.