添加饮水量数据

您可以通过创建数据源并使用 com.google.hydration 数据类型,将补水数据添加到 Google 健身中。每个数据点都代表用户在一次饮用中摄入的饮料量(以升为单位)。使用浮点数 指定音量。 注意:时间戳指示饮用时间。由于 com.google.hydration 是瞬时数据类型,因此开始时间和结束时间应相同。

创建数据源

AndroidREST

使用 DataSource.Builder 创建新的数据源。例如 hydrationSource

val hydrationSource = DataSource.Builder()
   
.setDataType(DataType.TYPE_HYDRATION)
   
.setStreamName("hydrationSource")
   
// ...
   
.build()

调用 REST API 以创建新的数据源。例如 HydrationSource

HTTP 方法

POST

Request URL

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

请求正文

{
 
"dataStreamName": "HydrationSource",
 
"type": "raw",
 
"application": {
   
"detailsUrl": "http://example.com",
   
"name": "My Example App",
   
"version": "1"
 
},
 
"dataType": {
   
"name": "com.google.hydration",
   
"field": [
     
{
     
"name": "volume",
     
"format": "floatPoint",
     
"optional": false
     
}
   
]
   
}
}

答案

如果数据源成功创建,响应将是 200 OK 状态代码。响应正文包含数据源的 JSON 表示法, 添加一个 datasource.dataStreamId 属性,该属性可用作数据 后续请求的来源 ID。

CURL 命令

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

添加饮水量数据

AndroidREST

此示例展示了如何使用数据源创建新数据点,并添加 0.3 升饮水量的数据。

val hydration = DataPoint.builder(hydrationSource)
   
.setTimestamp(timestamp, TimeUnit.MILLISECONDS)
   
.setField(FIELD_VOLUME, 0.3f)
   
.build()

此示例展示了如何使用数据源添加补水数据。

HTTP 方法

PATCH

Request URL

https://www.googleapis.com/fitness/v1/users/me/dataSources/raw:com.google.hydration:407408718192:HydrationSource/datasets/1275753581000000000-1275753581000000000

请求正文

{
 
"minStartTimeNs": 1275753581000000000,
 
"maxEndTimeNs": 1275753581000000000,
 
"dataSourceId": "raw:com.google.hydration:407408718192:HydrationSource",
 
"point": [
 
{
   
"startTimeNanos": 1275753581000000000,
   
"endTimeNanos": 1275753581000000000,
   
"dataTypeName": "com.google.hydration",
   
"value": [
   
{
     
"fpVal": 0.3
   
}
   
]
 
}
 
]
}

答案

如果数据点已成功创建,您会收到 200 OK HTTP 响应状态代码。响应正文包含数据集的 JSON 表示法。

CURL 命令

$ curl --header "Authorization: Bearer ya29.yourtokenvalue" --request PATCH \
 
--header "Content-Type: application/json;encoding=utf-8" --data @hydration-data.json \
  https
://www.googleapis.com/fitness/v1/users/me/dataSources/raw:com.google.hydration:407408718192:HydrationSource/datasets/1275753581000000000-1275753581000000000