Quotas

Quotas protect Google's infrastructure from automated processes that use the Google Bid Manager 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 Bid Manager API resources and methods.

  • 2,000 requests per project per day - can be increased.
  • 4 queries 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 240.

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 userRateLimitExceeded User Rate Limit Exceeded Slow down the rate at which you are sending requests using exponential backoff.

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.

  1. Navigate to the Bid Manager API in the Google API Console.
  2. 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.
  3. 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.