Um eine optimale Systemstabilität und ‑leistung zu gewährleisten, gelten für Clientverbindungen zur Health Connect API Ratenlimits.
In diesem Leitfaden werden die Limits für Lese- und Schreib-API-Vorgänge in Health Connect beschrieben. Außerdem wird erläutert, wie Sie durch ein effizientes App-Design die Ratenbegrenzung vermeiden können.
API-Limits
Sowohl für API-Vorgänge im Vordergrund als auch im Hintergrund gelten feste Ratenkontingente für Anfragen.
Raten- und Arbeitsspeicherlimits variieren je nach Art des Vorgangs, den Ihre App ausführt, und danach, ob der Vorgang im Vordergrund oder im Hintergrund stattfindet.
Limits für Lesevorgänge und das Abfragen von Datenänderungen
Für Lesevorgänge und das Abfrage von Datenänderungen gelten in Health Connect zwei Limits für die Anzahl der API-Aufrufe, die für Ihre App verfügbar sind:
- Ein zeitraumbezogenes Limit für die Anzahl der API-Aufrufe, die Ihre App an die API senden kann.
- Ein Tageslimit für die Anzahl der API-Aufrufe, die Ihre App ausführen kann.
Limits für Einfüge-, Aktualisierungs- und Löschvorgänge
Health Connect legt vier verschiedene Limits für Einfüge-, Aktualisierungs- und Löschvorgänge fest:
- Ein zeitraumbezogenes Limit für die Anzahl der Aufrufe, die Ihre App an die API senden kann.
- Ein Tageslimit für die Anzahl der Aufrufe, die Ihre App an die API senden kann.
- Ein Arbeitsspeicherlimit für Bulk-Einfügungen.
- Ein Arbeitsspeicherlimit für das Einfügen einzelner Datensätze.
Best Practices
Wir empfehlen, dass Apps so mit der Health Connect API interagieren, dass der Akkuverbrauch minimiert, ein optimaler Systemzustand aufrechterhalten und eine effiziente Datenverwaltung bei allen CRUD-Vorgängen gefördert wird.
Hier sind einige Best Practices, an die Sie sich halten sollten.
API-Aufrufe im Hintergrund
Die Akkunutzung für Hintergrundvorgänge beeinträchtigt die Nutzerfreundlichkeit und wirft Fragen zum Datenschutz auf.
Daher ist die Ratenbegrenzung für Vorgänge im Hintergrund strenger als die Ratenbegrenzung für Vorgänge im Vordergrund. Aus diesem Grund ist es wichtig, die Anzahl der API-Aufrufe zu begrenzen, die Ihre App im Hintergrund ausführt.
Umgang mit Ausnahmen
Wenn in Ihrer App beim Schreiben von Daten in Health Connect eine Ausnahme auftritt, empfehlen wir, den Vorgang an der Stelle fortzusetzen, an der die Ausnahme aufgetreten ist.
Löschen Sie nicht alle betreffenden Daten und wiederholen Sie auch nicht die gesamte Schreibanfrage. Dieser Ansatz verringert Ihr Kontingent für Einfügevorgänge, beeinträchtigt die Leistung und wirkt sich negativ auf die Akkulaufzeit aus.
Umgang mit Datenänderungen
Um das Risiko zu minimieren, dass bei Ihrer App Ratenlimits greifen, sollten Sie lediglich Datenänderungen aus Health Connect pullen, um Ihre Datenbank mit Daten aus Health Connect zu synchronisieren, anstatt sich zu sehr auf Anfragen zum Lesen von Rohdaten zu verlassen.