Quote e limiti di frequenza

Per garantire la stabilità del sistema e un'equa distribuzione delle risorse, l'API Google Health applica limiti di frequenza alle richieste API in entrata.

Sebbene le quote predefinite siano progettate per soddisfare la stragrande maggioranza dei casi d'uso standard, le applicazioni che superano queste soglie verranno limitate.

Gestisci gli errori di limitazione di frequenza e temporanei

Quando l'applicazione supera un limite di frequenza assegnato, l'API rifiuta la richiesta e restituisce 429 Too Many Requests (RESOURCE_EXHAUSTED). I problemi temporanei del server possono anche restituire 503 Service Unavailable (UNAVAILABLE) o 504 Gateway Timeout (DEADLINE_EXCEEDED).

Per gestire queste risposte in modo affidabile senza amplificare il carico, implementa la logica di ripetizione con backoff esponenziale e jitter casuale sulle risposte 429 RESOURCE_EXHAUSTED, 503 UNAVAILABLE e 504 DEADLINE_EXCEEDED. Evita i tentativi immediati, che aggravano la congestione e aumentano la limitazione o i timeout ripetuti.

Limiti predefiniti e analisi dell'impatto

I limiti di frequenza vengono valutati su intervalli giornalieri, al minuto e per utente. L'analisi dell'impatto descrive come queste quote si traducono in query al secondo (QPS).

Metrica Limite predefinito Analisi dell'impatto delle QPS
Per progetto (giornaliero) 86,4 milioni di richieste al giorno ~1000 QPS sostenute
Per progetto (al minuto) 120.000 richieste/minuto Burst di ~2000 QPS
Per utente (al minuto) 300 richieste/minuto Standard: 5 QPS per utente
Applicazioni non verificate: massimo 250 QPS totali (limite di 100 utenti a 2,5 QPS per utente)

Limiti di frequenza di concessione di token OAuth

Google Cloud applica un limite di frequenza alle concessioni di token OAuth per controllare la velocità con cui la tua app può eseguire l'onboarding o la riautenticazione degli utenti. Se prevedi di superare le 10.000 registrazioni o riautenticazioni degli utenti in un periodo di 24 ore, richiedi una quota più elevata in anticipo. Per saperne di più, consulta Limiti di frequenza delle applicazioni OAuth.

Richiedi un aumento della quota

Se la tua applicazione richiede un throughput superiore alle allocazioni predefinite fornite, puoi richiedere un aggiustamento tramite la console Google Cloud. Consulta Visualizza e gestisci le quote.