API 사용량 상한 설정

API에 따라 일일 요청 ,분당 요청사용자별 분당 요청 등 다양한 방식으로 요청을 명시적으로 제한할 수 있습니다.

청구 가능 사용량에 상한을 설정하여 제한할 수 있습니다. 예를 들어 무료 우대 사용량 한도를 초과하여 결제가 되지 않도록 하기 위해 일일 요청 상한을 설정할 수 있습니다

요청 수 한도 수정

결제 가능 API에 대한 모든 요청에 한도를 설정할 수 있습니다. 대부분 API에는 기본 한도가 설정되어 있지만 Google에서 지정하는 최댓값까지 기본 한도를 변경할 수 있습니다. 일부 API에서는 프로젝트에서 결제를 사용 설정할 때까지 한도가 매우 낮게 설정됩니다.

API 한도를 보거나 변경하려면 다음 단계를 따릅니다.

  1. Cloud Console API 및 서비스 대시보드 페이지로 이동합니다.
  2. 프로젝트 목록에서 프로젝트를 선택하거나 새 프로젝트를 만듭니다.
  3. 확인하려는 API의 이름을 클릭합니다.
  4. 할당량을 클릭합니다. 할당량 메뉴 항목이 왼쪽 탐색 메뉴에 표시되지 않으면 선택한 API에 정의된 할당량이 없다는 의미입니다.
  5. 변경하려는 할당량 행에서 수정 아이콘()을 클릭한 후 Google에서 지정한 최대 한도 내로 원하는 총 할당량을 입력합니다.

일부 API에서는 양식을 제출하여 한도 상향 조정을 요청할 수 있습니다. 그 밖에 프로젝트에서 결제가 사용 설정되어 있는 경우에만 할당량 상향 조정이 가능한 API도 있습니다.

Premium 요금제 할당량 섹션은 더 이상 제공되지 않는 Google 지도 Premium 요금제와 관련이 있습니다. 현재 Google 지도 Premium 요금제 고객이 아닌 경우, 사용량 한도를 설정하려고 하는 경우 해당 섹션을 수정하면 안 됩니다.

사용자당 요청 제한

각 사용자가 API 할당량을 모두 소진하지 못하도록 일부 API에는 기본 사용자별 분당 제한이 포함됩니다. 이러한 기본 한도가 있는 경우 이전 섹션에 설명된 대로 값을 수정하여 각 사용자가 사용할 수 있는 할당량을 제한할 수 있습니다.

각 사용자는 고유 문자열로 식별됩니다. 따라서 사용자를 대신해 요청하는 서버 측 애플리케이션(호출 코드가 개발자가 소유한 서버에서 호스팅됨)을 개발하는 경우에는 quotaUser 매개변수가 아래 설명처럼 요청에 포함되어야 합니다.

사용자를 식별하려면 quotaUser=userID 매개변수를 사용합니다. 이 값은 단기 할당량에만 적용됩니다. 따라서 실제 사용자 ID를 사용할 필요 없습니다. 40자 미만의 임의 문자열을 선택하여 사용자를 고유하게 식별할 수 있습니다.

quotaUser 매개변수는 사용자별 분당 요청 수의 상한을 설정할 때만 사용됩니다. quotaUser 매개변수를 보내지 않으면 모든 호출이 서버 머신에서 발생합니다. 이 경우 사용자가 호출 한도를 설정할 수 없습니다.

프로젝트의 API에 적용되는 모든 할당량 보기 및 편집

프로젝트에서 모든 결제 가능 API에 적용되는 할당량 한도는 IAM 및 관리자할당량 페이지에서 검토 또는 편집하거나, 혹은 상향 요청을 할 수 있습니다.

프로젝트에서 모든 결제 가능 API에 적용되는 할당량을 보고 편집하려면 다음 단계를 따릅니다.

  1. IAM 및 관리자에서 Cloud Console 할당량 페이지로 이동합니다.
  2. 프로젝트 목록에서 프로젝트를 선택하거나 새 프로젝트를 만듭니다.
    선택된 프로젝트의 할당량 페이지가 표시됩니다. 이 페이지에는 각 서비스에서 사용 가능한 각 할당량 유형의 항목이 나열됩니다.
  3. 목록 위의 필터를 사용하여 서비스, 한도 이름, 할당량 상태, 서비스 ID 또는 측정항목을 기준으로 목록을 조정합니다.
  4. 여러 할당량을 수정하려면 다음 둘 중 하나를 따릅니다.

    • 목록의 행을 클릭하고 오른쪽 패널에서 할당량을 선택합니다.
    • 특정 행의 모든 할당량 버튼을 클릭하고 세부정보 페이지의 목록에서 할당량을 선택합니다.

    그런 다음 할당량 수정을 클릭합니다. 체크박스를 클릭하려면 프로젝트에 결제가 사용 설정되어 있어야 합니다.

  5. 할당량 수정 패널에서 뷰를 펼칠 서비스를 선택한 후 해당 서비스에서 할당량을 수정하고 완료를 클릭합니다.

  6. 선택된 각 서비스에서 할당량 수정을 반복합니다.

    • 현재 할당량 한도는 입력 상자에 자동으로 입력됩니다.
    • 제출 시 알림 아이콘()이 있는 서비스에는 입력 오류가 있습니다.
    • 이전에 설명된 대로 수정할 할당량을 선택하여 할당량을 추가할 수 있습니다.
    • 삭제 아이콘()을 클릭하여 할당량 수정 패널에서 서비스를 삭제할 수 있습니다.
  7. 할당량 수정을 마치면 요청 제출 또는 다음을 클릭합니다.

  8. 할당량 수정 요청을 검토해야 할 경우 오른쪽의 할당량 수정 패널에서 이름, 이메일 주소, 전화 번호로 양식을 작성한 후 요청 제출을 클릭합니다.