Google 애널리틱스는 수백만 개의 사이트에서 사용됩니다. Google은 시스템에서 처리할 수 있는 것보다 많은 데이터를 수신하지 않도록 보호하고 시스템 리소스가 균등하게 분산되도록 API 요청에 한도와 할당량을 적용합니다. 한도와 할당량은 변경될 수 있습니다.
비율 제한
API 비율 제한을 사용하면 Google 애널리틱스 Admin API에 전송할 수 있는 요청 수를 정의할 수 있습니다. 비율 제한이 적용되고 60초(1분) 간격으로 자동으로 다시 채워집니다. 즉, 프로젝트가 60초 이내에 비율 제한의 최대값에 도달하면 할당량이 다시 채워질 때까지 기다린 후에 해당 그룹에서 추가 요청을 해야 합니다. 프로젝트가 비율 제한을 초과하면 rateLimitExceeded 이유와 함께 403 오류가 발생합니다. 이 오류를 해결하려면 1분 정도 기다린 후 요청을 다시 시도하세요. 할당량은 다음 간격이 시작될 때 다시 채워져야 합니다.
일일 API 요청의 최대 개수는 API 비율 제한에 따라 자연스럽게 제한되며, 현재 Google Analytics Admin API에 대한 명시적인 일일 사용 할당량은 없습니다.
Cloud 프로젝트 할당량
API 비율 제한은 프로젝트별로 적용됩니다.
Cloud 콘솔에서는 클라우드 프로젝트의 할당량을 보여줍니다(https://console.cloud.google.com/apis/api/analyticsadmin.googleapis.com/quotas).
다음은 대부분의 사용자에게 콘솔에서 표시되는 Google Analytics Admin API의 기본 할당량입니다. Google 애널리틱스 서비스 약관을 위반하는 프로젝트의 할당량 한도는 자동으로 제한될 수 있습니다.
| 할당량 이름 | 한도 |
|---|---|
| 분당 요청 수 | 1,200 |
| 사용자당 분당 요청 수 | 600 |
| 분당 쓰기 | 600 |
| 사용자당 분당 쓰기 | 180명 |
Google Analytics Admin API에 대한 각 요청에서 Requests per minute, Requests per minute per user 할당량을 사용합니다. 어떤 식으로든 Google 애널리틱스 계정 구성을 변경하는 메서드 (create, patch, delete, archive, update 메서드)에 대한 요청도 Writes per minute 및 Writes per minute per user 할당량을 사용합니다.
사용자 단위로 API 요청을 제한하는 방법에 대한 자세한 내용은 API 사용량 상한 설정 문서를 참조하세요.