避免速率限制的计划

为保持最佳系统稳定性和性能,Health Connect 对客户端连接 Health Connect API 施加了速率限制。

本指南概述了 Health Connect 中读写 API 操作的限制,以及如何通过高效的应用设计避免速率限制。

API 限制

对前台和后台 API 操作均施加了限制,作为固定请求速率配额

速率和内存限制根据您的应用正在执行的操作类型以及该操作是在前台还是后台发生而变化。

读取和更改日志限制

对于读取和更改日志限制,Health Connect 对您的应用可用的 API 调用次数施加了两项限制

  • 您的应用可以对 API 进行的 API 调用次数的周期性限制。
  • 您的应用每天可以进行的 API 调用次数的每日限制。

插入、更新和删除限制

Health Connect 对插入、更新和删除操作施加了四项不同的限制

  • 您的应用可以对 API 进行的调用次数的周期性限制。
  • 您的应用每天可以对 API 进行的调用次数的每日限制。
  • 批量插入的内存限制。
  • 单条记录插入的内存限制。

最佳实践

我们建议应用以最大限度减少电池使用、保持最佳系统健康状况并促进所有 CRUD 操作中高效数据管理的方式与 Health Connect API 交互。

以下是一些应遵循的最佳实践准则。

后台 API 调用

后台操作的电池使用会降低用户体验,并引发有关数据隐私的问题。

因此,后台速率限制比前台速率限制更严格。因此,限制您的应用在后台执行的 API 调用量非常重要。

异常处理

如果您的应用在将数据写入 Health Connect 时遇到异常,我们建议从异常发生的地方重试。

不要简单地删除所有相关数据并重试整个写入请求。这种方法会消耗您的插入配额,降低性能,并对电池续航时间产生负面影响。

更改日志处理

为了最大限度地降低您的应用受到速率限制的风险,您应该利用更改日志处理将您的数据库与 Health Connect 的数据同步,而不是过度依赖原始读取请求。