Google 피트니스 API는 2026년 말까지 지원됩니다. Google에서는 사용자가 지원 중단 후에도 목표를 계속 달성할 수 있도록 다양한 건강 및 웰빙 제품과 서비스를 제공합니다.
주의: Google 피트니스 API (REST API 포함)는 2026년 말까지만 지원됩니다. 클라우드 기반 통합에는 Google Health API로, 걸음 수 추적 및 모바일 우선 앱에는 헬스 커넥트로 이전하는 것이 좋습니다.
다음 가이드라인은 Google 피트니스 API 사용 방식에 따라 어느 서비스로 이전해야 하는지 보여줍니다.
권장되는 이전 경로
API 선택은 애플리케이션 유형과 구체적인 데이터 요구사항에 따라 달라집니다.
애플리케이션 유형별
| 애플리케이션 유형 | 권장 경로 | 기본 이유 |
|---|---|---|
| 걸음 수 모니터링 앱 | 헬스 커넥트 | 다양한 소스에서 집계된 걸음 수 데이터를 모바일 중심으로 읽습니다. |
| 피트니스 트래커 호환 앱 | Google Health API | 사용자 통합을 위해 OAuth가 필요한 웹 중심 플랫폼 |
| 건강 및 피트니스 플랫폼 | Google Health API 및 헬스 커넥트 | Fitbit/Google 기기 데이터에는 Google Health API를 사용하고 기기 집계 데이터에는 헬스 커넥트를 사용합니다. |
현재 통합
| 현재 통합 | 권장 경로 | 가용성 |
|---|---|---|
| Fit History API 및 Fit Session API | Google Health API | 사용 가능 |
| 모바일 걸음 수 읽기 (Google 피트니스 Recording API 사용) | 헬스 커넥트 | 사용 가능 |
| Wear OS의 Fit API | 건강 관리 서비스 | 사용 가능 |
| Fitbit Web API | Google Health API | 사용 가능 |
| 헬스 커넥트 | 기존 통합 유지 또는 Google Health API 추가 | 사용 가능 |
기술 비교
다음 섹션에서는 올바른 이전 경로를 선택할 수 있도록 Google 피트니스 API, Google Health API, 헬스 커넥트를 기술적으로 비교합니다.
Fit API와 Google Health API 비교
앱이 웹 기반 플랫폼이거나 서버 간(S2S) 상호작용이 필요한 경우 이 경로를 사용하세요.
| 기능 | Fit API (Android/REST) | Google Health API |
|---|---|---|
| 프로젝트 설정 | Google Cloud Console | Google Cloud 프로젝트 만들기 |
| OAuth 구성 | Android 또는 웹 애플리케이션 유형 | 웹 애플리케이션 유형 |
| 선임 D&T 관리자 | com.google 접두사가 붙은 유형 |
통합 Google Health API 데이터 유형 |
| 앱 등록 | Google Cloud 프로젝트 생성 | Google Cloud 프로젝트를 만들고 Google Health API 사용 설정하기 |
Fit API와 헬스 커넥트 비교
로컬 기기 측정항목을 읽는 모바일 우선 Android 애플리케이션에 이 경로를 사용하세요.
| 기능 | Android용 Fit API | 헬스 커넥트 |
|---|---|---|
| 등록 | Google Cloud Console | Play 스토어 프로젝트 및 건강 앱 선언 |
| 인증 | OAuth 2.0 필요 | OAuth 필요 없음 (온디바이스 권한) |
| 데이터 스토리지 | 클라우드 중심 | 기기 중심 (온디바이스) |
| 잠재고객 | 기존 Android 개발자 | Modern Android 모바일 개발자 |
| 권한 | OAuth 범위 | Android 매니페스트 권한 |
Fit API 통합
다음 섹션에서는 각 Google 피트니스 API에서 이전하는 방법을 안내합니다. 통합에 Google 피트니스 앱에 연결되는 UI 요소도 포함된 경우 피트니스 앱 통합 가이드라인에서 추가 안내를 확인하세요.
Fit Recording API를 사용하여 걸음 수를 기록하는 앱
Fit Recording API를 사용하면 앱에서 구독을 만들어 배터리 효율적인 방식으로 센서 데이터를 자동으로 저장하도록 요청할 수 있습니다.
각 구독은 Android 앱을 특정 피트니스 데이터 유형 또는 데이터 소스에 연결하며 Step 데이터 유형은 일반적으로 걸음 수를 기록하는 데 사용됩니다.
피트니스 녹음 API에서 이전하려면 다음 단계를 따르세요.
| 휴대전화 | Wear |
|
건강 관리 서비스 사용:
두 API의 차이점에 관한 자세한 내용은 건강 관리 서비스 문서를 참고하세요. |
History API를 사용하여 피트니스 저장소에서 데이터를 읽거나 쓰는 앱
History API를 사용하면 앱이 피트니스 스토어에서 일괄 작업을 실행할 수 있습니다. 이러한 작업에는 이전의 건강 및 웰니스 데이터를 읽고 삽입하고 업데이트하고 삭제하는 작업이 포함됩니다.
History API에서 이전하려면 다음 단계를 따르세요.
| 휴대전화 | Wear |
|
적용할 수 없습니다. 웨어러블 기기가 아닌 모바일 앱에서 헬스 커넥트를 사용합니다. |
Sensor API를 사용하여 실시간 피트니스 데이터를 표시하는 앱
Sensor API를 사용하면 앱에서 실시간으로 원시 센서 데이터를 읽을 수 있습니다. Sensor API는 다음 작업을 실행합니다.
- 기기 및 호환 기기에서 사용할 수 있는 데이터 소스를 나열합니다.
- 원시 센서 데이터를 수신하도록 리스너를 등록합니다.
- 더 이상 원시 센서 데이터를 수신하지 않도록 리스너 등록을 취소합니다.
Sensor API에서 이전하려면 다음 단계를 따르세요.
| 휴대전화 | Wear |
|
센서, 통합 위치 정보 제공자 API 사용 |
Wear OS에서 건강 관리 서비스 사용:
|
세션 API를 사용하여 활동 요약을 제공하는 앱
세션은 사용자가 피트니스 활동을 하는 동안의 시간 인터벌을 나타냅니다.
Session API를 사용하면 앱에서 피트니스 저장소에 세션을 만들 수 있습니다.
Session API에서 이전하려면 다음 단계를 따르세요.
| 휴대전화 | Wear |
|
시작/중지: 관련 없음. 애플리케이션은 내부적으로 진행 중인 세션의 상태를 추적해야 합니다. 읽기/쓰기: Google Health API로 전환 |
시작/중지: 건강 관리 서비스(ExerciseClient) 사용 읽기/쓰기: 모바일 앱으로 헬스 커넥트를 사용합니다. 특정 워크플로의 경우 다음을 권장합니다.
|
Goals API를 사용하는 앱
목표는 사용자가 걸음 수, 심장 강화 점수와 같은 측정항목에 대해 설정할 수 있는 Google 피트니스 앱의 타겟입니다. 피트니스 플랫폼은 Goals API를 사용하여 목표를 기록하고 목표와 관련된 일별 활동을 추적합니다.
| 휴대전화 | Wear |
| 사용할 수 있는 대체 API가 없습니다. | 사용할 수 있는 대체 API가 없습니다. |
BLE API를 사용하는 앱
앱에서 BLE API를 사용하여 사용 가능한 저전력 블루투스 (BLE) 기기를 찾아 Google 피트니스 플랫폼에 센서 데이터를 삽입할 수 있습니다.
BLE API에서 이전하려면 다음 단계를 따르세요.
| 휴대전화 | Wear |
| Android Bluetooth API를 직접 사용합니다. | Android Bluetooth API를 직접 사용합니다. |
지원 중단된 기능
다음 기능에는 직접적인 API 대체가 없습니다. 권장되는 Android 표준 API를 사용합니다.
- 센서 API: Android 센서 프레임워크 또는 통합 위치 정보 공급자 API를 사용하여 실시간 원시 데이터를 가져옵니다.
- Goals API: 사용할 수 있는 대체 API가 없습니다. 애플리케이션 로직 내에서 목표 추적 및 일일 활동 목표를 관리합니다.
- 저전력 블루투스 (BLE) API: Android 블루투스 API를 직접 사용하여 하드웨어와 통신합니다.
피트니스 앱 통합
앱이 데이터 공유를 위해 Google 피트니스에 연결되는 경우 다음 섹션의 기존 사용자 및 신규 사용자를 헬스 커넥트 또는 Google Health API로 이전하는 안내를 따르세요.
앱의 기존 사용자
앱 UI에 사용자가 Google 피트니스에 연결할 수 있는 방법이 포함되어 있거나 앱이 Google 피트니스와 호환되는 앱 목록에 포함되어 있는 경우 현재 사용자를 위해 피트니스 앱 통합을 계속 유지할 수 있습니다.
Fit 앱 통합을 지원 중단해야 하는 시점과 사용자 환경을 유지하기 위한 최적의 옵션에 관한 정보로 이 섹션을 계속 업데이트할 예정입니다. 그동안 Google에 문의해 주세요.
| 확인이렇게 하세요 | 닫기이렇게 하지 마세요 |
| 앱에서 헬스 커넥트 또는 Google Health API를 새 옵션으로 제공합니다.
풍부한 데이터와 통계, 개인 정보 보호, 보안과 같은 사용자 혜택에 집중하세요.
|
사용자에게 Google 피트니스 연결을 해제하도록 요청합니다.
|
앱의 신규 사용자
앱의 신규 사용자에게 유사한 환경을 제공하려면 헬스 커넥트 또는 Google Health API와 통합하는 것이 좋습니다.
헬스 커넥트는 새로운 데이터 소스와 유형에 대한 액세스를 제공하여 사용자에게 더 풍부한 환경을 제공하며, 데이터는 기기에 안전하게 저장됩니다. Google Health API는 Fitbit 및 Google 기기 데이터를 위한 웹 중심 플랫폼을 제공합니다.
| 확인이렇게 하세요 | 닫기이렇게 하지 마세요 |
| 앱의 설정 흐름에 헬스 커넥트 또는 Google Health API를 포함합니다. | 헬스 커넥트가 제공되면 사용자가 연결할 수 있는 앱으로 피트를 제공합니다. |