Google Fit REST API を含む Google Fit API は、2026 年に非推奨になります。2024 年 5 月 1 日より、デベロッパーはこれらの API の使用を登録できなくなります。

移行先の API またはプラットフォームの手順については、ヘルスコネクトの移行ガイドをご覧ください。ヘルスコネクトと Google Fit API および Fitbit Web API の比較については、ヘルスコネクトの比較ガイドをご覧ください。

ヘルスコネクトの詳細と API との統合方法をご覧ください。

このページは Cloud Translation API によって翻訳されました。

Android で使ってみる

このガイドでは、Android で Google Fit を使用して開発を開始する方法について説明します。

セットアップ

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

Google アカウントを取得する

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

Google Play 開発者サービスの入手

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

Android SDK Manager を開きます。
[SDK Tools] で [Google Play services] を見つけます。
これらのパッケージのステータスが [インストール済み] でない場合は、両方を選択して [パッケージをインストール] をクリックします。

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.4.0")
}

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.4.0'
}

これにより、Gradle がアプリをビルドするときに、フィットネス 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 スコープをアプリに付与するようユーザーに促します。
アクセスが適用される: ユーザーが権限を付与すると、アプリはユーザーが権限を付与したスコープに属するデータ型にアクセスできます。

適格性確認を申請する

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