写入血糖数据

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

创建数据源

Android

如需写入血糖数据点,请创建 TYPE_BLOOD_GLUCOSE 的新 DataSource,如以下示例所示:

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 表示法,包括 datasource.dataStreamId 属性,您可以将其用作后续请求的数据源 ID。

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 正文带有注释,以表明运行状况字段常量的使用。虽然 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