添加饮水量数据

您可以通过创建数据源并使用 com.google.hydration数据类型，将水份摄取数据添加到 Google 健身。每个数据点都代表着用户作为单次饮用的一部分而摄入的体积（以升为单位）。请使用浮点数指定体积。注意：时间戳表示饮用时间。由于 com.google.hydration 是一种即时数据类型，因此开始时间和结束时间应相同。

创建数据源

Android

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

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

REST

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

HTTP 方法

POST

Request 网址

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。

C网址 命令

$ 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

添加水份摄取数据

Android

此示例向您展示了如何创建新的数据点，以及如何使用数据源添加 0.3 升饮用水的水份摄取数据。

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

REST

此示例向您展示了如何使用数据源添加水份摄取数据。

HTTP 方法

PATCH

Request 网址

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 表示法。

C网址 命令

$ 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