Để duy trì sự ổn định và hiệu suất tối ưu của hệ thống, ứng dụng Health Connect hạn chế số lượng yêu cầu API Health Connect.
Hướng dẫn này trình bày các hạn chế áp dụng cho thao tác đọc và ghi API trong Health Connect, cũng như cách tránh giới hạn số lượng yêu cầu bằng cách thiết kế ứng dụng hiệu quả.
Giới hạn yêu cầu API
Giới hạn được đặt cho cả thao tác API trên nền trước và nền là hạn mức cố định đối với số lượng yêu cầu.
Giới hạn về số lượng yêu cầu và bộ nhớ có thể thay đổi phụ thuộc vào loại thao tác mà ứng dụng đang thực hiện và việc thao tác này được thực hiện ở nền trước hay nền.
Giới hạn về nhật ký thay đổi và đọc
Đối với giới hạn về nhật ký thay đổi và đọc, ứng dụng Health Connect đặt ra hai giới hạn về số lệnh gọi API dành riêng cho ứng dụng:
- Giới hạn định kỳ về số lệnh gọi API mà ứng dụng có thể gửi tới API.
- Giới hạn hằng ngày về số lệnh gọi API mà ứng dụng có thể thực hiện.
Chèn, cập nhật và xoá giới hạn
Health Connect thiết lập 4 hạn mức riêng biệt cho các thao tác chèn, cập nhật và xoá:
- Giới hạn định kỳ về số lệnh gọi mà ứng dụng có thể gửi tới API.
- Giới hạn hằng ngày về số lệnh gọi mà ứng dụng của bạn có thể gửi tới API.
- Giới hạn bộ nhớ với thao tác chèn hàng loạt.
- Giới hạn bộ nhớ cho một thao tác chèn bản ghi.
Các phương pháp hay nhất
Các ứng dụng nên tương tác với API Health Connect sao cho mức tiêu thụ pin là thấp nhất, giữ tình trạng hệ thống ở mức tối ưu và tăng cường quản lý dữ liệu một cách hiệu quả trên tất cả các thao tác CRUD.
Bạn nên tuân thủ một số nguyên tắc dành cho các phương pháp hay nhất dưới đây.
Lệnh gọi API trong nền
Mức sử dụng pin cho các thao tác trong nền làm giảm trải nghiệm người dùng và đặt ra vấn đề về quyền riêng tư đối với dữ liệu.
Do đó, giới hạn số lượng yêu cầu trong nền sẽ nghiêm ngặt hơn giới hạn số lượng yêu cầu ở nền trước. Cho nên, điều quan trọng là phải hạn chế số lượng lệnh gọi API mà ứng dụng thực hiện trong nền.
Xử lý ngoại lệ
Nếu ứng dụng của bạn gặp phải trường hợp ngoại lệ khi ghi dữ liệu vào Health Connect, thì bạn nên thử lại từ nơi ngoại lệ xảy ra.
Đừng chỉ xoá tất cả dữ liệu liên quan rồi thử lại yêu cầu ghi. Phương pháp này ảnh hưởng đến hạn mức chèn, giảm hiệu suất và có tác động tiêu cực tới thời lượng pin.
Xử lý nhật ký thay đổi
Để giảm thiểu nguy cơ ứng dụng bị giới hạn số lượng yêu cầu, bạn nên sử dụng tính năng xử lý nhật ký thay đổi để đồng bộ hoá cơ sở dữ liệu với dữ liệu từ Health Connect, thay vì chỉ dựa vào các yêu cầu đọc dữ liệu thô.