자주 묻는 질문(FAQ)

이 페이지에는 자주 묻는 질문(FAQ)과 답변이 나와 있습니다.

Q: 헬스 커넥트는 Android 플랫폼에서만 사용할 수 있나요?

A: 예. Health Connect API와 헬스 커넥트 앱은 모두 Android 플랫폼에서만 사용할 수 있습니다.

Wear OS의 건강 센서 데이터 사용 사례는 Health Services API 문서를 참고하세요.

Q: 헬스 커넥트에 액세스하려면 어떻게 해야 하나요?

A: 헬스 커넥트에 액세스하는 방법은 기기에서 실행되는 Android 버전에 따라 다릅니다.

  • Android 14에서 헬스 커넥트는 Android 시스템의 일부입니다. 설정 > 보안 및 개인 정보 보호 > 개인 정보 보호로 이동하여 헬스 커넥트를 찾아 헬스 커넥트에 액세스할 수 있습니다.
  • 헬스 커넥트를 지원하는 Android 13과 같은 하위 버전의 Android에서는 헬스 커넥트가 공개적으로 사용 가능한 앱으로, Google Play 스토어에서 다운로드할 수 있습니다. 다음 방법 중 하나를 통해 앱에 액세스할 수 있습니다.

    • 설정 > 앱으로 이동하여 헬스 커넥트를 찾은 다음 엽니다.
    • 작업 표시줄의 빠른 설정을 사용하여 헬스 커넥트 빠른 액세스를 구성합니다.
    • 헬스 커넥트의 Google Play 스토어 페이지로 이동하여 열기를 탭합니다.

Q: 건강 데이터는 Android 13에서 Android 14로 어떻게 이전되나요?

A: Android 13용 헬스 커넥트 APK에서 Android 14용 헬스 커넥트 시스템 앱으로의 이전은 Android 14로 업그레이드하는 즉시 자동으로 시작됩니다.

이전 중에는 Android 14 API가 '이전 진행 중' 상태로 정지됩니다. 상태는 헬스 커넥트 UI에도 표시됩니다. 이전이 완료되면 독립형 헬스 커넥트 APK를 제거할 수 있습니다.

자세한 내용은 Android 13에서 Android 14로 이전 가이드를 참고하세요.

Q: 헬스 커넥트는 Google Play 서비스가 설치되어 있지 않은 Android 휴대전화를 지원하나요?

A: 아니요. 헬스 커넥트에는 휴대기기에 Android 9(API 28) 이상이 적용되고 Google Play 서비스가 설치되어야 하는 등 특정 호환성 요구사항이 있습니다.

Q: 헬스 커넥트는 Google 피트니스와 어떻게 다른가요?

A: 다음 표에서는 두 API의 주요 아키텍처 차이를 설명합니다.

헬스 커넥트 Google 피트니스
기기 중심

헬스 커넥트는 기기 중심입니다. 데이터는 특정 Google 계정과 연결되지 않고 사용자 기기에 저장됩니다.

Google 계정 중심

Google 피트니스는 계정 중심입니다. 데이터는 서버 측 인프라에 저장됩니다. 데이터 모델은 사용자의 기기가 아닌 특정 Google 계정에 전적으로 연결되어 있습니다. 따라서, 서버가 Google 피트니스의 정보 소스가 됩니다.

세분화된 권한

사용자는 헬스 커넥트를 통해 각 데이터 유형의 읽기 또는 쓰기 액세스 권한을 가진 앱을 세부적으로 제어할 수 있습니다.

헬스 커넥트는 기본 제공되는 맞춤 권한 메커니즘을 활용합니다. 이렇게 하면 헬스 커넥트에서 권한을 관리하고 할당하는 방법을 중앙 집중화하고 개선할 수 있습니다.

OAuth 기반 권한

Google 피트니스의 권한은 OAuth 인증을 기반으로 하므로 추가 작업이 필요합니다. OAuth 범위에는 더 많은 수의 데이터 유형이 포함될 수도 있습니다.

가벼운 데이터 처리

헬스 커넥트는 데이터 처리와 여기에서 파생되는 작업이 거의 없으며 기초 칼로리 및 기초 대사율(BMR)과 같은 일부 데이터 유형의 소수 예외가 있습니다. 따라서 개발자는 헬스 커넥트로 더 많은 원시 데이터에 액세스할 수 있습니다.

서비스별 데이터 처리

Google 피트니스는 더 많은 데이터를 처리하여 일부 데이터 유형을 다른 데이터 유형으로 변환하거나 병합합니다. Google 피트니스는 헬스 커넥트와 같이 원시 데이터에 액세스할 수 있는 권한을 제공하는 대신 특정 서비스의 데이터를 처리합니다.

Q: 헬스 커넥트 저장소는 기기에 있나요? 아니면 클라우드를 기반으로 하나요?

A: 헬스 커넥트는 기기 내 저장소를 제공합니다. Google의 목표는 사용자가 데이터를 공유하는 앱 및 서비스와 더불어 데이터도 완전히 제어할 수 있는 시스템을 만드는 것입니다.

Q: 헬스 커넥트 앱을 사용할 수 있는 휴대기기는 무엇인가요?

A: Android 9 (API 28) 이상이 적용된 휴대기기에서만 헬스 커넥트 앱을 사용할 수 있습니다. 이러한 기기에는 Google Play 서비스도 설치되어 있어야 합니다.

Q: Jetpack에 자바 SDK가 있나요? 최종적으로 추가될 예정인가요?

A: 헬스 커넥트 SDK는 Kotlin으로만 사용할 수 있습니다. 현재 Jetpack 라이브러리에 Java SDK를 추가할 계획은 없습니다. 그러나 개발자 의견에 따라 최종적으로 두 프로그래밍 언어를 모두 지원할 수도 있습니다.

Q: 헬스 커넥트에서 읽거나 쓸 수 있는 과거 데이터의 범위는 무엇인가요?

A: 헬스 커넥트를 사용하면 앱의 첫 번째 성공적인 권한 요청 전 최대 30일 동안 앱이 time 또는 startTime를 사용하여 기록을 읽을 수 있습니다. 앱을 제거했다가 다시 설치하면 날짜가 재설정되어 처음 앱을 사용하는 것처럼 새 시작일로 표시됩니다.

헬스 커넥트와 공유하는 데이터에는 제한이 없지만 지금은 많은 양의 이전 데이터를 쓰지 마세요. 마찬가지로 예측된 MenstruationPeriodRecord와 같은 향후 이벤트와 관련된 데이터는 쓰지 않는 것이 좋습니다.

Q: 헬스 커넥트 통합과 관련하여 도움이 필요한 경우 어디에 문의해야 하나요?

A: 헬스 커넥트 통합에 관한 기술적인 질문이나 문제 또는 우려사항이 있으면 health-connect-support@google.com으로 문의하세요.

Google 지원 담당자는 개발자의 질문에 최대한 빠르고 종합적으로 답변해 드리기 위해 노력하고 있습니다. 그동안 도움이 필요하면 헬스 커넥트 문서를 참고하세요.

Q: 데이터 유형 읽기 또는 쓰기 액세스 권한을 요청하려면 어떻게 해야 하나요?

A: 앱에 헬스 커넥트 데이터 유형의 읽기 또는 쓰기 액세스 권한을 부여하려면 개발자 선언 양식을 작성하여 요청합니다. 자세한 내용은 헬스 커넥트 데이터 유형에 관한 액세스 요청을 참고하세요.