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

type CommonError (v202411)

AI-generated Key Takeaways

The CommonError class provides a place for common errors that can be used across various services within the Ad Manager API.
CommonError inherits from ApiError and includes fields such as fieldPath, fieldPathElements, trigger, and errorString.
The CommonError specifically includes a reason field, which is an enumeration detailing various error types like NOT_FOUND, ALREADY_EXISTS, CANNOT_UPDATE, and UNSUPPORTED_OPERATION.
These common error reasons cover scenarios like trying to retrieve a non-existent entity, creating a duplicate, attempting to change immutable fields, or performing unsupported operations.

Service

AdRuleService AdjustmentService AdsTxtService AudienceSegmentService CdnConfigurationService CmsMetadataService CompanyService ContactService ContentBundleService ContentService CreativeService CreativeSetService CreativeTemplateService CreativeWrapperService CustomFieldService CustomTargetingService DaiAuthenticationKeyService DaiEncodingProfileService ForecastService InventoryService LabelService LineItemCreativeAssociationService LineItemService LineItemTemplateService LiveStreamEventService MobileApplicationService NativeStyleService NetworkService OrderService PlacementService ProposalLineItemService ProposalService PublisherQueryLanguageService ReportService SegmentPopulationService SiteService StreamActivityMonitorService SuggestedAdUnitService TargetingPresetService TeamService UserService UserTeamAssociationService YieldGroupService

Inheritance

ApiError

▼

ApiVersionError AuthenticationError CollectionSizeError CommonError CustomTargetingError DateError DateTimeRangeTargetingError DayPartTargetingError EntityLimitReachedError FeatureError ForecastAdjustmentError ForecastError GenericTargetingError GeoTargetingError InternalApiError InvalidUrlError InventoryTargetingError InventoryUnitError InventoryUnitSizesError NotNullError NullError ParseError PermissionError PublisherQueryLanguageConte... PublisherQueryLanguageSynta... QuotaError RequiredCollectionError RequiredError ServerError StatementError StringFormatError StringLengthError TechnologyTargetingError TrafficForecastSegmentError TypeError UniqueError UserDomainTargetingError

A place for common errors that can be used across services.

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.
`CommonError`
`reason`	`CommonError.Reason` Enumerations `NOT_FOUND` Indicates that an attempt was made to retrieve an entity that does not exist. `ALREADY_EXISTS` Indicates that an attempt was made to create an entity that already exists. `NOT_APPLICABLE` Indicates that a value is not applicable for given use case. `DUPLICATE_OBJECT` Indicates that two elements in the collection were identical. `CANNOT_UPDATE` Indicates that an attempt was made to change an immutable field. `UNSUPPORTED_OPERATION` Indicates that the requested operation is not supported. `CONCURRENT_MODIFICATION` Indicates that another request attempted to update the same data in the same network at about the same time. Please wait and try the request again. `UNKNOWN` The value returned if the actual value is not exposed by the requested API version.