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, 다채널 유입경로 API v3을 포함한 모든 Reporting API에 적용됩니다.

• 일일 보기 (프로필)당 요청 10,000개 (증가 불가)
• 보기 (프로필)당 동시 요청 10개 (늘릴 수 없음)

Analytics Real Time Reporting API 호출은 다른 Analytics API와 별도로 처리됩니다. 즉, Analytics Real Time Reporting API를 사용하여 보기 (프로필)당 하루 10,000회의 호출을 할 수 있으며 다른 애널리틱스 API를 사용하여 보기 (프로필)를 하루 10,000회 호출할 수 있습니다.

이 동작은 보다 세밀하고 안전하게 할당량을 관리하는 방식을 제공하므로 애널리틱스 Real Time Reporting API를 사용하여 자주 호출해도 하루 중 남은 시간 동안 개별 보기 (프로필)에서 다른 모든 애널리틱스 API 호출이 실수로 차단되지 않습니다.

참고: 여러 Reporting 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와 계정이 할당량을 초과했다는 메시지를 반환합니다. 자세한 내용은 서비스 약관을 참고하세요.

추가 할당량 요청

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

• 프로젝트당 일일 읽기 요청 수(기본값: 50,000개)
• 프로젝트당 일일 쓰기 요청 수 (기본값 50개)

참고: 보기 (프로필)당 요청 10,000개 또는 보기 (프로필)당 동시 요청 10개는 늘릴 수 없습니다.

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

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 모니터링 및 사용량 한도를 참조하세요.