할당량을 클릭합니다. 탭 탐색에 할당량 탭이 없으면 선택한 API에 할당량이 정의되지 않은 것입니다.
상한을 설정하려는 할당량을 찾으려면 filter_list필터 필드에 적절한 속성과 값을 입력합니다. 예를 들어 서브네트워크 할당량을 찾으려면 Quota:Subnetworks를 입력합니다.
상한을 설정할 할당량 옆에 있는 체크박스를 클릭한 다음 create할당량 수정을 클릭합니다.
설정하려는 새 한도를 포함하여 할당량 변경 양식을 작성합니다.
요청 제출을 클릭합니다.
일부 API에서는 양식을 제출하여 한도 상향 조정을 요청할 수 있습니다. 그 밖에 프로젝트에서 결제가 사용 설정되어 있는 경우에만 할당량 상향 조정이 가능한 API도 있습니다.
Premium 요금제 할당량 섹션은 더 이상 제공되지 않는 Google 지도 Premium 요금제와 관련이 있습니다. 현재 Google 지도 프리미엄 플랜 고객이 아닌 경우 해당 섹션을 수정하지 마세요.
사용자당 요청 제한
각 사용자가 API 할당량을 모두 소진하지 못하도록 일부 API에는 기본 사용자별 분당 제한이 포함됩니다.
API에 사용자별 분당 기본 한도가 포함되어 있는지 확인하려면 요청 수의 한도 보기 및 수정에 관한 안내에 설명된 대로 API 할당량에서 이 한도를 찾습니다.
해당 API에 이러한 기본 한도가 존재하는 경우, 다음 안내에 따라 각 사용자가 사용할 수 있는 할당량을 제한하도록 이 값을 수정할 수 있습니다.
API에 할당량에 이 기본 한도가 포함되지 않은 경우 추가 또는 수정이 지원되지 않습니다.
개별 사용자는 고유 문자열로 식별됩니다. 따라서 사용자를 대신해 요청하는 서버 측 애플리케이션(개발자가 소유한 서버에서 호출 코드가 호스팅됨)을 개발하는 경우에는 quotaUser 매개변수가 API에 대한 사용량 제한 요청에 포함되어야 합니다. 이 매개변수는 시스템 매개변수 문서에 정의되어 있습니다.
사용자를 식별하려면 quotaUser=userID URL 쿼리 매개변수를 사용합니다. 이 값은 단기 할당량에만 적용됩니다. 따라서 실제 사용자 ID를 사용할 필요 없습니다. 40자 미만의 임의 문자열을 선택하여 사용자를 고유하게 식별할 수 있습니다.
quotaUser 매개변수는 사용자별 분당 요청 수의 상한을 설정할 때만 사용됩니다. quotaUser 매개변수를 보내지 않으면 모든 호출이 서버 머신에서 발생합니다. 이 경우 사용자가 호출 한도를 설정할 수 없습니다.
API에 사용자별 분당 기본 한도가 포함되지 않으면 quotaUser 값이 무시됩니다.
프로젝트의 API에 적용되는 모든 할당량 보기 및 편집
Google Cloud Console의 IAM 및 관리자 섹션에 있는 할당량 페이지를 확인하여 지정된 프로젝트에서 모든 결제 가능한 API에 적용되는 할당량 한도를 검토, 수정 또는 상향 요청할 수 있습니다.
프로젝트에서 모든 결제 가능 API에 적용되는 할당량을 보고 편집하려면 다음 단계를 따릅니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-04-22(UTC)"],[[["\u003cp\u003eYou can limit API requests by setting caps on requests per day, per minute, or per minute per user to manage usage and billing.\u003c/p\u003e\n"],["\u003cp\u003eAPI quota limits can be viewed and modified in the Google Cloud console, within the APIs & Services Dashboard or the Quotas page.\u003c/p\u003e\n"],["\u003cp\u003eSome APIs allow for higher quota limits if billing is enabled on the project, and you can request higher limits by submitting a form.\u003c/p\u003e\n"],["\u003cp\u003eTo prevent overuse by individual users, certain APIs offer a default per-user per-minute limit, which can be modified, and users can be identified via the \u003ccode\u003equotaUser\u003c/code\u003e parameter.\u003c/p\u003e\n"],["\u003cp\u003eWhen setting up quota limits as a tool to manage billing, remember that quota limits are not exact and will need some buffer room.\u003c/p\u003e\n"]]],[],null,["# Capping API usage\n\nDepending on the API, you can explicitly cap requests by limiting the\n*requests per day* , *requests per minute* , or *requests per\nminute per user*.\n\nYou might want to limit the billable usage by setting caps. For example, to\nprevent getting billed for usage beyond the free courtesy usage limits, you can\nset requests per day caps.\n| **Important:** Quota limits are not always entirely precise, because there is some latency between when a quota is surpassed and when the enforcement begins. When using quota as a tool to limit billing, allow some buffer.\n\nView and modify the limits on the number of requests\n----------------------------------------------------\n\nYou can set limits to all requests to any billable API. Most APIs set default\nlimits, but you can change that limit up to a maximum specified by Google.\nSome APIs set a low limit until you\n[enable billing on your project](/billing/docs/how-to/modify-project).\n\nTo view or change the limits for your API, do the following:\n\n1. In the Google Cloud console, go to the **APIs \\& Services Dashboard** page.\n\n [Go to APIs \\& Services Dashboard](https://console.cloud.google.com/apis/dashboard?project=_)\n2. From the projects list, select a project or create a new one.\n3. Click the name of the API you're interested in.\n4. Click **Quotas** . If the **Quotas** tab is not present in the tab nav, it means the API you've selected doesn't have quotas defined.\n5. To find the quota you want to cap, enter the appropriate properties and values in the filter_list **Filter** field. For example, to find the **Subnetworks** quota, enter **Quota:Subnetworks**.\n6. Click the checkbox next to the quota you want to cap, and then click create **EDIT QUOTAS**.\n7. Complete the quota change form, including the new limit that you want to set.\n8. Click **SUBMIT REQUEST**.\n\nSome APIs let you request a higher limit by submitting a form. Some\nAPIs let you specify a higher quota only if\n[billing is enabled on the project](/billing/docs/how-to/modify-project).\n| **Note:** You can set daily billable limits only on billable APIs, and in some cases, only if billing is enabled on your project. If your project doesn't use any billable APIs, then you can't set daily limits. [Learn more about billing accounts](/billing/docs/how-to/manage-billing-account).\n\nThe Premium Plan quota sections pertain to the\n[Google Maps Premium Plan](https://developers.google.com/maps/premium), which\nis no longer offered. Unless you are a current Google Maps Premium plan\ncustomer, don't edit those sections.\n\nLimiting requests per user\n--------------------------\n\nTo prevent individual users from using up your API quota, some APIs include a\ndefault per user per minute limit.\n\nTo check if your API includes a default per user per minute limit, look for it\nin your API quotas as described in the instructions for\n[View and modify the limits on the number of requests](#modify).\nIf such a default limit exists for that API, you can modify that value to limit\nthe quota available to each user by following the steps in these instructions.\nIf your API does not include this default limit in its quotas, adding or\nmodifying it is not supported.\n\nIndividual users are identified by a unique string. If you're creating a\nserver-side application (where the calling code is hosted on a server that you\nown) that makes requests on behalf of users, your requests to the API that\nyou're limiting usage for must include the `quotaUser` parameter. This parameter\nis defined in the [System parameters](/apis/docs/system-parameters) documentation.\n| **Note:** Although per-user limits are specified in queries per minute, we permit short-term usage spikes. Therefore, you should set your limits based on sustained average traffic levels. If anyone tries to use an API in excess of these settings, the requests will trigger a *limit exceeded* error.\n\nTo identify a user, use the `quotaUser=userID` URL query parameter. This value\nis for short-term quota enforcement only, so you don't need to use a real user\nID. You can choose any arbitrary string under 40 characters long that uniquely\nidentifies a user.\n\nThe `quotaUser` parameter is only used for capping requests per user per\nminute. If you don't send the `quotaUser` parameter, then all calls are\nattributed to your server machines, in which case calls can't be capped by user.\n\nIf your API does not include a default per user per minute limit, then\n`quotaUser` values are ignored.\n| **Important:** When sending any user identifier, be sure that you comply with any local laws, including any laws relating to the disclosure of any personal information you send with each request. Best practice is to include as little personal information as possible.\n\nView and edit all quotas for APIs in a project\n----------------------------------------------\n\nYou can review, edit, and request higher quota limits for all billable APIs in\na given project by viewing the **Quotas** page in the **IAM \\& Admin** section of\nGoogle Cloud console.\n\nTo view and edit quotas for all billable APIs in your project, do the following:\n\n1. In the Google Cloud console, go to the **Quotas** page.\n\n [Go to Quotas](https://console.cloud.google.com/iam-admin/quotas?project=_)\n2. From the projects list, select a project or create a new one. The **Quotas** page for the selected project displays, listing one line item for each type of quota available in each service.\n3. Click filter_list **Filter table** to query your quota by a specific property.\n4. Check the box next to the quota(s) you want to edit. Billing must be enabled on the project in order to click some of the checkboxes. If you prefer to edit all the quotas for a single API, click the name of the service to access the Quotas page for that API.\n5. Click edit **EDIT QUOTAS**.\n6. In the **Quota changes** pane that displays, expand the service view, then edit the quotas in that service as needed, and then click **DONE**.\n7. Repeat to edit the quotas in each of the selected services.\n - The current quota limits are pre-populated in the input boxes.\n - A service with an alert icon (error) on submission has input errors.\n - You can add more quotas to edit by selecting them as described before.\n - You can remove a service from the **Quota changes** pane by hovering over the unexpanded service view, and then clicking the delete icon (delete).\n8. When you are done editing quotas, click **NEXT**.\n9. If your quota edit request needs review, the **Contact details** form displays. Complete the form with your contact details.\n10. Click **SUBMIT REQUEST**."]]
