할당량 및 비율 제한

시스템 안정성과 공정한 리소스 분배를 보장하기 위해 Google Health API는 수신 API 요청에 비율 제한을 적용합니다.

기본 할당량은 대부분의 표준 사용 사례를 수용하도록 설계되었지만 이러한 기준점을 초과하는 애플리케이션은 제한됩니다.

비율 제한 오류 처리

애플리케이션이 할당된 비율 한도를 초과하면 API가 요청을 거부하고 429 Too Many Requests 오류를 반환합니다. 오류를 완화하려면 애플리케이션이 요청 전송을 백오프하고 재시도 로직을 구현하여 비율 제한 이벤트를 단계적으로 처리해야 합니다.

기본 한도 및 영향 분석

비율 제한은 일별, 분별, 사용자별 간격으로 평가됩니다. 영향 분석에서는 이러한 할당량이 초당 쿼리 수 (QPS)로 변환되는 방식을 설명합니다.

측정항목	기본 한도	QPS 영향 분석
프로젝트별 (일별)	8,640만 요청 / 일	~1,000 QPS 지속
프로젝트별 (분 단위)	120,000 요청 / 분	~2,000 QPS 버스트
사용자별 (분 단위)	300 요청 / 분	표준: 사용자당 5QPS 인증되지 않은 애플리케이션: 총 최대 250QPS (사용자당 2.5QPS로 100명의 사용자에게 제한됨)

할당량 상향 요청

애플리케이션에 제공된 기본 할당량보다 높은 처리량이 필요한 경우 Google Cloud 콘솔을 통해 조정을 요청할 수 있습니다. 할당량 보기 및 관리를 참고하세요.