최적의 시스템 안정성과 성능을 유지하기 위해 헬스 커넥트는 Health Connect API에 대한 클라이언트 연결에 비율 제한을 적용합니다.
이 가이드에서는 헬스 커넥트에서 읽기 및 쓰기 API 작업에 적용되는 비율 제한과 효율적인 앱 설계를 통해 비율 제한을 피하는 방법을 설명합니다.
API 제한
제한은 포그라운드 및 백그라운드 API 작업 모두에 고정된 요청 비율 할당량으로 적용됩니다.
비율 및 메모리 제한은 앱이 실행하는 작업 유형에 따라 다르고 이러한 작업이 포그라운드에서 실행되는지 또는 백그라운드에서 실행되는지에 따라서도 달라집니다.
읽기 및 변경 로그 제한
읽기 및 변경 로그 제한의 경우 헬스 커넥트는 앱에서 사용할 수 있는 API 호출 수에 두 가지 제한을 적용합니다.
- 앱에서 API에 실행할 수 있는 API 호출 수에 관한 주기적 제한
- 앱에서 호출할 수 있는 API 호출 수에 관한 일일 제한
제한 삽입, 업데이트, 삭제
헬스 커넥트는 삽입, 업데이트, 삭제 작업에 4가지 제한을 적용합니다.
- 앱에서 API에 실행할 수 있는 호출 수에 관한 주기적 제한
- 앱에서 API를 호출할 수 있는 호출 수에 관한 일일 제한
- 일괄 삽입에 적용되는 메모리 제한
- 단일 레코드 삽입에 적용되는 메모리 제한
권장사항
앱은 배터리 사용량을 최소화하고 최적의 시스템 상태를 유지하면서 모든 CRUD 작업에서 효율적인 데이터 관리를 장려하는 방식으로 Health Connect API와 상호작용하는 것이 좋습니다.
다음은 준수해야 할 권장사항 가이드라인입니다.
백그라운드 API 호출
백그라운드 작업의 배터리 사용량은 사용자 경험을 줄이고 데이터 개인 정보 보호에 관한 의심을 초래합니다.
따라서 백그라운드 비율 제한은 포그라운드 비율 제한보다 더 엄격합니다. 앱이 백그라운드에서 실행하는 API 호출 양을 제한하는 것이 중요합니다.
예외 처리
헬스 커넥트에 데이터를 쓸 때 앱에서 예외가 발생하면 예외가 발생한 위치에서 다시 시도하는 것이 좋습니다.
문제의 데이터를 모두 삭제하지 말고 전체 쓰기 요청을 다시 시도하지 마세요. 이 접근 방식은 삽입 할당량을 사용하고, 성능을 저하하며, 배터리 수명에 부정적인 영향을 미칩니다.
변경 로그 처리
앱에 비율 제한이 적용될 위험을 최소화하려면 원시 읽기 요청에 너무 의존하지 말고 변경 로그 처리를 활용하여 데이터베이스를 헬스 커넥트의 데이터와 동기화해야 합니다.