Android の使用を開始する

Google アカウントを取得する

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

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

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

1. Android SDK Manager を開きます。
2. [SDK Tools] で [Google Play 開発者サービス] を探します。
3. これらのパッケージのステータスが [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 開発者サービス クライアント ライブラリを依存関係として追加します。

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

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

これにより、アプリのビルド時に Gradle が Fitness SDK を自動的にダウンロードするようになります。

必要な Android 権限を取得する

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

OAuth 権限を取得する

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

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

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

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

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

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

権限を求められたときにユーザーに表示される認可フローの結果を以下に示します。

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