数据类型

Google 健身在 com.google 命名空间下提供一组健康和健身数据类型。

数据类型定义了数据点内值的格式。数据点可以表示：

• 即时读取或观察
• 包含一段时间内统计信息的汇总

Google 健身定义了用于即时观察的数据类型，以及用于汇总的数据类型 数据。数据点由数据类型字段的值和时间戳信息组成。 表示瞬时观察结果的点包括时间戳和 聚合数据类型还包括间隔的开始时间。

Google 健身还支持定义新的数据类型。

数据类型组

Google 健身包含以下数据类型：

公开数据类型

平台提供的标准数据类型带有“com.google”标记，前缀。例如，com.google.step_count.delta。这些类型的数据可捕获以下内容的即时读数： 健康和健身数据，包括健身活动、睡眠和营养。不限 应用可以请求相关权限以读取和写入这些数据类型 只有少数几个位置数据类型只能由 编写。

如需了解详情，请参阅：

• 活动数据类型
• 营业地点数据类型
• 营养数据类型

健康数据类型

平台提供的因以下原因限制访问权限的数据类型 潜在的敏感数据。如需了解更多信息，请参阅健康数据 类型。

汇总数据类型

用于读取按时间或 活动类型。有关详情，请参阅汇总数据 类型。

不公开的自定义数据类型

由特定应用定义的自定义数据类型。只有定义 该数据类型可以读取和写入此类型的数据。如需了解详情，请参阅 自定义数据类型。

使用数据类型

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 健身平台 请求写入范围。

以负责任的方式选择数据类型。针对您的应用，不要请求所有数据类型 可能需要用到它。指定的类型决定了系统提示用户的范围 来向其授予权限只询问您的应用需要的数据类型， 更有可能授予访问权限。用户更乐意授予受限、明确的访问权限 所述的范围。

使用此表检查您的应用需要访问的范围是敏感范围还是 （这决定了 步骤）：

向现有应用添加新范围

当您更新应用以请求新范围时（例如，如果您添加了新的 睡眠或心率范围，或添加读取范围），系统会提示用户 您的应用正在请求对这些范围的访问权限，他们可以选择 或拒绝访问

最佳做法是，请求用户立即对资源进行授权 您需要它们。遵循有关请求分步 授权。

如果用户了解应用的原因/方式，将更有可能授予访问权限 使用这些数据：

• 考虑添加一个屏幕，以警告/告知用户系统将要求用户执行该操作 这些范围。
• 明确说明您的应用请求访问这些范围/数据的原因， 帮助用户做出明智的决定。

详细了解 Android 应用权限方面的最佳实践。