Quotas protect Google's infrastructure from automated processes that use the Campaign Manager 360 API in an inappropriate way. They ensure that one developer's actions cannot negatively impact the larger community.
Quota limits
The following default quota limits are shared by all Campaign Manager 360 API resources and methods.
- 50,000 requests per project per day - can be increased.
- 1 query per second (QPS) per project.
- In the Google API Console this quota is referred to as Queries per minute per user, and is set to 60 by default. This limit can be increased as needed, up to a maximum of 600 (10 QPS).
Report Builder enforces additional quota limits that vary by account. To learn more, refer to this help center article and the table below.
Exceeding quota limits
In the unlikely event that your request fails due to exceeding a quota limit, the API returns an HTTP status code and reason for the error. Additionally, the body of the response contains a detailed description of what caused the error. See the Error Messages guide for an example error response.
The following list shows the possible errors and recommended actions for request failures caused by exceeding quota limits.
Code | Reason | Message | Recommended Action |
---|---|---|---|
403 | dailyLimitExceeded | Daily Limit Exceeded | Do not retry without fixing the problem. Examine your usage from the Google API Console and modify your workflow to make fewer requests. You can request additional quota if you believe your usage is reasonable. |
403 | quotaExceeded | This account has exceeded its quota of x reports per day. | Do not attempt to run any more reports for this account on this day. Contact your account manager for assistance. |
403 | quotaExceeded | This user profile has exceeded its quota of x reports per day. | Do not attempt to run any more reports for this user profile on this day. Switch to a different user profile or contact your account manager for assistance. |
403 | quotaExceeded | This account has exceeded its quota of x active scheduled reports. | Deactivate scheduled reports that you don't need before retrying this request. |
403 | quotaExceeded | The user profile that owns this report has exceeded its quota of x active scheduled reports. | Have the owner of this report deactivate scheduled reports that they don't need before retrying this request. |
403 | quotaExceeded | This user profile has exceeded its quota of x active scheduled reports. | Deactivate scheduled reports that you don't need before retrying this request. |
403 | quotaExceeded | Cannot complete this action because one of your quotas has been exceeded. Please contact your account manager for assistance. | Contact your account manager for assistance. |
403 | userRateLimitExceeded | User Rate Limit Exceeded | Increase the per-user limit in the Google API Console or slow down the rate at which you are sending requests using exponential backoff. It is not recommended to make concurrent write requests or to employ a rate limit higher than 10 QPS with this API. |
Requesting additional daily quota
If you think that your application requires additional daily quota, you can request more by following the instructions below.
The following instructions only apply to projects that have encountered a
dailyLimitExceeded
error. Recommended actions for other quota errors are
covered in the table above.
- Navigate to the Campaign Manager 360 API in the Google API Console.
- Review your usage statistics from the Metrics page to ensure your application is behaving as expected. Pay close attention to the methods that have been called and address any unexpected or excessive usage before proceeding.
- If usage looks normal, navigate to the Quotas page, click the edit icon next to Queries per day and click the link to "Apply for higher quota".
Make sure to review the information and follow the instructions included in the quota request form before submitting an increase request.