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.