Pour assurer la stabilité du système et une distribution équitable des ressources, l'API Google Health applique des limites de débit aux requêtes API entrantes.
Bien que les quotas par défaut soient conçus pour s'adapter à la grande majorité des cas d'utilisation standards, les applications qui dépassent ces seuils seront limitées.
Gérer les erreurs de limitation du débit et les erreurs temporaires
Lorsque votre application dépasse une limite de débit allouée, l'API rejette la requête et renvoie 429 Too Many Requests (RESOURCE_EXHAUSTED). Des problèmes de serveur temporaires peuvent également renvoyer 503 Service Unavailable (UNAVAILABLE) ou 504 Gateway Timeout (DEADLINE_EXCEEDED).
Pour gérer ces réponses de manière fiable sans augmenter la charge, implémentez une logique de nouvelle tentative avec un intervalle exponentiel entre les tentatives et une gigue aléatoire sur les réponses 429 RESOURCE_EXHAUSTED, 503 UNAVAILABLE et 504 DEADLINE_EXCEEDED. Évitez les nouvelles tentatives immédiates, qui aggravent la congestion et augmentent les limitations ou les délais d'expiration répétés.
Limites par défaut et analyse d'impact
Les limites de débit sont évaluées par jour, par minute et par utilisateur. L'analyse d'impact décrit comment ces quotas se traduisent en requêtes par seconde (RPS).
| Métrique | Limite par défaut | Analyse de l'impact sur les RPS |
|---|---|---|
| Par projet (quotidien) | 86,4 millions de requêtes par jour | ~1 000 RPS soutenues |
| Par projet (par minute) | 120 000 requêtes/minute | ~2 000 RPS en rafale |
| Par utilisateur (par minute) | 300 requêtes/minute | Standard : 5 RPS par utilisateur Applications non validées : 250 RPS au maximum (limité à 100 utilisateurs à 2,5 RPS par utilisateur) |
Limitation du débit d'octroi de jetons OAuth
Google Cloud applique une limite de débit aux attributions de jetons OAuth pour contrôler la vitesse à laquelle votre application peut intégrer ou réauthentifier les utilisateurs. Si vous prévoyez de dépasser 10 000 inscriptions ou réauthentifications d'utilisateurs sur une période glissante de 24 heures, demandez un quota plus élevé à l'avance. Pour en savoir plus, consultez Limitation du débit des applications OAuth.Demander une augmentation de quota
Si votre application nécessite un débit supérieur aux allocations par défaut, vous pouvez demander un ajustement via la console Google Cloud. Consultez Afficher et gérer les quotas.