Quotas

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.

  1. Navigate to the Campaign Manager 360 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.