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