Capping API Usage

Depending on the API, you can explicitly cap requests in a variety of ways, including: requests per day, requests per minute, and requests per minute per user.

You might want to limit the billable usage by setting caps. For example, to prevent getting billed for usage beyond the free courtesy usage limits, you can set requests per day caps.

Modify the limits on the number of requests

You can set limits to all requests to any billable API. Most APIs set default limits, but you can change that limit up to a maximum specified by Google. Some APIs set a very low limit until you enable billing on your project.

To view or change the limits for your API, do the following:

  1. Go to the Cloud Console APIs & Services Dashboard page.
  2. From the projects list, select a project or create a new one.
  3. Click the name of the API you're interested in.
  4. Click Quotas. If the Quotas menu item is not present in the left nav, it means the API you've selected doesn't have quotas defined.
  5. On the quota line you want to change, click the edit icon (), then enter your preferred total quota, up to the limit specified by Google.

Some APIs allow you to request a higher limit by submitting a form. Some APIs allow access to higher quotas only if billing is enabled on the project.

The Premium Plan quota sections pertain to the Google Maps Premium Plan, which is no longer offered. Unless you are a current Google Maps Premium plan customer, please do not edit those sections if you are attempting to cap your usage.

Limiting requests per user

To prevent individual users from using up your API quota, some APIs include a default per user per minute limit. If such a default limit exists, you can modify that value as described in the previous section to limit the quota available to each user.

Individual users are identified by a unique string; if you're creating a server-side application (where the calling code is hosted on a server that you own) that makes requests on behalf of users, your requests must include the quotaUser parameter, as described below.

To identify a user, use the quotaUser=userID parameter. This value is for short term quota enforcement only, so you don't need to use a real user ID. You can choose any arbitrary string under forty characters long that uniquely identifies a user.

The quotaUser parameter is only used for capping requests per user per minute. If you don't send the quotaUser parameter, then all calls are attributed to your server machines, in which case calls can't be capped by user.

View and edit all quotas for APIs in a project

You can review, edit, and request higher quota limits for all billable APIs in a given project by viewing the Quotas page found in IAM & Admin.

To view and edit quotas for all billable APIs in your project, do the following:

  1. Go to the Cloud Console Quotas page in IAM & Admin.
  2. From the projects list, select a project or create a new one.
    The Quotas page for the selected project is displayed, listing one line item for each type of quota available in each service.
  3. Use the filter above the list to adjust the list by Service, Limit name, Quota status, Service ID, and/or Metric.
  4. To edit multiple quotas, either

    • click on the rows in the list, and select quotas from the right side panel, or
    • click on the ALL QUOTAS button on a specific row, and select quotas from the list on the details page

    then click on EDIT QUOTAS. Billing must be enabled on the project in order to click the checkboxes.

  5. In the Edit Quotas panel, select the service to expand the view, then edit the quotas in that service and click DONE.

  6. Repeat to edit the quotas in each of the selected services.

    • The current quota limits are pre-populated in the input boxes.
    • A service with an alert icon () on submission has input errors.
    • You can add more quotas to edit by selecting them as described before.
    • You can remove a service from the Edit Quotas panel by clicking the delete icon ().
  7. When you are done editing quotas, click SUBMIT REQUEST or NEXT.

  8. If your quota edit request needs review, in the Edit Quotas panel on the right, complete the form with your Name, Email address, and Phone number, then click SUBMIT REQUEST.