您可以建立資料來源並使用 com.google.hydration
資料類型,在 Google Fit 中新增飲水資料。每個資料點代表使用者在單一飲料中消耗的體積 (公升)。請使用浮動功能來指定音量。注意:時間戳記代表有人飲用飲料。由於 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