사용 제한

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

Google Google Drive API는 공유 서비스이므로 모든 사용자가 공정하게 사용하고 Google Workspace 시스템의 전반적인 성능을 보호하기 위해 할당량과 제한사항을 적용합니다.

할당량을 초과하면 403: User rate limit exceeded HTTP 상태 코드 응답이 전송됩니다. Drive 백엔드에서 비율 제한을 추가로 확인하면 429: Too many requests 응답이 생성될 수도 있습니다. 이 경우 지수 백오프 알고리즘을 사용하고 나중에 다시 시도해야 합니다. 아래의 분당 할당량 한도 내에서 유지할 수 있는 일일 요청 수에는 제한이 없습니다.

다음 표에서는 쿼리 한도를 자세히 보여줍니다.

할당량
쿼리
100초당 20,000
하루 할당량 1,000,000,000 (10억)
사용자당 100초당 20,000

시간 기반 할당량 오류 해결

모든 시간 기반 오류 (X분당 최대 N개의 요청)의 경우 코드가 예외를 포착하고 지수 백오프 알고리즘을 사용하여 다시 시도하기 전에 약간의 지연을 구현하는 것이 좋습니다. 그래도 요청에 실패하면 요청이 성공할 때까지 시간이 지남에 따라 요청 간의 지연이 증가하는 것이 중요합니다. 일반적으로 잘린 지수 백오프를 사용해야 합니다. 지수 백오프 사용 방법을 알아보려면 재시도 전략을 참조하세요.

가격 책정

Google Drive API는 모두 무료로 사용할 수 있습니다. 할당량 요청 한도를 초과해도 추가 요금이 발생하지 않으며 계정에 요금이 청구되지 않습니다.

할당량 상향 조정을 요청합니다.

프로젝트의 리소스 사용량에 따라 할당량 상향 조정을 요청해야 할 수 있습니다. 서비스 계정에 의한 API 호출은 단일 계정을 사용하는 것으로 간주되므로 이 시나리오에서는 사용자당, 프로젝트당 할당량을 늘려야 할 수 있습니다. 할당량 상향을 신청해도 승인이 보장되지는 않습니다. 할당량을 늘리는 데 동의하는 경우 시간이 더 걸릴 수 있습니다.

자세한 내용은 아래 리소스를 참고하세요.