Google Fit REST API を含む Google Fit API は、2025 年 6 月 30 日をもってご利用いただけなくなります。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 開発者サービスの最新のクライアントライブラリを入手する host:

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.2.0")
        implementation("com.google.android.gms:play-services-auth:21.2.0")
}

グルーヴィー DSL

apply plugin: 'com.android.application'

...

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

これにより、Gradle は実行時にフィットネス SDK を自動的にダウンロードします。アプリがビルドされます。

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

設定手順が完了したら、アプリのビルドを開始できます。特典をでは、アプリが保存および保存できるデータの種類について read のようにします。Google Cloud のデータを 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 の権限がユーザーに表示されます。ダウンロードする前に、ダウンロードされたアプリは、実行時の権限をリクエストでき、ユーザーは権限を許可または拒否できます。付与できます。
Check and connect: 権限が以下の条件を満たしているかどうかを確認します。他のデータ型へのアクセスがリクエストされる前に付与される権限。
OAuth スコープのリクエスト: Google がユーザーにアプリを許可するよう求める OAuth スコープを指定します。
アクセス権を適用しました: ユーザーが権限を付与すると、アプリは次のことができます。ユーザーが付与したスコープに属するデータ型にアクセスする指定します。

適格性確認の申請

アプリをビルドしてテストしたら、さまざまな方法によるオーナー確認必要な理由のレベルを機密スコープと制限付きスコープ。