Cuotas y límites de frecuencia

Para garantizar la estabilidad del sistema y la distribución equitativa de los recursos, la API de Google Health aplica límites de frecuencia a las solicitudes entrantes a la API.

Si bien las cuotas predeterminadas están diseñadas para adaptarse a la gran mayoría de los casos de uso estándar, las aplicaciones que superen estos umbrales se limitarán.

Controla el límite de frecuencia y los errores transitorios

Cuando tu aplicación supera un límite de frecuencia asignado, la API rechaza la solicitud y devuelve 429 Too Many Requests (RESOURCE_EXHAUSTED). Los problemas transitorios del servidor también pueden devolver 503 Service Unavailable (UNAVAILABLE) o 504 Gateway Timeout (DEADLINE_EXCEEDED).

Para controlar estas respuestas de forma confiable sin amplificar la carga, implementa la lógica de reintento con retirada exponencial y jitter aleatorio en las respuestas 429 RESOURCE_EXHAUSTED, 503 UNAVAILABLE y 504 DEADLINE_EXCEEDED. Evita los reintentos inmediatos, que agravan la congestión y aumentan la limitación o los tiempos de espera repetidos.

Límites predeterminados y análisis de impacto

Los límites de frecuencia se evalúan en intervalos diarios, por minuto y por usuario. En el análisis de impacto, se describe cómo se traducen estas cuotas en consultas por segundo (QPS).

Métrica Límite predeterminado Análisis del impacto de las QPS
Por proyecto (diario) 86.4 millones de solicitudes por día ~1,000 QPS sostenidas
Por proyecto (por minuto) 120,000 solicitudes por minuto Aumento de actividad de ~2,000 QPS
Por usuario (por minuto) 300 solicitudes por minuto Estándar: 5 QPS por usuario
Aplicaciones no verificadas: Máximo de 250 QPS en total (con un límite de 100 usuarios a 2.5 QPS por usuario)

Límites de frecuencia de otorgamiento de tokens de OAuth

Google Cloud aplica un límite de frecuencia en el otorgamiento de tokens de OAuth para controlar la rapidez con la que tu app puede incorporar o volver a autenticar a los usuarios. Si prevés que superarás los 10,000 registros o reautenticaciones de usuarios en un período de 24 horas, solicita una cuota más alta con anticipación. Para obtener más información, consulta Límites de frecuencia de la aplicación de OAuth.

Solicita un aumento de cuota

Si tu aplicación requiere una capacidad de procesamiento más alta que las asignaciones predeterminadas proporcionadas, puedes solicitar un ajuste a través de la consola de Google Cloud. Consulta Visualiza y administra cuotas.