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이 포함된 기록을 앱에서 읽을 수 있습니다. 앱에서 30일 후에 레코드를 읽도록 하려면 PERMISSION_READ_HEALTH_DATA_HISTORY 권한을 사용하세요. 앱을 제거한 후 다시 설치하면 날짜가 재설정되어 처음 사용하는 것처럼 새 시작일로 표시됩니다.
헬스 커넥트와 공유하는 데이터에는 제한이 없지만 지금은 많은 양의 과거 데이터를 쓰지 않는 것이 좋습니다. 마찬가지로, 예측된 MenstruationPeriodRecord와 같은 향후 이벤트와 관련된 데이터를 작성하지 마세요.
Q: 헬스 커넥트 통합과 관련하여 도움이 필요한 경우 어디에 문의해야 하나요?
A: 헬스 커넥트 통합에 관한 기술적인 질문이나 문제 또는 우려사항이 있으면 헬스 커넥트 개발자 지원팀에 티켓을 제출하세요.
Google 지원 담당자는 개발자의 질문에 최대한 빠르고 종합적으로 답변해 드리기 위해 노력하고 있습니다. 그동안 도움이 필요하면 헬스 커넥트 문서를 참고하세요.
Q: 데이터 유형 읽기 또는 쓰기 액세스 권한을 선언하려면 어떻게 해야 하나요?
A: 앱이 헬스 커넥트 데이터 유형에 대한 읽기 또는 쓰기 액세스 권한을 갖게 하려면 Play Console을 사용하여 앱이 이러한 유형에 액세스한다고 선언하세요.
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2025-07-27(UTC)
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-07-27(UTC)"],[],[],null,["# Frequently asked questions\n\nThis page lists some of the frequently asked questions and their answers.\n\nQ: Is Health Connect only available on the Android platform?\n------------------------------------------------------------\n\n**A:** Yes. Both the Health Connect API and the Health Connect app are available\non the Android platform only.\n\nFor health sensor data use cases on Wear OS, refer to the\n[Health Services API documentation](/training/wearables/health-services).\n\nQ: How do I access Health Connect?\n----------------------------------\n\n**A:** The method of accessing Health Connect depends on the version of Android\nthat runs on your device:\n\n- On Android 14, Health Connect is part of the Android system. You can access Health Connect by going to **Settings \\\u003e Security \\& Privacy \\\u003e Privacy** , and look for **Health Connect**.\n- On lower versions of Android that support Health Connect, including\n Android 13, Health Connect is a publicly available app that you can\n [download](https://play.google.com/store/apps/details?id=com.google.android.apps.healthdata) from the Google Play Store. You can access the\n app through one of the following ways:\n\n - Go to **Settings \\\u003e Apps**, look for Health Connect, and open it.\n - [Configure the quick access](https://support.google.com/android/answer/9083864) to Health Connect using Quick Settings, which can be found in the system tray.\n - Go to the Google Play Store page of Health Connect and tap **Open**.\n\n| **Note:** Regardless of the version of Android that runs on your device, you can't access Health Connect as an app from the home screen because its intended design is to be a system app accessible through **Settings**.\n\nQ: How is health data migrated from Android 13 to Android 14?\n-------------------------------------------------------------\n\n**A:** The migration from the Health Connect APK for Android 13 to the Health\nConnect system app for Android 14 starts automatically as soon as you upgrade to\nAndroid 14.\n\nDuring the migration, the Android 14 APIs are suspended with a \"Migration in\nProcess\" status. The status is also visible in the Health Connect UI. Once the\nmigration is complete, you can uninstall the standalone Health Connect APK.\n\nCheck the [Android 13 to Android 14 migration guide](/health-and-fitness/guides/health-connect/migrate/migrate-from-android-13-to-14) for more details.\n\nQ: Does Health Connect support Android phones without Google Play services installed?\n-------------------------------------------------------------------------------------\n\n**A:** No. Health Connect has certain compatibility requirements including that\nmobile devices have Android 9 (API 28) or higher **with** Google Play\nservices installed.\n\nQ: How does Health Connect compare with Google Fit?\n---------------------------------------------------\n\n**A:** The following table describes key architectural differences between the\ntwo APIs:\n\n\n\u003cbr /\u003e\n\n\n\u003cbr /\u003e\n\n\n\u003cbr /\u003e\n\n\n\u003cbr /\u003e\n\n\n| ***Health Connect*** | ***Google Fit*** |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Device-centric** Health Connect is device-centric. Data is stored on the user's device instead of being associated with a specific Google Account. | **Google Account-centric** Google Fit is account-centric. Data is stored on a server-side infrastructure. Its data model is entirely tied to specific Google Accounts as opposed to the user's devices. This makes the server the source of truth in Google Fit. |\n| **Fine-grained permissions** Users have granular control over which apps have read or write access to each data type through Health Connect. Health Connect benefits from a built-in, custom permissions mechanism. This allows Health Connect to centralize and refine the way permissions are managed and allocated. | **OAuth-based permissions** Permissions in Google Fit require additional work as these are based on OAuth authentication. OAuth scopes may also cover a larger number of data types. |\n| **Minor data processing** Health Connect involves very little data processing and derivation, with some minor exceptions for data types like Basal Calories and Basal Metabolic Rate (BMR). Therefore, developers will have access to more raw data with Health Connect. | **Service-specific data processing** Google Fit processes more data, turning some data types into others or merging them. Google Fit processes data for a specific service, rather than providing access to raw data as Health Connect does. |\n\n\u003cbr /\u003e\n\nQ: Is the Health Connect storage on-device or cloud based?\n----------------------------------------------------------\n\n**A:** Health Connect provides on-device storage. Our goal is to create a system\nthat puts users fully in control of their data, as well as which apps and\nservices they share it with.\n\nQ: Which mobile devices are able to use the Health Connect app?\n---------------------------------------------------------------\n\n**A:** Only mobile devices with Android 9 (API 28) or higher can use the Health\nConnect app. These devices must also have Google Play services installed.\n\nQ: Does a Java SDK exist on Jetpack? Will this be added eventually?\n-------------------------------------------------------------------\n\n**A:** The Health Connect SDK is only available in Kotlin. We don't have\nimmediate plans to add a Java SDK to the Jetpack library. However, we may\neventually support both programming languages depending on developer feedback.\n\nQ: What is the range of historical data Health Connect can read or write?\n-------------------------------------------------------------------------\n\n**A:** Health Connect allows your app to read records with\n`time` or `startTime` for up to 30 days before your app's\n[first successful permission request](/health-and-fitness/guides/health-connect/develop/read-data#read-restriction). If you would like your app to\nread records after 30 days, use the `PERMISSION_READ_HEALTH_DATA_HISTORY`\npermission. If your app is uninstalled and then re-installed, the date is reset\nwhich marks as your new starting date as if you use the app for the first time.\n\nThere are no restrictions on the data you share with Health Connect, however\navoid writing large amounts of historical data at this time. Similarly, avoid\nwriting data associated with future events such as a predicted\n[`MenstruationPeriodRecord`](/reference/kotlin/androidx/health/connect/client/records/MenstruationPeriodRecord).\n\nQ: Who should I contact if I need help integrating with Health Connect?\n-----------------------------------------------------------------------\n\n**A:** If you have any technical questions, issues, or concerns about Health\nConnect integration, submit a ticket to [Health Connect Developer\nSupport](https://issuetracker.google.com/issues/new?component=1676744&template=2072671).\n\nOur support specialists work hard to respond to developer questions as\nquickly and comprehensively as possible. In the meantime, consult the\n[Health Connect documentation](/guide/health-and-fitness/health-connect) for any guidance you may need.\n\nQ: How do I declare access to read or write data types?\n-------------------------------------------------------\n\n**A:** For your app to have read or write access to Health Connect data types,\nuse the Play Console to\n[declare that your app accesses these types](/health-and-fitness/guides/health-connect/publish/declare-access).\n| **Note:** If you are updating your declaration in the case where your app requires new data types, you need to include both new and existing data types, and exclude any data types you no longer need. If you only need to remove access to certain data types, include all of your existing data types but exclude the data types you no longer need."]]
