Google Fit REST API を含む Google Fit 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 Fit を使用して開発を開始する方法について説明します。

設定

アプリのビルドを開始する前に、次のセクションの手順を完了してください。

Google アカウントを取得する

Google Fit API を使用するには、Google アカウントが必要です。新しいアカウントを作成することも、既存のアカウントを使用することもできます。ユーザーの視点からアプリをテストするために、別のアカウントを作成することをおすすめします。

Google Play 開発者サービスを入手する

開発ホストで Google Play 開発者サービスの最新のクライアントライブラリを取得します。

Android SDK Manager を開きます。
[SDK Tools] で [Google Play 開発者サービス] を探します。
これらのパッケージのステータスが [Installed] でない場合は、両方を選択して [ Install Packages] をクリックします。

OAuth 2.0 クライアント ID を取得する

Fitness API を有効にするには、OAuth 2.0 クライアント ID を取得します。

プロジェクトを作成して構成する

Fitness API を使用してアプリをビルドするには、Android Studio 開発環境を使用することをおすすめします。Android Studio で新しいプロジェクトを作成して構成する方法について詳しくは、プロジェクトの作成をご覧ください。

Google Play 開発者サービスクライアントライブラリを追加する

Android Studio で、モジュールの 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 が Fitness SDK を自動的にダウンロードするようになります。

アプリをビルドしてテストする

設定手順が完了したら、アプリのビルドを開始できます。まず、アプリで保存および読み取りできるデータの種類についてご確認ください。Google Fit でのデータの操作について詳しくは、こちらをご覧ください。

必要な Android 権限を取得する

一部の種類のデータを読み書きするには、アプリで Android 権限をリクエストする必要があります。

OAuth 権限を取得する

アプリがアクセス権を持つデータ型は、承認スコープに対応しています。これらの権限をリクエストするには、アプリがアクセスする必要があるデータ型を FitnessOptions インスタンスに追加する必要があります。アプリが Google Fit のデータ型のいずれかを使用しようとすると、Android SDK はそれらが属するスコープを自動的に確認し、それらのスコープに対する承認をユーザーに求めます。

API クライアントを作成する

API クライアントを作成し、データの書き込みまたは読み取りのためにアプリがアクセスする必要があるデータ型を追加します。次のエンドポイントを使用できます。

SensorsClient: ローカルデバイスとコンパニオンデバイスのハードウェアセンサーから、さまざまな健康とウェルネスに関するデータソースにアクセスします。
RecordingClient: センサーデータの低電力、常時稼働のバックグラウンド収集用。
HistoryClient: Google Fit の履歴データの挿入、削除、読み取り。
SessionsClient: ユーザーアクティビティのセッションの作成と管理。
GoalsClient: Google Fit でユーザーが作成したハートポイントと歩数の目標を読み取る。
ConfigClient: Google Fit プラットフォームのカスタムデータ型と設定にアクセスします。

Fitness API クライアントをビルドする方法の例をご覧ください。

ユーザーの承認フローの結果

権限をリクエストされたときにユーザーに表示される承認フローの結果は次のとおりです。

Android 権限: ユーザーは、アプリをダウンロードする前に、アプリがリクエストした Android 権限を確認できます。アプリがダウンロードされると、必要な実行時の権限がリクエストされ、ユーザーはこれらの権限を許可または拒否します。
確認して接続: アプリは、他のデータ型へのアクセスをリクエストする前に、権限が付与されているかどうかを確認します。
OAuth スコープのリクエスト: Google は、アクセスするデータ型に必要な OAuth スコープをアプリに付与するようユーザーに促します。
アクセスが適用される: ユーザーが権限を付与すると、アプリは、ユーザーが権限を付与したスコープに属するデータ型にアクセスできます。

検証を申請する

アプリをビルドしてテストしたら、検証を申請する必要があります。機密性の高いスコープと制限付きスコープでは、さまざまなレベルの正当性が求められます。