abstract type ApiError (v202408)
Stay organized with collections
Save and categorize content based on your preferences.
The API error base class that provides details about an error that occurred
while processing a service request.
The OGNL field path is provided for parsers to identify the request data
element that may have caused the error.
- Namespace
-
https://www.google.com/apis/ads/publisher/v202408
Field
|
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.
|
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-06 UTC.
[null,null,["Last updated 2025-08-06 UTC."],[[["\u003cp\u003eThe \u003ccode\u003eApiError\u003c/code\u003e object provides detailed information about errors encountered during service requests in Google Ad Manager.\u003c/p\u003e\n"],["\u003cp\u003eIt includes the OGNL field path, which helps pinpoint the specific data element causing the error.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eApiError\u003c/code\u003e also contains the \u003ccode\u003etrigger\u003c/code\u003e and \u003ccode\u003eerrorString\u003c/code\u003e fields to give further context and explanation of the error.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can use the \u003ccode\u003efieldPath\u003c/code\u003e or \u003ccode\u003efieldPathElements\u003c/code\u003e to identify the problematic part of the request, and understand the error using the \u003ccode\u003etrigger\u003c/code\u003e and \u003ccode\u003eerrorString\u003c/code\u003e fields.\u003c/p\u003e\n"]]],["This document outlines various services and their associated API errors within an ad management system. It lists numerous services like `AdRuleService`, `AdjustmentService`, `LiveStreamEventService`, and others, all linked to their respective `ApiError` types. It details the `ApiError` base class, describing error details, including `fieldPath`, `fieldPathElements`, `trigger`, and `errorString` to identify the source and nature of errors during service requests. Also `ApiError` inheritance is specified, providing different error types.\n"],null,["# abstract type ApiError (v202408)\n\n**Service** \n[AdRuleService](/ad-manager/api/reference/v202408/AdRuleService.ApiError) [AdjustmentService](/ad-manager/api/reference/v202408/AdjustmentService.ApiError) [AdsTxtService](/ad-manager/api/reference/v202408/AdsTxtService.ApiError) [AudienceSegmentService](/ad-manager/api/reference/v202408/AudienceSegmentService.ApiError) [CdnConfigurationService](/ad-manager/api/reference/v202408/CdnConfigurationService.ApiError) [CmsMetadataService](/ad-manager/api/reference/v202408/CmsMetadataService.ApiError) [CompanyService](/ad-manager/api/reference/v202408/CompanyService.ApiError) [ContactService](/ad-manager/api/reference/v202408/ContactService.ApiError) [ContentBundleService](/ad-manager/api/reference/v202408/ContentBundleService.ApiError) [ContentService](/ad-manager/api/reference/v202408/ContentService.ApiError) [CreativeService](/ad-manager/api/reference/v202408/CreativeService.ApiError) [CreativeSetService](/ad-manager/api/reference/v202408/CreativeSetService.ApiError) [CreativeTemplateService](/ad-manager/api/reference/v202408/CreativeTemplateService.ApiError) [CreativeWrapperService](/ad-manager/api/reference/v202408/CreativeWrapperService.ApiError) [CustomFieldService](/ad-manager/api/reference/v202408/CustomFieldService.ApiError) [CustomTargetingService](/ad-manager/api/reference/v202408/CustomTargetingService.ApiError) [DaiAuthenticationKeyService](/ad-manager/api/reference/v202408/DaiAuthenticationKeyService.ApiError) [DaiEncodingProfileService](/ad-manager/api/reference/v202408/DaiEncodingProfileService.ApiError) [ForecastService](/ad-manager/api/reference/v202408/ForecastService.ApiError) [InventoryService](/ad-manager/api/reference/v202408/InventoryService.ApiError) [LabelService](/ad-manager/api/reference/v202408/LabelService.ApiError) [LineItemCreativeAssociationService](/ad-manager/api/reference/v202408/LineItemCreativeAssociationService.ApiError) [LineItemService](/ad-manager/api/reference/v202408/LineItemService.ApiError) [LineItemTemplateService](/ad-manager/api/reference/v202408/LineItemTemplateService.ApiError) **LiveStreamEventService** [MobileApplicationService](/ad-manager/api/reference/v202408/MobileApplicationService.ApiError) [NativeStyleService](/ad-manager/api/reference/v202408/NativeStyleService.ApiError) [NetworkService](/ad-manager/api/reference/v202408/NetworkService.ApiError) [OrderService](/ad-manager/api/reference/v202408/OrderService.ApiError) [PlacementService](/ad-manager/api/reference/v202408/PlacementService.ApiError) [ProposalLineItemService](/ad-manager/api/reference/v202408/ProposalLineItemService.ApiError) [ProposalService](/ad-manager/api/reference/v202408/ProposalService.ApiError) [PublisherQueryLanguageService](/ad-manager/api/reference/v202408/PublisherQueryLanguageService.ApiError) [ReportService](/ad-manager/api/reference/v202408/ReportService.ApiError) [SegmentPopulationService](/ad-manager/api/reference/v202408/SegmentPopulationService.ApiError) [SiteService](/ad-manager/api/reference/v202408/SiteService.ApiError) [StreamActivityMonitorService](/ad-manager/api/reference/v202408/StreamActivityMonitorService.ApiError) [SuggestedAdUnitService](/ad-manager/api/reference/v202408/SuggestedAdUnitService.ApiError) [TargetingPresetService](/ad-manager/api/reference/v202408/TargetingPresetService.ApiError) [TeamService](/ad-manager/api/reference/v202408/TeamService.ApiError) [UserService](/ad-manager/api/reference/v202408/UserService.ApiError) [UserTeamAssociationService](/ad-manager/api/reference/v202408/UserTeamAssociationService.ApiError) [YieldGroupService](/ad-manager/api/reference/v202408/YieldGroupService.ApiError) **Dependencies** \n[ApiException](/ad-manager/api/reference/v202408/LiveStreamEventService.ApiException) \n▼\n**ApiError** **Inheritance** \n**ApiError** \n▼\n[AdBreakMarkupError](/ad-manager/api/reference/v202408/LiveStreamEventService.AdBreakMarkupError) [ApiVersionError](/ad-manager/api/reference/v202408/LiveStreamEventService.ApiVersionError) [AuthenticationError](/ad-manager/api/reference/v202408/LiveStreamEventService.AuthenticationError) [CollectionSizeError](/ad-manager/api/reference/v202408/LiveStreamEventService.CollectionSizeError) [CommonError](/ad-manager/api/reference/v202408/LiveStreamEventService.CommonError) [EntityLimitReachedError](/ad-manager/api/reference/v202408/LiveStreamEventService.EntityLimitReachedError) [FeatureError](/ad-manager/api/reference/v202408/LiveStreamEventService.FeatureError) [InternalApiError](/ad-manager/api/reference/v202408/LiveStreamEventService.InternalApiError) [InvalidUrlError](/ad-manager/api/reference/v202408/LiveStreamEventService.InvalidUrlError) [LiveStreamEventActionError](/ad-manager/api/reference/v202408/LiveStreamEventService.LiveStreamEventActionError) [LiveStreamEventCdnSettingsE...](/ad-manager/api/reference/v202408/LiveStreamEventService.LiveStreamEventCdnSettingsError \"LiveStreamEventCdnSettingsError\") [LiveStreamEventConditioning...](/ad-manager/api/reference/v202408/LiveStreamEventService.LiveStreamEventConditioningError \"LiveStreamEventConditioningError\") [LiveStreamEventCustomAssetK...](/ad-manager/api/reference/v202408/LiveStreamEventService.LiveStreamEventCustomAssetKeyError \"LiveStreamEventCustomAssetKeyError\") [LiveStreamEventDateTimeError](/ad-manager/api/reference/v202408/LiveStreamEventService.LiveStreamEventDateTimeError) [LiveStreamEventDvrWindowError](/ad-manager/api/reference/v202408/LiveStreamEventService.LiveStreamEventDvrWindowError) [LiveStreamEventPrerollSetti...](/ad-manager/api/reference/v202408/LiveStreamEventService.LiveStreamEventPrerollSettingsError \"LiveStreamEventPrerollSettingsError\") [LiveStreamEventSlateError](/ad-manager/api/reference/v202408/LiveStreamEventService.LiveStreamEventSlateError) [NotNullError](/ad-manager/api/reference/v202408/LiveStreamEventService.NotNullError) [NullError](/ad-manager/api/reference/v202408/LiveStreamEventService.NullError) [ParseError](/ad-manager/api/reference/v202408/LiveStreamEventService.ParseError) [PermissionError](/ad-manager/api/reference/v202408/LiveStreamEventService.PermissionError) [PublisherQueryLanguageConte...](/ad-manager/api/reference/v202408/LiveStreamEventService.PublisherQueryLanguageContextError \"PublisherQueryLanguageContextError\") [PublisherQueryLanguageSynta...](/ad-manager/api/reference/v202408/LiveStreamEventService.PublisherQueryLanguageSyntaxError \"PublisherQueryLanguageSyntaxError\") [QuotaError](/ad-manager/api/reference/v202408/LiveStreamEventService.QuotaError) [RangeError](/ad-manager/api/reference/v202408/LiveStreamEventService.RangeError) [RequiredCollectionError](/ad-manager/api/reference/v202408/LiveStreamEventService.RequiredCollectionError) [RequiredError](/ad-manager/api/reference/v202408/LiveStreamEventService.RequiredError) [RequiredNumberError](/ad-manager/api/reference/v202408/LiveStreamEventService.RequiredNumberError) [ServerError](/ad-manager/api/reference/v202408/LiveStreamEventService.ServerError) [StatementError](/ad-manager/api/reference/v202408/LiveStreamEventService.StatementError) [StringFormatError](/ad-manager/api/reference/v202408/LiveStreamEventService.StringFormatError) [StringLengthError](/ad-manager/api/reference/v202408/LiveStreamEventService.StringLengthError) [UniqueError](/ad-manager/api/reference/v202408/LiveStreamEventService.UniqueError) [VideoAdTagError](/ad-manager/api/reference/v202408/LiveStreamEventService.VideoAdTagError)\n\nThe API error base class that provides details about an error that occurred\nwhile processing a service request.\n\nThe OGNL field path is provided for parsers to identify the request data\nelement that may have caused the error.\n\n*** ** * ** ***\n\nNamespace\n:\n `https://www.google.com/apis/ads/publisher/v202408`\n\n| Field ----- ||\n|-------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ### `fieldPath` | ` `xsd:`string` The OGNL field path to identify cause of error. |\n| ### `fieldPathElements` | ` `[FieldPathElement](/ad-manager/api/reference/v202408/LiveStreamEventService.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)}. |\n| ### `trigger` | ` `xsd:`string` The data that caused the error. |\n| ### `errorString` | ` `xsd:`string` A simple string representation of the error and reason. |"]]