'Google Analytics API 사용자 비율 제한 초과(User Rate Limit Exceeded)' 오류는 API 요청 횟수가 Google이 설정한 허용 임계값을 초과했을 때 나타납니다. 이러한 제한을 일반적으로 스로틀링(throttling)이라고 부르며, 오류가 발생하면 UserRateLimitExceeded라는 라벨이 붙은 403 오류와 함께 추가 요청이 일시적으로 차단됩니다. 짧은 시간 안에 분당 또는 일일 허용량을 넘어서 너무 많은 API 호출이 이루어질 때 주로 발생합니다.
구글 애널리틱스 API 할당량 한도 늘리는 방법
이 오류가 반복되지 않도록 하려면 Google Cloud Console을 통해 할당량(쿼터) 한도 상향 조정을 직접 요청할 수 있습니다. 이렇게 하면 애플리케이션이 스로틀링에 걸리지 않고 더 많은 양의 API 요청을 보낼 수 있습니다.
참고: 올바른 Google Cloud 프로젝트에 로그인되어 있어야 하며, 할당량 변경을 요청하려면 프로젝트 소유자(Project Owner) 권한 또는 필요한 IAM 권한이 있어야 합니다.
1단계: Google Cloud Console 접속
Google Cloud Console에 접속한 후 본인의 계정으로 로그인합니다.
2단계: 탐색 메뉴 열기
대시보드 왼쪽 상단에 있는 탐색 메뉴(Navigation Menu) 아이콘을 클릭합니다.
3단계: API 및 서비스 선택
메뉴 목록에서 API 및 서비스(API & Services)를 클릭하여 프로젝트에서 사용 중인 API에 접근합니다.
4단계: Google Analytics API 선택
목록에서 Google Analytics API를 찾아 선택합니다.
5단계: 할당량 및 시스템 한도 열기
API 세부 정보 화면에서 할당량 및 시스템 한도(Quotas & System Limits)를 클릭하면 현재 사용량과 한도를 확인할 수 있습니다.
6단계: 일일 쿼리 수 할당량 수정
Queries Per Day(일일 쿼리 수) 항목 옆의 점 세 개 메뉴를 클릭하고 할당량 수정(Edit Quota)을 선택합니다. 프로젝트 유형에 따라 100초당 쿼리 수 또는 초당 쿼리 수 등 다른 할당량 항목이 함께 표시될 수 있습니다.
7단계: 할당량 증가 요청 제출
새 값(New Value) 입력란에 원하는 할당량 값을 입력합니다. 표시되는 경고 화면에서 '이해했습니다(I understand)'를 선택한 뒤 제출(Submit) 버튼을 눌러 요청을 완료합니다.
(참고: 최대 허용 한도는 API 종류, 계정 상태, 프로젝트 구성에 따라 달라질 수 있습니다.)
8단계: 분당 쿼리 수 조정 (필요한 경우)
사용 환경에서 고빈도 API 호출이 이루어진다면 동일한 방법으로 Queries Per Minute(분당 쿼리 수) 할당량도 조정하여 추가적인 비율 제한 오류를 예방하세요.
저자 소개
Kevin Arrows
Kevin Arrows는 10년 이상의 업계 경력을 지닌 베테랑 기술 전문가입니다. Microsoft 공인 기술 전문가(MCTS) 자격증을 보유하고 있으며, 최신 기술 동향을 끊임없이 학습하는 것에 깊은 열정을 가지고 있습니다. 소프트웨어 개발, 사이버 보안, 클라우드 컴퓨팅 등 폭넓은 IT 분야에서 수많은 글을 집필해 왔으며, 복잡한 기술 개념을 명확하고 간결하게 설명하는 능력으로 동료들에게 폭넓은 인정과 신뢰를 받고 있습니다.