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 할당량을 가져옵니다. 자세한 내용은 표준 쿼리 매개변수 요약을 참조하세요.

보고 API

다음 할당량은 Core Reporting API v3, Analytics Reporting API v4, Real Time API v3, Multi-channel Funnel API v3을 포함한 모든 Reporting API에 적용됩니다.

  • 보기 (프로필)당 일일 요청 10,000개 (늘릴 수 없음)
  • 보기 (프로필)당 동시 요청 10개 (늘릴 수 없음)
Analytics Real Time Reporting API 호출은 다른 Analytics API와 별도로 계산됩니다. 즉, Analytics Real Time Reporting API를 사용하여 보기 (프로필)당 하루 10,000회의 호출을 하고 다른 애널리틱스 API를 사용하여 조회 (프로필)당 하루 10,000회의 호출을 추가로 할 수 있습니다.

이 동작은 할당량을 관리하는 데 보다 세밀하고 장애 방지 접근 방식을 제공하므로 Analytics Real Time Reporting API를 자주 호출해도 남은 시간 동안 개별 보기 (프로필)에 대한 다른 모든 Analytics API 호출이 실수로 차단되지 않습니다.

Reporting API 요청 오류

Reporting API에 대한 요청이 서버 오류로 실패하면 응답 코드 500 또는 503이 표시됩니다. 요청을 다시 제출할 수 있습니다. 하지만 반복적으로 실패할 경우 이 요청을 두 번 이상 다시 제출하지 마세요. Google 애널리틱스를 통해 사용할 수 있는 기능은 다음과 같습니다.

  • 시간당 보기 (프로필)당 프로젝트당 서버 오류 실패 요청 10개
  • 일일 보기 (프로필)당 프로젝트당 서버 오류 실패 요청 50개

실패한 요청 수가 이 할당량을 초과하면 다음 오류가 발생합니다.

Quota Error: The number of recent reporting API requests failing by server error is too high.
You are temporarily blocked from the reporting API for at least an hour.
Please send fewer server errors in the future to avoid being blocked.

요청 서버 오류가 발생할 가능성을 줄이려면 기간을 줄이거나, 요청의 측정기준 수를 줄이거나, 요청의 측정항목 수를 줄여 요청을 간소화하세요.

실패한 요청을 계속해서 다시 제출하지 마세요. 대신 지수 백오프를 구현하여 다시 제출하세요.

서버 오류율 할당량은 각각의 시간별 및 일별 오류율 할당량의 순환 기간에 걸쳐 적용됩니다. 프로젝트와 뷰 쌍의 첫 번째 서버 오류가 발생하고 1시간 후 할당량이 재설정됩니다. 프로젝트와 뷰 쌍에서 1시간 동안 10개의 서버 오류를 전송하면 첫 번째 서버 오류가 발생한 후 1시간이 경과할 때까지 API에서 프로젝트와 뷰 쌍이 차단됩니다.

예를 들어 프로젝트와 뷰 쌍에서 지난 24시간 동안 서버 오류를 전송하지 않은 경우 이 프로젝트와 뷰는 할당량 50 중 0을 사용합니다. 이 프로젝트와 보기가 오전 6시 12분에 서버 오류를 전송한다고 가정해 보겠습니다. 이 프로젝트와 보기가 다음 날 오전 6시 12분 이전에 49개의 추가 서버 오류를 전송하면 다음 날 오전 6시 12분까지 이 프로젝트와 뷰가 차단됩니다. 다음 날 오전 6시 12분에 이 프로젝트와 뷰의 서버 오류율 할당량이 완전히 재설정됩니다.

할당량 한도 초과

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 모니터링 및 사용량 한도 설정을 참고하세요.