Android の使用を開始する

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

注: Google Fit は Google Play 開発者サービスの一部です。Google Play 開発者サービスを使用することでアプリが得られるメリットをご覧ください。

セットアップ

アプリの作成を始める前に、以下のセクションの手順を完了します。

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 開発者サービス クライアント ライブラリを依存関係として追加します。

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:22.0.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:22.0.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 クライアントを構築する方法の例をご覧ください。

結果として得られるユーザー認可フロー

以下に、権限を求められたときにユーザーが体験する認可フローを示します。

図 1. ユーザーの認可フロー。

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

適格性確認の申請

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