API 사용량 상한 설정

1일당 요청 수, 100초당 요청 수, 사용자별 100초당 요청 수를 포함하여 API에 따라 요청 상한을 다양한 방법으로 설정할 수 있습니다.

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

요청 수 수정

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

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

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

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

사용자 1명에 대한 초당 요청 수 제한

각 사용자가 API 할당량을 모두 소진하지 못하도록 하려면 사용자 1명에 대한 초당 API 요청 수를 제한하세요. API마다 사용자 1명당 기본 한도가 포함되어 있지만 기본 값은 이전 섹션에서 설명한 방법으로 수정할 수 있습니다.

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

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

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

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

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

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

  1. IAM 및 관리자에서 Cloud Console 할당량 페이지로 이동합니다.
  2. 프로젝트 목록에서 프로젝트를 선택하거나 새 프로젝트를 만듭니다.
    선택된 프로젝트의 할당량 페이지가 표시됩니다. 이 페이지에는 각 서비스에서 사용 가능한 각 할당량 유형의 항목이 나열됩니다.
  3. 페이지 상단의 필터를 사용하여 할당량 유형, 서비스, 측정항목, 위치를 기준으로 목록을 조정합니다.
  4. 다수의 할당량을 수정하려면 +할당량 수정을 클릭한 후 각 할당량 옆에 있는 체크박스를 클릭하여 수정할 할당량을 1개 이상 선택합니다. 체크박스를 클릭하려면 프로젝트에서 결제가 사용 설정되어 있어야 합니다.
  5. 오른쪽 할당량 수정 패널에서 이름, 이메일 주소, 전화번호로 양식을 작성한 후 다음을 클릭합니다.
  6. 할당량 수정 패널에서 뷰를 펼칠 서비스를 선택한 후 해당 서비스에서 할당량을 수정하고 완료를 클릭합니다.
  7. 선택된 각 서비스에서 할당량 수정을 반복합니다.
    • 알림 아이콘()이 표시된 서비스는 아직 수정되지 않은 서비스입니다.
    • 왼쪽 목록에서 수정할 할당량을 선택하여 추가할 수 있습니다.
    • 삭제 아이콘()을 클릭하여 할당량 수정 패널에서 서비스를 삭제할 수 있습니다.
  8. 할당량 수정을 마치면 요청 제출을 클릭합니다.