為了維持最佳系統穩定性和效能，Health Connect 對 Health Connect API 的用戶端連線設有頻率限制。
本指南說明在 Health Connect 中讀取及寫入 API 作業的限制，以及如何透過有效的應用程式設計避免頻率限制。
API 限制
前景及背景 API 作業皆具有固定的要求比率配額限制。
影響頻率和記憶體限制的因素包括應用程式執行的作業類型，以及該作業的執行位置是前景或背景。
讀取和變更記錄限制
針對讀取和變更記錄限制，Health Connect 對應用程式可用的 API 呼叫次數設有兩項限制：
- 應用程式在週期內可對 API 發出 API 呼叫的次數限制。
- 應用程式在一天內可發出的 API 呼叫次數限制。
插入、更新及刪除限制
Health Connect 針對插入、更新及刪除作業設下四種不同的限制：
- 應用程式在週期內可對 API 發出呼叫的次數限制。
- 應用程式在一天內可對 API 發出呼叫的次數限制。
- 插入大量記錄的記憶體限制。
- 插入單筆記錄的記憶體限制。
最佳做法
應用程式與 Health Connect API 互動時，應盡可能減少電池用量、維持最佳系統健康狀態，並促進所有 CRUD 作業採用高效率的資料管理方式。
以下為建議依循的最佳做法。
背景 API 呼叫
背景作業的電池用量會降低使用者體驗，並引發資料隱私權相關問題。
因此，背景頻率限制比前景頻率限制更嚴格。請務必限制應用程式在背景執行的 API 呼叫數量。
例外狀況處理
如果應用程式在將資料寫入 Health Connect 時遇到例外狀況，建議您從例外狀況發生的位置重試。
請勿直接刪除所有與問題相關的資料，然後重試整個寫入要求。這個方法會消耗您的插入配額、降低效能，並對電池續航力產生負面影響。
變更記錄處理
為了盡可能降低應用程式受到頻率限制的風險，您應使用變更記錄處理功能同步處理資料庫與 Health Connect 中的資料，而非過度依賴原始讀取要求。