新增水份資料

您可以建立資料來源，並使用 com.google.hydration 資料類型。每個資料點都代表使用者在單杯飲料中所消耗的容量 (以公升為單位)。使用浮點值執行下列操作： 指定音量 注意：時間戳記會指出飲料的消費時間。由於 com.google.hydration 是即時資料類型，因此開始時間和結束時間應相同。

建立資料來源

Android

使用 DataSource.Builder 建立新的資料來源。例如 hydrationSource。

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

REST

呼叫 REST API 來建立新的資料來源。例如 HydrationSource。

HTTP 方法

POST

要求網址

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

新增飲水量資料

Android

本範例說明如何使用資料來源建立新資料點，並新增 0.3 公升水的補水資料。

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

REST

這個範例說明如何使用您的資料新增水份資料 來源。

HTTP 方法

PATCH

要求網址

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