type QuotaError (v202508)

    • The QuotaError indicates a client-side error where a user has no remaining quota for an action.

    • This error includes inherited fields like fieldPath , fieldPathElements , trigger , and errorString from the ApiError class.

    • The specific reasons for a QuotaError are detailed, including exceeding the requests per second limit ( EXCEEDED_QUOTA ), exceeding the hourly limit for new report requests ( REPORT_JOB_LIMIT ), and exceeding the daily limit for uploaded identifiers ( SEGMENT_POPULATION_LIMIT ).

    • Recommended handling for EXCEEDED_QUOTA involves waiting and retrying requests, with suggestions to limit requests per second.

    • Recommended handling for REPORT_JOB_LIMIT involves waiting and retrying, with suggestions to limit new report requests per hour per user.

    • Recommended handling for SEGMENT_POPULATION_LIMIT involves waiting 30 minutes and retrying the request.
    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 CompanyCreditStatusError CompanyError CrossSellError CustomFieldValueError ExchangeSignupApiError FeatureError InternalApiError InvalidEmailError InvalidUrlError InventoryClientApiError LabelEntityAssociationError McmError NetworkError NotNullError NullError ParseError PermissionError PublisherQueryLanguageConte... PublisherQueryLanguageSynta... QuotaError RegExError RequiredCollectionError RequiredError RequiredNumberError ServerError SiteError StatementError StringFormatError StringLengthError TeamError TypeError UniqueError

    Describes a client-side error on which a user is attempting to perform an action to which they have no quota remaining.

    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.

    QuotaError

    reason

    QuotaError.Reason

    Enumerations
    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.
    Design a Mobile Site
    View Site in Mobile | Classic
    Share by: