Looking for a REST API? The Ad Manager API (Beta) is now available.

type AdUnitHierarchyError (v202505)

AI-generated Key Takeaways

AdUnitHierarchyError is caused by creating an AdUnit object with an invalid hierarchy.
It inherits from ApiError and is part of the InventoryService.
Reasons for this error include exceeding the allowed hierarchy depth (INVALID_DEPTH) or specifying an invalid parent (INVALID_PARENT).
The error details can include the field path, field path elements, trigger data, and a simple error string.
The namespace associated with this error is https://www.google.com/apis/ads/publisher/v202505.

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.

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.