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

Management API

Google 애널리틱스에서는 다음 Management API에 대한 요청에 할당량을 적용합니다.

API 작성

다음 할당량은 쓰기 (insert, update, patch, delete) 요청에 적용됩니다.

  • 프로젝트당 일일 쓰기 요청 50회(늘릴 수 있음)
  • 계정 ID당 1.5QPS (초당 쿼리 수)

쓰기 요청 오류

쓰기 요청이 실패하고 응답 코드 500 또는 503가 수신되면 다시 제출할 수 있습니다. Google 애널리틱스에서 다음을 사용할 수 있습니다.

  • 시간당 실패한 쓰기 요청 50개

시간당 실패한 쓰기 요청을 50개 이상 제출하려고 하면 다음 오류가 발생합니다.

Quota Error: The number of recent failed writes is too high.

실패한 쓰기 요청을 계속해서 다시 제출하는 대신 지수 백오프를 구현하여 다시 제출합니다.

데이터 가져오기 API

다음 할당량은 Uploads 리소스에만 적용됩니다.

  • 전체 기간 확장 데이터 가져오기 저장용량 한도 (컬렉션 API 및 SDK에서 전송된 조회 데이터에는 적용되지 않음):
  • 속성당 데이터 세트 50개
  • 하루에 속성당 업로드 작업 50개
  • 업로드된 파일당 1GB
  • 비용 데이터별 한도:
    • 일일 (ga:date) 데이터 세트당 100MB 예를 들어 한 번의 업로드로 2014년 10월 10일의 데이터 50MB를 가져오고 두 번째 업로드로 2014년 10월 10일의 데이터 50MB를 가져오면 해당 데이터 세트의 2014년 10월 10일 기준 100MB 한도에 도달한 것입니다.

실험 API

이 할당량은 실험에만 적용됩니다.

  • 보기 (프로필)당 실험 12회

다음 statuses 중 하나를 사용한 실험은 이 할당량에 반영됩니다.

  • DRAFT
  • READY_TO_RUN
  • RUNNING

2일을 초과하는 실험 (상태 = ENDED)은 이 할당량에 포함되지 않습니다.

샘플링되지 않은 보고서 API

이 할당량은 샘플링되지 않은 보고서에만 적용됩니다.

  • 샘플링되지 않은 보고서를 만들기 위한 API 요청은 일반 쓰기 요청 할당량에 따라 집계됩니다.
  • API는 웹 인터페이스에서 샘플링되지 않은 보고서를 만드는 데 사용하는 것과 동일한 속성별, 일일 토큰 시스템을 사용합니다.
  • 샘플링되지 않은 보고서는 최대 3,500개까지 허용됩니다. 이 한도에 도달한 후 API를 사용하여 샘플링되지 않은 보고서를 추가로 만들려고 하면 다음과 같은 오류가 발생합니다.
    Error creating this entity. You have reached the maximum allowed entities of this type.

사용자 권한 API

이 할당량은 사용자 권한에만 적용됩니다.

  • 사용자당 최대 100개의 애널리틱스 계정을 보유할 수 있습니다. 애널리틱스 계정이 100개인 사용자를 새 계정에 추가하면 오류가 발생합니다.

사용자 권한에 대한 일괄 쓰기 (delete, insert, update) 요청에는 다음 할당량이 적용됩니다.

  • 일괄 요청당 사용자 권한 쓰기 요청 300개
  • 사용자 권한 일괄 쓰기 요청 30개는 쓰기 요청 1회로 집계됨

할당량 한도 초과

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