Google 피트니스 REST API를 비롯한 Google 피트니스 API는 2026년에 지원 중단될 예정입니다. 2024년 5월 1일부터 개발자는 이러한 API를 사용하도록 가입할 수 없습니다.

이전할 API 또는 플랫폼에 관한 안내는 헬스 커넥트 이전 가이드를 참고하세요. 헬스 커넥트와 Google Fit API 및 Fitbit Web API를 비교하려면 헬스 커넥트 비교 가이드를 참고하세요.

헬스 커넥트 및 API와 통합하는 방법을 자세히 알아보세요.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Android에서 시작하기

이 가이드에서는 Android에서 Google 피트니스로 개발을 시작하는 방법을 설명합니다.

설정

앱 빌드를 시작하기 전에 다음 섹션의 단계를 완료하세요.

Google 계정 만들기

Google 피트니스 API를 사용하려면 Google 계정이 필요합니다. 새 계정을 만들거나 기존 계정을 사용할 수 있습니다. 사용자 관점에서 앱을 테스트하기 위해 별도의 계정을 만드는 것이 좋습니다.

Google Play 서비스 설치

개발 호스트에서 Google Play 서비스의 최신 클라이언트 라이브러리를 가져옵니다.

Android SDK Manager를 엽니다.
SDK 도구에서 Google Play 서비스를 찾습니다.
이러한 패키지의 상태가 설치됨이 아니면 둘 다 선택하고 **패키지 설치**를 클릭합니다.

OAuth 2.0 클라이언트 ID 가져오기

피트니스 API를 사용 설정하려면 OAuth 2.0 클라이언트 ID를 가져옵니다.

프로젝트 생성 및 구성

피트니스 API로 앱을 빌드하려면 Android 스튜디오 개발 환경을 사용하는 것이 좋습니다. Android 스튜디오에서 새 프로젝트를 만들고 구성하는 방법에 관한 자세한 내용은 프로젝트 만들기를 참고하세요.

Google Play 서비스 클라이언트 라이브러리 추가

Android 스튜디오에서 모듈의 build.gradle 파일을 열고 Google Play 서비스 클라이언트 라이브러리를 종속 항목으로 추가합니다.

Kotlin DSL

plugin {
    id("com.android.application")
}

...

dependencies {
        implementation("com.google.android.gms:play-services-fitness:21.3.0")
        implementation("com.google.android.gms:play-services-auth:21.5.1")
}

Groovy DSL

apply plugin: 'com.android.application'

...

dependencies {
    implementation 'com.google.android.gms:play-services-fitness:21.3.0'
    implementation 'com.google.android.gms:play-services-auth:21.5.1'
}

이렇게 하면 Gradle이 앱을 빌드할 때 피트니스 SDK를 자동으로 다운로드합니다.

앱 빌드 및 테스트

설정 단계를 완료한 후 앱 빌드를 시작할 수 있습니다. 시작하려면 앱에서 저장하고 읽을 수 있는 데이터 유형을 알아보세요. Google 피트니스에서 데이터 작업에 관해 자세히 알아보세요.

필요한 Android 권한 가져오기

일부 데이터 유형을 읽고 쓰려면 앱에서 Android 권한을 요청해야 합니다.

OAuth 권한 가져오기

앱에서 액세스할 수 있는 데이터 유형은 승인 범위에 해당합니다. 이러한 권한을 요청하려면 앱에서 액세스해야 하는 데이터 유형을 FitnessOptions 인스턴스에 추가 해야 합니다. 앱에서 Google 피트니스 데이터 유형을 사용하도록 요청하면 Android SDK는 자동으로 속한 범위를 확인하고 사용자에게 이러한 범위에 대한 승인을 요청합니다.

API 클라이언트 만들기

API 클라이언트를 만들고 앱에서 데이터 쓰기 또는 읽기를 위해 액세스해야 하는 데이터 유형을 추가합니다. 다음 엔드포인트를 사용할 수 있습니다.

SensorsClient: 로컬 기기 및 컴패니언 기기의 하드웨어 센서에서 다양한 건강 및 웰니스 데이터 소스에 액세스합니다.
RecordingClient: 저전력, 항상 켜져 있는 백그라운드 센서 데이터 수집을 위한 것입니다.
HistoryClient: Google 피트니스에서 이전 데이터를 삽입, 삭제, 읽습니다.
SessionsClient: 사용자 활동 세션을 만들고 관리합니다.
GoalsClient: Google 피트니스에서 사용자가 만든 심장 강화 점수 및 걸음수 목표를 읽습니다.
ConfigClient: Google 피트니스 플랫폼에서 맞춤 데이터 유형 및 설정에 액세스합니다.

피트니스 API 클라이언트를 빌드하는 방법의 예를 참고하세요.

결과 사용자 승인 흐름

다음은 사용자에게 권한을 요청할 때 발생하는 결과 승인 흐름을 보여줍니다.

Android 권한: 사용자는 앱을 다운로드하기 전에 앱에서 요청한 Android 권한을 확인합니다. 앱이 다운로드되면 필요한 런타임 권한을 요청하고 사용자는 이러한 권한을 부여하거나 거부합니다.
확인 및 연결: 앱은 다른 데이터 유형에 대한 액세스를 요청하기 전에 권한이 부여되었는지 확인합니다.
OAuth 범위 요청: Google은 사용자에게 앱에 필요한 OAuth 범위를 부여하라는 메시지를 표시합니다. 액세스하려는 데이터 유형에 필요한 OAuth 범위를 앱에 부여하라는 메시지를 표시합니다.
액세스 적용됨: 사용자가 권한을 부여하면 앱은 사용자가 권한을 부여한 범위에 속하는 데이터 유형에 액세스할 수 있습니다.

인증 신청

앱을 빌드하고 테스트한 후에는 민감하고 제한된 범위에 필요한 다양한 수준의 정당성을 사용하여 인증을 신청해야 합니다.