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