データ型

Google Fit は、com.google 名前空間で健康とウェルネスに関する一連のデータタイプを提供します。

データ型は、データポイント内の値の形式を定義します。データポイントは以下を表すことができます。

  • 瞬間的な読み取りまたは観察
  • 一定期間の統計情報の集計

Google Fit では、瞬間観測用のデータタイプと集計用のデータタイプを定義 分析できますデータポイントは、データ型のフィールドの値とタイムスタンプ情報で構成されます。 瞬間的な観測値を表すポイントには、タイムスタンプと、 集計データ型には間隔の開始時間も含まれます。

Google Fit では、新しいデータタイプを定義することもできます。

データ型グループ

Google Fit のデータタイプは次のとおりです。

一般公開データの種類
プラットフォームが提供する標準のデータタイプには、「com.google」使用します。（例: com.google.step_count.delta）。これらのデータタイプは、 健康とウェルネスに関するデータ（フィットネス アクティビティ、睡眠、栄養など）制限なし これらのデータ型に対する読み取りと書き込みに必要な権限をアプリがリクエストできます。 ただし、この API リクエスト元のアプリのみが読み取ることができる、 記述しました。

詳しくは以下をご覧ください。

健康に関するデータの種類
プラットフォームが提供するデータの種類で、 機密データを検出できます。詳しくは、健康に関するデータをご覧ください。 タイプをご覧ください。
データ型を集計する
時間単位または期間単位で集計した健康とウェルネスに関する情報を読み取るデータの種類 選択します。詳しくは、データを集計する タイプをご覧ください。
非公開のカスタムデータ型
特定のアプリで定義されたカスタムデータ型。定義するアプリのみが データ型は、この型のデータを読み書きできます。詳細については、次をご覧ください: カスタムデータ型。

データ型の使用

Android

Android では、データ型は DataType クラスです。データ型で Fitness API を呼び出す方法は、何を達成したいかによって異なります。

  • データを記録するには、Recording API を使用して以下を行います。 記録するデータ型ごとにサブスクリプションを作成します。
  • データを読み取るには、History API を使用して読み取りを送信します。 データ型ごとに 1 つのリクエストを作成します。
  • 過去の履歴データを挿入するには、History API を使用して次の操作を行います。 各データ型の挿入リクエストを送信できます。
  • セッションを作成するには、Sessions API を使用して挿入または録画を行います。 メタデータのセットです

リアルタイム分析のデータポイントを作成するには、 DataType 正しい形式で値を割り当てます。次の例は、 文字列として食品を割り当てたり、食事の種類を Field クラス、 マッピングされた浮動小数点値で表します。

val nutritionSource = DataSource.Builder()
    .setDataType(DataType.TYPE_NUTRITION)
    ...
    .build()

val nutrients = mapOf(
    Field.NUTRIENT_TOTAL_FAT to 0.4f,
    Field.NUTRIENT_SODIUM to 1f,
    Field.NUTRIENT_POTASSIUM to 422f
)
val banana = DataPoint.builder(nutritionSource)
    .setTimestamp(now, TimeUnit.MILLISECONDS)
    .setField(Field.FIELD_FOOD_ITEM, "banana")
    .setField(Field.FIELD_MEAL_TYPE, Field.MEAL_TYPE_SNACK)
    .setField(Field.FIELD_NUTRIENTS, nutrients)
    .build()

アプリでデータポイントを設定すると、挿入、読み取り、削除が可能 History API を使用します。

REST

dataSources リソースには、次のデータ型が含まれます。 （およびそのフィールドのリスト）を作成します。これらのデータ型のいずれかを データソースを作成し、そのデータ型の名前とそのフィールドのリストを取得できます。 フィットネス ストアからデータソースを取得すると、

たとえば、データソース表現では、次のようにデータ型を指定します。

{
"dataStreamId": "exampleDataSourceId",
...
"dataType": {
  "name": "com.google.step_count.delta"
},
...
}

認可スコープ

認可スコープは、ユーザーがアプリに許可できるデータ型のグループに対応しています。 できます。アプリがアクセスする必要のあるデータの種類をユーザーが把握するのに役立ちます。 また、権限を指定することで、それらのデータの使用をアプリに許可することも 承認する必要がありますユーザーは権限を許可した後、 ダウンロードします。

<ph type="x-smartling-placeholder">
</ph> OAuth スコープ同意画面の例
図 2. OAuth スコープ同意画面

少数のユーザーでアプリをテストした後、 以下に基づいて確認をリクエストする必要があります。 スコープを指定しますリンクされているデータの種類のページを読む 各データ型に適用されるスコープを理解しておいてください。

たとえば、アプリで血圧の読み取りと書き込みを行う必要がある場合、 読み取りと書き込みの両方を宣言し、両方のスコープをリクエストする必要があります。もし Google Fit プラットフォームに血圧データを書き込むだけで、 書き込みスコープをリクエストします。

データの種類は責任を持って選択してください。アプリが対応できるようにすべてのデータ型をリクエストしない 必要になることがあります。指定されたタイプによって、ユーザーにプロンプトが表示されるスコープが決まります 許可するかどうかを選択できますユーザーがアクセスしやすくなるよう、アプリで必要なデータの種類のみを要求します。 アクセス権を付与する可能性が高くなります。ユーザーは、制限付きで明確にリソースへのアクセス権を 記述されたスコープです。

この表を使用して、アプリがアクセスする必要があるスコープが機密性の高いスコープか、 によって、 の手順に沿って進めてください）。

範囲 説明 カテゴリ
https://www.googleapis.com/auth/fitness.activity.read Google Fit プラットフォームからアクティビティ データを読み取ります。 制限付き
https://www.googleapis.com/auth/fitness.activity.write アクティビティ データを Google Fit プラットフォームに書き込む 制限付き
https://www.googleapis.com/auth/fitness.blood_glucose.read Google Fit プラットフォームから血糖値データを読み取る。 制限付き
https://www.googleapis.com/auth/fitness.blood_glucose.write Google Fit プラットフォームに血糖値データを書き込む。 制限付き
https://www.googleapis.com/auth/fitness.blood_pressure.read Google Fit プラットフォームから血圧データを読み取る。 制限付き
https://www.googleapis.com/auth/fitness.blood_pressure.write 血圧データを Google Fit プラットフォームに書き込みます。 制限付き
https://www.googleapis.com/auth/fitness.body.read Google Fit プラットフォームから身体測定データ（身長、体重、体脂肪率）を読み取る。 制限付き
https://www.googleapis.com/auth/fitness.body.write 身体測定データを Google Fit プラットフォームに書き込みます。 制限付き
https://www.googleapis.com/auth/fitness.body_temperature.read Google Fit プラットフォームから体温データを読み取る。 制限付き
https://www.googleapis.com/auth/fitness.body_temperature.write 体温データを Google Fit プラットフォームに書き込みます。 制限付き
https://www.googleapis.com/auth/fitness.heart_rate.read Google Fit プラットフォームから心拍数データを読み取る。 制限付き
https://www.googleapis.com/auth/fitness.heart_rate.write 心拍数データを Google Fit プラットフォームに書き込みます。 制限付き
https://www.googleapis.com/auth/fitness.location.read Google Fit プラットフォームから位置情報を読み取る。 制限付き
https://www.googleapis.com/auth/fitness.location.write 位置情報を Google Fit プラットフォームに書き込みます。 制限付き
https://www.googleapis.com/auth/fitness.nutrition.read Google Fit プラットフォームから栄養データを読み取る。 制限付き
https://www.googleapis.com/auth/fitness.nutrition.write 栄養データを Google Fit プラットフォームに書き込みます。 制限付き
https://www.googleapis.com/auth/fitness.oxygen_saturation.read Google Fit プラットフォームから酸素飽和度データを読み取ります。 制限付き
https://www.googleapis.com/auth/fitness.oxygen_saturation.write Google Fit プラットフォームに酸素飽和度データを書き込みます。 制限付き
https://www.googleapis.com/auth/fitness.reproductive_health.read Google Fit プラットフォームからリプロダクティブ ヘルス データを読み取ります。 制限付き
https://www.googleapis.com/auth/fitness.reproductive_health.write リプロダクティブ ヘルス データを Google Fit プラットフォームに書き込みます。 制限付き
https://www.googleapis.com/auth/fitness.sleep.read Google Fit プラットフォームから睡眠データを読み取る。 制限付き
https://www.googleapis.com/auth/fitness.sleep.write 睡眠データを Google Fit プラットフォームに書き込みます。 制限付き

既存のアプリに新しいスコープを追加する

アプリを更新して新しいスコープをリクエストするとき（たとえば、 読み取りスコープを追加した場合、ユーザーは アプリがこれらのスコープへのアクセスをリクエストしているとします。この場合、アクセス アクセスを拒否することもできます。

リソースの承認は、ユーザーに公開時にリクエストすることをおすすめします。 必要があります。ガイドラインに従って、増分 承認します。

ユーザーがアプリの理由と方法を理解していれば、アクセスを許可する可能性が高くなる このデータを使用します。

  • ユーザーに警告/通知する画面の追加を検討する あります。
  • アプリがこれらのスコープ/データへのアクセスを要求する理由をわかりやすく説明し、 ユーザーは十分な情報に基づいて判断できます。

詳しくは、Android 向けのアプリの権限に関するベスト プラクティスをご覧ください。