할당량

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

할당량 한도

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

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

참고: 일일 할당량은 PST를 기준으로 자정에 새로고침됩니다.

할당량 한도 초과

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

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

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

지수 백오프란 무엇인가요?

지수 백오프는 클라이언트에서 시간 간격을 늘려 실패한 요청을 주기적으로 다시 시도하는 네트워크 애플리케이션용 표준 오류 처리 전략입니다. 많은 양의 요청 또는 네트워크 트래픽으로 인해 서버에서 오류를 반환하는 경우 지수 백오프는 이러한 오류를 처리하는 데 효과적인 전략일 수 있습니다. 반대로 잘못된 승인 사용자 인증 정보 또는 파일을 찾을 수 없는 오류 등 네트워크 트래픽 양이나 응답 시간과 무관한 오류를 처리할 때는 적절한 전략이 아닙니다.

지수 백오프를 적절하게 사용하면 대역폭 사용량의 효율성을 높이고, 성공적인 응답을 가져오는 데 필요한 요청 수를 줄이며, 동시 환경에서의 요청 처리량을 극대화할 수 있습니다.

간단한 지수 백오프 구현 흐름은 다음과 같습니다.

1. API에 요청을 전송합니다.
2. 요청을 재시도해야 함을 알리는 HTTP 503 응답을 수신합니다.
3. 1초 + random_number_milliseconds를 대기한 후 요청을 재시도합니다.
4. 요청을 재시도해야 함을 알리는 HTTP 503 응답을 수신합니다.
5. 2초 + random_number_milliseconds를 대기한 후 요청을 재시도합니다.
6. 요청을 재시도해야 함을 알리는 HTTP 503 응답을 수신합니다.
7. 4초 + random_number_milliseconds를 대기한 후 요청을 재시도합니다.
8. 요청을 재시도해야 함을 알리는 HTTP 503 응답을 수신합니다.
9. 8초 + random_number_milliseconds를 대기한 후 요청을 재시도합니다.
10. 요청을 재시도해야 함을 알리는 HTTP 503 응답을 수신합니다.
11. 16초 + random_number_milliseconds를 대기한 후 요청을 재시도합니다.
12. 중지합니다. 오류를 보고하거나 로깅합니다.

위 흐름에서 random_number_milliseconds는 1,000밀리초 이하의 임의 숫자입니다. 보다 균일하게 부하를 분산하고 서버 과부하 가능성을 방지하므로 이와 같은 임의의 작은 지연이 필요합니다. random_number_milliseconds 값은 대기 후 매번 재정의해야 합니다.

참고: 대기 시간은 항상 (2 ^ n) + random_number_milliseconds이며, 여기서 n은 단순 증가 정수로서 처음에는 0으로 정의됩니다. 정수 n은 반복(요청)할 때마다 1씩 증가합니다.

n이 5일 때 종료하도록 알고리즘이 설정되어 있습니다. 이러한 제한은 클라이언트의 무제한 재시도를 방지하고 요청이 '복구 불가능한 오류'로 간주되기 전에 약 32초의 총 지연 시간을 발생시킵니다. 특히 긴 업로드가 진행 중인 경우에는 최대 재시도 횟수를 늘리는 것이 좋습니다. 단, 재시도 지연 시간을 합리적인 시간(1분 미만)으로 제한해야 합니다.

추가 일일 할당량 요청

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

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

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

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

참고: 담당자가 추가 정보를 요청할 수 있으므로 자주 확인하는 이메일 주소를 제공해 주셔야 합니다.