Para mantener la estabilidad y el rendimiento óptimos del sistema, Health Connect impone límites de frecuencia a las conexiones de clientes a la API de Health Connect.
En esta guía, se describen los límites impuestos a las operaciones de lectura y escritura de la API en Health Connect, y cómo evitar el límite de frecuencia mediante un diseño eficiente de apps.
Límites de API
Los límites se establecen en las operaciones de la API en primer y segundo plano como cuotas de frecuencia de solicitudes fijas.
Los límites de frecuencia y memoria varían según el tipo de operación que ejecute la app y si esta se realiza en primer o segundo plano.
Límites de lectura y registro de cambios
En el caso de los límites de lectura y registro de cambios, Health Connect impone dos límites en la cantidad de llamadas a la API disponibles para tu app:
- Un límite periódico sobre la cantidad de llamadas a la API que tu app puede realizar a la API
- Un límite diario sobre la cantidad de llamadas a la API que puede hacer tu app
Cómo insertar, actualizar y borrar límites
Health Connect establece cuatro límites distintos en las operaciones de inserción, actualización y eliminación:
- Un límite periódico sobre la cantidad de llamadas que puede hacer tu app a la API
- Un límite diario sobre la cantidad de llamadas que puede realizar tu app a la API
- Un límite de memoria para las inserciones masivas
- Un límite de memoria para las inserciones de registro único
Prácticas recomendadas
Recomendamos que las apps interactúen con la API de Health Connect de una manera que minimice el uso de batería, mantenga un estado óptimo del sistema y promueva una administración de datos eficiente en todas las operaciones de CRUD.
Estos son algunos lineamientos de las prácticas recomendadas que debes cumplir.
Llamadas a la API en segundo plano
El uso de batería para las operaciones en segundo plano reduce la experiencia del usuario y genera preguntas relacionadas con la privacidad de los datos.
Por lo tanto, el límite de frecuencia en segundo plano es más estricto que el límite de frecuencia en primer plano. En consecuencia, es importante limitar la cantidad de llamadas a la API que realiza la app en segundo plano.
Manejo de excepciones
Si tu app experimenta una excepción cuando escribe datos en Health Connect, te recomendamos que vuelvas a intentarlo desde donde se produjo la excepción.
No borres todos los datos en cuestión y vuelve a intentar realizar la solicitud de escritura completa. Este enfoque afecta la cuota de inserción, reduce el rendimiento y tiene un efecto negativo en la duración de batería.
Manejo del registro de cambios
Para minimizar el riesgo de que tu app se vea limitada por la frecuencia, debes usar el manejo del registro de cambios para sincronizar tu base de datos con los datos de Health Connect, en lugar de depender demasiado de las solicitudes de lectura sin procesar.