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