type AdUnitHierarchyError (v202508)

  • AdUnitHierarchyError is caused by creating an AdUnit object with an invalid hierarchy.

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

  • Specific reasons for AdUnitHierarchyError include INVALID_DEPTH and INVALID_PARENT, related to the hierarchy level and parent ID of an AdUnit.

  • The AdUnitHierarchyError.Reason enumeration details the possible causes for this error, including an unknown reason for future API versions.
Service
InventoryService PublisherQueryLanguageService
Inheritance
ApiError
▼
AdUnitCodeError AdUnitHierarchyError ApiVersionError AudienceSegmentError AuthenticationError CollectionSizeError CommonError CreativeError DealError ExchangeRateError FeatureError FileError InternalApiError InvalidEmailError InvalidUrlError InventoryTargetingError InventoryUnitError LineItemFlightDateError LineItemOperationError NotNullError NullError OrderActionError OrderError ParseError PermissionError PublisherQueryLanguageConte... PublisherQueryLanguageSynta... QuotaError RangeError RegExError RequiredCollectionError RequiredError RequiredNumberError RequiredSizeError ReservationDetailsError ServerError StatementError StringFormatError StringLengthError TypeError UniqueError

Caused by creating an AdUnit object with an invalid hierarchy.

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.

AdUnitHierarchyError

reason

AdUnitHierarchyError.Reason

Enumerations
INVALID_DEPTH
The depth of the AdUnit in the inventory hierarchy is greater than is allowed. The maximum allowed depth is two below the effective root ad unit for Ad Manager 360 accounts and is one level below the effective root ad unit for Ad Manager accounts.
INVALID_PARENT
The only valid AdUnit.parentId for an Ad Manager account is the Network.effectiveRootAdUnitId, Ad Manager 360 accounts can specify an ad unit hierarchy with more than two levels.
UNKNOWN
The value returned if the actual value is not exposed by the requested API version.