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