您的应用可以通过写入 com.google.blood_glucose
数据类型来记录血糖数据。在此数据类型中,每个数据点代表一个瞬时血糖读数。数据点包含血糖浓度、进食与睡眠的时间关系以及测量的样本的来源字段。除血糖浓度之外的所有字段都是可选的。
- 血糖浓度以 mmol/L 为单位(1 mmol/L 等于 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
如需写入血糖数据点,请创建 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