시스템 안정성과 공평한 리소스 분배를 보장하기 위해 Google Health API는 수신 API 요청에 비율 제한을 적용합니다.
기본 할당량은 대부분의 표준 사용 사례를 수용하도록 설계되었지만, 이 기준점을 초과하는 애플리케이션은 제한됩니다.
비율 제한 및 일시적인 오류 처리
애플리케이션이 할당된 비율 제한을 초과하면 API는 요청을 거부하고 429 Too Many Requests(RESOURCE_EXHAUSTED)를 반환합니다. 일시적인 서버 문제로 인해 503 Service Unavailable(UNAVAILABLE) 또는 504 Gateway Timeout(DEADLINE_EXCEEDED)가 반환될 수도 있습니다.
부하를 증폭하지 않고 이러한 응답을 안정적으로 처리하려면 429 RESOURCE_EXHAUSTED, 503 UNAVAILABLE, 504 DEADLINE_EXCEEDED 응답에 지수 백오프 및 무작위 지터를 사용하여 재시도 로직을 구현합니다. 혼잡을 가중시키고 반복적인 제한 또는 시간 초과를 증가시키는 즉각적인 재시도를 피합니다.
기본 한도 및 영향 분석
비율 제한은 일별, 분별, 사용자별 간격으로 평가됩니다. 영향 분석에서는 이러한 할당량이 초당 쿼리 수(QPS)로 어떻게 변환되는지 간략하게 설명합니다.
| 측정항목 | 기본 한도 | QPS 영향 분석 |
|---|---|---|
| 프로젝트별(일일) | 요청 8,640만 회/일 | ~1,000QPS 지속 |
| 프로젝트별(분당) | 120,000회 요청/분 | ~2,000QPS 버스트 |
| 사용자별(분당) | 요청 300회/분 | 표준: 사용자당 5QPS 미인증 애플리케이션: 최대 총 250QPS(사용자 100명으로 제한 @ 사용자당 2.5QPS) |
OAuth 토큰 부여 비율 제한
Google Cloud는 OAuth 토큰 부여에 비율 제한을 적용하여 앱에서 사용자를 온보딩하거나 재인증할 수 있는 속도를 제어합니다. 24시간 슬라이딩 윈도우 내에 사용자 가입 또는 재인증이 10,000회를 초과할 것으로 예상되는 경우 사전에 할당량 상향 조정을 요청하세요. 자세한 내용은 OAuth 애플리케이션 비율 제한을 참조하세요.할당량 상향 요청
애플리케이션에 제공된 기본 할당량보다 높은 처리량이 필요한 경우 Google Cloud 콘솔을 통해 조정을 요청할 수 있습니다. 할당량 보기 및 관리를 참조하세요.