type AdUnitHierarchyError (v202508)

  • The AdUnitHierarchyError is caused by creating an AdUnit object with an invalid hierarchy within the InventoryService.

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

  • The AdUnitHierarchyError has a 'reason' field which can indicate an INVALID_DEPTH if the ad unit hierarchy is too deep or an INVALID_PARENT if the parent ad unit is invalid for the account type.

  • The maximum allowed depth for ad units is two below the effective root for Ad Manager 360 accounts and one level for Ad Manager accounts.

  • The only valid parent for an Ad Manager account is the Network.effectiveRootAdUnitId.
Service
InventoryService PublisherQueryLanguageService
Inheritance
ApiError
▼
AdSenseAccountError AdUnitCodeError AdUnitHierarchyError ApiVersionError AuthenticationError CollectionSizeError CommonError CompanyError CreativeWrapperError CrossSellError EntityChildrenLimitReachedE... EntityLimitReachedError FeatureError FrequencyCapError InternalApiError InvalidColorError InvalidUrlError InventoryUnitError InventoryUnitRefreshRateError InventoryUnitSizesError LabelEntityAssociationError NotNullError NullError ParseError PermissionError PublisherQueryLanguageConte... PublisherQueryLanguageSynta... QuotaError RangeError RegExError RequiredCollectionError RequiredError RequiredNumberError ServerError StatementError StringFormatError StringLengthError TeamError 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.