Kontingente und Ratenlimits

Um die Systemstabilität und eine gerechte Ressourcenverteilung zu gewährleisten, werden für eingehende API-Anfragen an die Google Health API Ratenbegrenzungen erzwungen.

Die Standardkontingente sind so konzipiert, dass sie für die meisten Standardanwendungsfälle ausreichen. Anwendungen, die diese Schwellenwerte überschreiten, werden jedoch gedrosselt.

Ratenbegrenzungen und vorübergehende Fehler behandeln

Wenn Ihre Anwendung eine zugewiesene Ratenbegrenzung überschreitet, lehnt die API die Anfrage ab und gibt 429 Too Many Requests (RESOURCE_EXHAUSTED) zurück. Vorübergehende Serverprobleme können auch 503 Service Unavailable (UNAVAILABLE) oder 504 Gateway Timeout (DEADLINE_EXCEEDED) zurückgeben.

Wenn Sie diese Antworten zuverlässig verarbeiten möchten, ohne die Last zu erhöhen, implementieren Sie eine Wiederholungslogik mit exponentiellem Backoff und zufälligem Jitter für 429 RESOURCE_EXHAUSTED-, 503 UNAVAILABLE- und 504 DEADLINE_EXCEEDED-Antworten. Vermeiden Sie sofortige Wiederholungsversuche, da diese die Überlastung verschlimmern und zu wiederholter Drosselung oder Zeitüberschreitungen führen.

Standardlimits und Wirkungsanalyse

Ratenlimits werden in täglichen, minütlichen und nutzerspezifischen Intervallen ausgewertet. In der Auswirkungsanalyse wird beschrieben, wie diese Kontingente in Abfragen pro Sekunde (QPS) umgerechnet werden.

Messwert Standardlimit Analyse der Auswirkungen auf die Abfragen pro Sekunde
Pro Projekt (täglich) 86,4 Mio.Anfragen pro Tag ~1.000 Abfragen pro Sekunde (stabil)
Pro Projekt (minütlich) 120.000 Anfragen pro Minute ~2.000 Abfragen pro Sekunde Burst
Pro Nutzer (minütlich) 300 Anfragen pro Minute Standard: 5 Abfragen pro Sekunde und Nutzer
Nicht bestätigte Anwendungen: maximal 250 Abfragen pro Sekunde insgesamt (begrenzt auf 100 Nutzer mit 2,5 Abfragen pro Sekunde und Nutzer)

Ratenbegrenzungen für die Erteilung von OAuth-Tokens

Google Cloud erzwingt eine Ratenbegrenzung für OAuth-Token-Zuweisungen, um zu steuern, wie schnell Ihre App Nutzer einbinden oder neu authentifizieren kann. Wenn Sie davon ausgehen,dass innerhalb eines gleitenden Zeitfensters von 24 Stunden mehr als 10.000 Nutzerregistrierungen oder -neuauthentifizierungen erfolgen, sollten Sie im Voraus ein höheres Kontingent anfordern. Weitere Informationen finden Sie unter Ratenbegrenzungen für OAuth-Anwendungen.

Kontingenterhöhung anfordern

Wenn Ihre Anwendung einen höheren Durchsatz als die standardmäßig bereitgestellten Zuweisungen erfordert, können Sie über die Google Cloud Console eine Anpassung anfordern. Weitere Informationen finden Sie unter Kontingente aufrufen und verwalten.