データ型

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

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

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

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

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

データ型グループ

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

一般公開データの種類

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

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

• アクティビティのデータ型
• 位置情報の種類
• 栄養データ型

健康に関するデータの種類

プラットフォームが提供するデータの種類で、 機密データを検出できます。詳しくは、健康に関するデータをご覧ください。 タイプをご覧ください。

データ型を集計する

時間単位または期間単位で集計した健康とウェルネスに関する情報を読み取るデータの種類 選択します。詳しくは、データを集計する タイプをご覧ください。

非公開のカスタムデータ型

特定のアプリで定義されたカスタムデータ型。定義するアプリのみが データ型は、この型のデータを読み書きできます。詳細については、次をご覧ください: カスタムデータ型。

データ型の使用

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()

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

認可スコープ

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

</ph>

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

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

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

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

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

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

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

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

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

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