API 요청의 한도 및 할당량

이 문서에서는 Management API 및 Reporting API 요청의 한도와 할당량을 설명합니다.

Google 애널리틱스는 수백만 개의 사이트에서 사용됩니다. Google은 시스템에서 처리할 수 있는 것보다 많은 데이터를 수신하지 않도록 보호하고 시스템 리소스가 고르게 분산되도록 하기 위해 API 요청에 한도와 할당량을 적용합니다. 한도와 할당량은 변경될 수 있습니다.

이 동영상에서는 Google 애널리틱스 API 요청 할당량 관리를 위한 권장사항을 설명합니다.

일반 할당량 한도

Management API, Core Reporting API v3, MCF Reporting API, Metadata API, User Deletion API, Real Time Reporting API에 적용되는 할당량은 다음과 같습니다.

  • 프로젝트당 하루 요청 50,000개(늘릴 수 있음)
  • IP 주소당 초당 쿼리 수 (QPS) 10개
    • API 콘솔에도 사용자별 100초당 요청이라는 유사한 할당량이 있습니다. 기본적으로 사용자별 100초당 요청 100개로 설정되며 최댓값 1,000개로 조정할 수 있습니다. 하지만 API에 대한 요청 수는 사용자당 초당 최대 10개로 제한됩니다.
    • 애플리케이션이 단일 IP 주소에서 모든 API 요청을 하는 경우(즉, 사용자 대신) 각 요청에 userIP 또는 quotaUser 매개변수를 사용하여 각 사용자의 전체 QPS 할당량을 가져옵니다. 자세한 내용은 표준 쿼리 매개변수 요약을 참조하세요.

할당량 한도 초과

Google 애널리틱스 API 요청 할당량을 초과하면 API가 오류 코드 403 또는 429와 계정이 할당량을 초과했다는 메시지를 반환합니다. 자세한 내용은 서비스 약관을 참조하세요.

추가 할당량 요청

상향 요청만 할 수 있습니다.

프로젝트의 사용량 한도를 확인 또는 변경하거나 할당량 증가를 요청하려면 다음 단계를 따르세요.

  1. 프로젝트의 결제 계정이 아직 없는 경우 계정을 만듭니다.
  2. API 콘솔에서 API 라이브러리의 사용 설정된 API 페이지를 방문하여 목록에서 API를 선택합니다.
  3. 할당량 관련 설정을 확인하고 변경하려면 할당량을 선택합니다. 사용 통계를 확인하려면 사용량을 선택합니다.

최대 할당량 상향을 요청하려면 애널리틱스 API 할당량 요청 양식을 사용하세요. 요청을 제출하기 전에 정보를 검토하고 할당량 요청 양식의 안내를 따라야 합니다. Reporting API v4의 경우 Google API 콘솔의 API 이름은 Google Analytics Reporting API입니다. 다른 모든 v3 API (예: Management API v3, Core Reporting API v3, Real Time Reporting API v3, User Deletion API v3)가 Google API 콘솔의 Analytics API에 나열되어 있습니다.

할당량 관리 및 할당량 사용에 맞게 애플리케이션을 미세 조정하는 방법에 대한 자세한 내용은 API 모니터링 및 사용량 한도 설정을 참고하세요.