enum QuotaError.Reason (v202508)

  • QuotaError.Reason is an enumeration within the https://www.google.com/apis/ads/publisher/v202508 namespace, detailing reasons for quota errors across various services like AdRuleService, NetworkService, and ReportService.

  • Exceeding the allowable requests per second results in an EXCEEDED_QUOTA error, which can be mitigated by waiting and retrying, or limiting requests to 8/sec (360 accounts) or 2/sec (Ad Manager accounts).

  • A REPORT_JOB_LIMIT error indicates the user has exceeded the hourly new report request limit, suggesting a 10-minute wait before retrying or limiting new report requests to 250 per hour per user.

  • The SEGMENT_POPULATION_LIMIT error occurs when the network exceeds the allowed number of identifiers uploaded within 24 hours, and is best handled by waiting 30 minutes before retrying.

  • An UNKNOWN reason is returned when the actual value of the quota error is not exposed by the requested API version.
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
Dependencies
QuotaError
▼
QuotaError.Reason
Namespace
https://www.google.com/apis/ads/publisher/v202508
Enumeration Description
EXCEEDED_QUOTA The number of requests made per second is too high and has exceeded the allowable limit. The recommended approach to handle this error is to wait about 5 seconds and then retry the request. Note that this does not guarantee the request will succeed. If it fails again, try increasing the wait time.

Another way to mitigate this error is to limit requests to 8 per second for Ad Manager 360 accounts, or 2 per second for Ad Manager accounts. Once again this does not guarantee that every request will succeed, but may help reduce the number of times you receive this error.
UNKNOWN The value returned if the actual value is not exposed by the requested API version.
REPORT_JOB_LIMIT This user has exceeded the allowed number of new report requests per hour (this includes both reports run via the UI and reports run via ReportService.runReportJob). The recommended approach to handle this error is to wait about 10 minutes and then retry the request. Note that this does not guarantee the request will succeed. If it fails again, try increasing the wait time.

Another way to mitigate this error is to limit the number of new report requests to 250 per hour per user. Once again, this does not guarantee that every request will succeed, but may help reduce the number of times you receive this error.
SEGMENT_POPULATION_LIMIT This network has exceeded the allowed number of identifiers uploaded within a 24 hour period. The recommended approach to handle this error is to wait 30 minutes and then retry the request. Note that this does not guarantee the request will succeed. If it fails again, try increasing the wait time.