할당량

할당량은 부적절한 방식으로 Google Bid Manager API를 사용하는 자동화된 프로세스로부터 Google 인프라를 보호합니다. 한 개발자의 행동이 대규모 커뮤니티에 부정적인 영향을 미치지 않도록 합니다.

할당량 한도

다음 기본 할당량 한도는 모든 Bid Manager API 리소스 및 메서드에서 공유됩니다.

  • 프로젝트당 일일 요청 2,000개 - 늘어날 수 있음
  • 프로젝트당 초당 쿼리 수 (QPS) 4개
    • Google API 콘솔에서는 이 할당량을 사용자별 분당 쿼리 수라고 하며 240으로 설정되어 있습니다.

할당량 한도 초과

드물지만 할당량 한도 초과로 요청이 실패하면 API에서 HTTP 상태 코드와 오류의 원인을 반환합니다. 또한 응답 본문에 오류의 원인에 대한 자세한 설명이 포함되어 있습니다. 오류 응답 예는 오류 메시지 가이드를 참고하세요.

다음 목록에는 발생 가능한 오류와 할당량 한도 초과로 인해 실패한 요청에 대한 권장 조치가 나와 있습니다.

코드 이유 메시지 권장 조치
403 dailyLimitExceeded 일일 한도 초과 문제를 해결하지 않은 상태로 다시 시도하지 마세요. Google API 콘솔에서 사용량을 검사하고 더 적은 수의 요청이 되도록 워크플로를 수정하세요. 사용량이 적당하다고 생각되면 추가 할당량을 요청할 수 있습니다.
403 userRateLimitExceeded 사용자 비율 제한 초과 지수 백오프를 사용하여 요청을 전송하는 속도를 늦추세요.

추가 일일 할당량 요청

애플리케이션에 추가 일일 할당량이 필요하다고 생각되면 아래 안내에 따라 추가로 요청할 수 있습니다.

다음 안내는 dailyLimitExceeded 오류가 발생한 프로젝트에만 적용됩니다. 다른 할당량 오류의 권장 조치는 위 표에 나와 있습니다.

  1. Google API 콘솔에서 Bid Manager API로 이동합니다.
  2. 측정항목 페이지에서 사용 통계를 검토하여 애플리케이션이 예상대로 작동하는지 확인합니다. 호출된 메서드를 주의 깊게 살피고 계속 진행하기 전에 예상치 못하거나 과도한 사용 문제를 해결합니다.
  3. 사용량이 정상적인 경우 할당량 페이지로 이동하여 일일 쿼리 옆에 있는 수정 아이콘을 클릭하고 '더 큰 할당량 신청' 링크를 클릭합니다.

상향 요청을 제출하기 전에 할당량 요청 양식에 포함된 정보를 검토하고 안내를 따르세요.