할당량을 사용하면 Campaign Manager 360 API를 부적절하게 사용하는 자동 프로세스로부터 Google 인프라를 보호할 수 있습니다. 이를 통해 한 개발자의 행위가 더 큰 커뮤니티에 부정적인 영향을 미치지 않도록 합니다.
할당량 한도
다음 기본 할당량 한도는 모든 Campaign Manager 360 API 리소스 및 메서드에서 공유됩니다.
- 일일 프로젝트당 요청 50,000개 - 증가 가능
- 프로젝트당 1QPS (초당 쿼리 수)
- Google API Console에서는 이 할당량을 사용자별 분당 쿼리 수라고 하며 기본적으로 60으로 설정됩니다. 이 한도는 필요에 따라 최대 600개 (QPS 10개)까지 늘릴 수 있습니다.
보고서 작성 도구는 계정에 따라 다른 추가 할당량 한도를 적용합니다. 자세한 내용은 이 고객센터 도움말과 아래 표를 참고하세요.
할당량 한도 초과
할당량 한도를 초과하여 요청이 실패하는 경우 API는 HTTP 상태 코드와 오류 이유를 반환합니다. 또한 응답 본문에는 오류의 원인에 관한 자세한 설명이 포함되어 있습니다. 오류 응답 예시는 오류 메시지 가이드를 참고하세요.
다음 목록에는 할당량 한도를 초과하여 발생할 수 있는 오류와 요청 실패에 대한 권장 조치가 나와 있습니다.
| 코드 | 이유 | 메시지 | 권장 작업 |
|---|---|---|---|
| 403 | dailyLimitExceeded | 일일 한도 초과 | 문제를 해결하지 않은 상태로 다시 시도하지 마세요. Google API Console에서 사용량을 검토하고 요청 횟수를 줄이기 위해 워크플로를 수정하세요. 사용량이 적절하다고 생각되면 할당량을 추가로 요청할 수 있습니다. |
| 403 | quotaExceeded | 이 계정은 하루 x개의 보고서 할당량을 초과했습니다. | 이 날짜에는 이 계정에 대해 더 이상 보고서를 실행하지 마세요. 계정 관리자에게 문의하여 지원을 받으세요. |
| 403 | quotaExceeded | 이 사용자 프로필은 하루 x개의 보고서 할당량을 초과했습니다. | 이 날짜에 이 사용자 프로필에 대해 더 이상 보고서를 실행하지 마세요. 다른 사용자 프로필로 전환하거나 계정 관리자에게 문의하여 도움을 받으세요. |
| 403 | quotaExceeded | 이 계정은 활성 예약 보고서 x개의 할당량을 초과했습니다. | 이 요청을 다시 시도하기 전에 필요하지 않은 예약된 보고서를 비활성화합니다. |
| 403 | quotaExceeded | 이 보고서를 소유한 사용자 프로필이 활성 예약 보고서 x개의 할당량을 초과했습니다. | 이 요청을 다시 시도하기 전에 이 보고서의 소유자가 필요하지 않은 예약된 보고서를 비활성화하도록 하세요. |
| 403 | quotaExceeded | 이 사용자 프로필은 활성 예약 보고서 x개의 할당량을 초과했습니다. | 이 요청을 다시 시도하기 전에 필요하지 않은 예약된 보고서를 비활성화합니다. |
| 403 | quotaExceeded | 할당량 항목 하나를 초과하여 이 작업을 마칠 수 없습니다. 계정 관리자에게 문의하시기 바랍니다. | 계정 관리자에게 문의하여 지원을 받으세요. |
| 403 | userRateLimitExceeded | 사용자 비율 한도 초과 | Google API Console에서 사용자당 한도를 늘리거나 지수 백오프를 사용하여 요청을 전송하는 속도를 낮춥니다. 이 API로 동시 쓰기 요청을 하거나 10QPS를 초과하는 비율 한도를 사용하는 것은 권장되지 않습니다. |
일일 할당량 추가 요청
애플리케이션에 일일 할당량이 추가로 필요하다고 생각되면 아래 안내에 따라 추가 할당량을 요청할 수 있습니다.
다음 안내는 dailyLimitExceeded 오류가 발생한 프로젝트에만 적용됩니다. 다른 할당량 오류에 대한 권장 조치는 위의 표에 나와 있습니다.
- Google API 콘솔에서 Campaign Manager 360 API로 이동합니다.
- 측정항목 페이지에서 사용 통계를 검토하여 애플리케이션이 예상대로 작동하는지 확인합니다. 호출된 메서드에 세심한 주의를 기울이고 계속하기 전에 예상치 못하거나 과도한 사용을 해결합니다.
- 사용량이 정상적인 것으로 보이면 할당량 페이지로 이동하여 일일 쿼리 수 옆에 있는 수정 아이콘을 클릭하고 '더 큰 할당량 신청' 링크를 클릭합니다.
할당량 상향 요청을 제출하기 전에 정보를 검토하고 할당량 요청 양식에 포함된 안내를 따르세요.