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