type QuotaError (v202402)
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/v202402
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.
|
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 2024-02-13 UTC.
[null,null,["Last updated 2024-02-13 UTC."],[[["This documentation focuses on `QuotaError`, a client-side error encountered when a user attempts an action and has exhausted their allocated quota."],["`QuotaError` is part of the Google Ad Manager API and falls under the namespace `https://www.google.com/apis/ads/publisher/v202402`."],["The error includes reasons such as exceeding request limits per second, reaching the report job limit, or surpassing the segment population limit within a given timeframe."],["Developers can find detailed information about the error's properties like `fieldPath`, `trigger`, `errorString`, and the specific `reason` for the quota being exceeded."],["Recommendations for handling `QuotaError` include implementing wait times and reducing the frequency of requests to mitigate exceeding quota limits."]]],["The content details various services and errors within an ad management system, focusing on their types and potential quota issues. It lists services like `ActivityGroupService`, `CreativeService`, and `ReportService`, alongside error types, such as `ApiError`, `QuotaError`, and `ForecastError`. Key actions involve managing ad-related activities through the services and handling various errors, particularly `QuotaError` that indicates exceeding request limits. Enumerations such as `EXCEEDED_QUOTA`, `REPORT_JOB_LIMIT` and `SEGMENT_POPULATION_LIMIT` provide detail on the reason for the error.\n"]]
