写入血糖数据

您的应用可以通过写入 com.google.blood_glucose 数据类型来记录血糖数据。在此数据类型中，每个数据点表示一个瞬时血糖读数。数据点包含血糖浓度、与膳食和睡眠的时间关系以及所测量样本的来源等字段。除血糖浓度之外的所有字段均为选填字段。

注意 ：由于健康数据可能属于敏感数据，因此 Google 健身会限制对健康数据类型的读写权限。

• 血糖浓度以 mmol/L 为单位（1 毫摩尔/升相当于 18 mg/dL）。
• 如果指定，则与膳食的时间关系必须具有 FIELD_TEMPORAL_RELATION_TO_MEAL 中列出的某个值。
• 膳食类型必须使用 FIELD_MEAL_TYPE 中列出的某个值。 如果膳食类型未知，请使用 MEAL_TYPE_UNKNOWN。
• 如果指定，则与睡眠的时间关系必须具有 FIELD_TEMPORAL_RELATION_TO_SLEEP 中列出的某个值。
• 如果指定，则血糖标本来源必须具有 FIELD_BLOOD_GLUCOSE_SPECIMEN_SOURCE 中列出的值之一。

创建数据源

Android

如需写入血糖数据点，请创建一个新的 DataSource 并将其设置为 TYPE_BLOOD_GLUCOSE，如以下示例所示：

val bloodGlucoseSource = DataSource.Builder()
    .setDataType(TYPE_BLOOD_GLUCOSE)
    // ...
    .build()

REST

如要写入血糖数据点，请创建新的数据源。

HTTP 方法

POST

Request URL

https://www.googleapis.com/fitness/v1/users/me/dataSources

请求正文

{
  "dataStreamName": "BloodGlucose",
  "type": "raw",
  "application": {
    "detailsUrl": "http://example.com",
    "name": "My Example App",
    "version": "1"
  },
  "dataType": {
    "name": "com.google.blood_glucose"
   }
}

答案

如果成功创建数据源，响应将是 200 OK 状态代码。响应正文包含数据源的 JSON 表示法，其中包括可用于后续请求的数据源 ID 的 datasource.dataStreamId 属性。

C网址 命令

$ curl --header "Authorization: Bearer ya29.yourtokenvalue --request POST \
  --header "Content-Type: application/json;encoding=utf-8" --data @blood-glucose-ds.json \
  https://www.googleapis.com/fitness/v1/users/me/dataSources

添加数据

Android

如需将数据添加到上面创建的数据源，请为此数据源创建一个数据点，并使用 History API 插入该数据点：

val bloodGlucose = DataPoint.builder(bloodGlucoseSource)
    .setTimestamp(timestamp, TimeUnit.MILLISECONDS)
    .setField(FIELD_BLOOD_GLUCOSE_LEVEL, 5.0f) // 90 mg/dL
    .setField(FIELD_TEMPORAL_RELATION_TO_MEAL, FIELD_TEMPORAL_RELATION_TO_MEAL_BEFORE_MEAL)
    .setField(FIELD_MEAL_TYPE, MEAL_TYPE_BREAKFAST)
    .setField(FIELD_TEMPORAL_RELATION_TO_SLEEP, TEMPORAL_RELATION_TO_SLEEP_ON_WAKING)
    .setField(FIELD_BLOOD_GLUCOSE_SPECIMEN_SOURCE, BLOOD_GLUCOSE_SPECIMEN_SOURCE_CAPILLARY_BLOOD)
    .build()

REST

此示例演示如何使用上面创建的数据源添加血糖数据。

HTTP 方法

PATCH

Request URL

https://www.googleapis.com/fitness/v1/users/me/dataSources/datasource.dataStreamId/datasets/1574159699023000000-1574159699023000000

请求正文

为清楚起见，下面显示的 JSON 正文带有注释，以显示 health 字段常量的用法。虽然 Fit API 目前会丢弃评论，但强烈建议您从代码中移除这些评论，因为 JSON 并未正式支持评论。

{
  "minStartTimeNs": 1574159699023000000,
  "maxEndTimeNs": 1574159699023000000,
  "dataSourceId": "datasource.dataStreamId",
  "point": [
    {
      "startTimeNanos": 1574159699023000000,
      "endTimeNanos": 1574159699023000000,
      "dataTypeName": "com.google.blood_glucose",
      "value": [
        {
          // Blood glucose level, 90 mg/dL
          "fpVal": 5.0
        },
        {
          // FIELD_TEMPORAL_RELATION_TO_MEAL_BEFORE_MEAL
          "intVal": 3
        },
        {
          // MEAL_TYPE_BREAKFAST
          "intVal": 1
        },
        {
          // TEMPORAL_RELATION_TO_SLEEP_ON_WAKING
          "intVal": 3
        },
        {
          // BLOOD_GLUCOSE_SPECIMEN_SOURCE_CAPILLARY_BLOOD
          "intVal": 2
        }
      ]
    }
  ]
}

答案

如果成功添加血糖数据，响应将是 200 OK 状态代码。响应正文包含添加的血糖数据的 JSON 表示法。

C网址 命令

$ curl --header "Authorization: Bearer ya29.yourtokenvalue --request PATCH \
    --header "Content-Type: application/json;encoding=utf-8" --data @blood-glucose-data.json \
    https://www.googleapis.com/fitness/v1/users/me/dataSources/datasource.dataStreamId/datasets/1574159699023000000-1574159699023000000

注意 ：添加数据时，请在 C网址 命令中使用 --request PATCH（而不是 --request POST）。