水分補給データの追加

水分補給データを Google Fit に追加するには、データソースを作成し、com.google.hydration データ型を使用します。各データポイントは、ユーザーが 1 つの飲料の一部として消費した容量（リットル単位）を表します。浮動小数点数を使用してボリュームを指定します。注: タイムスタンプは飲み物がいつ消費されたかを示します。com.google.hydration は瞬間的なデータ型であるため、開始時間と終了時間は同じにする必要があります。

データソースの作成

Android

DataSource.Builder を使用して新しいデータソースを作成します。例: hydrationSource

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

REST

REST API を呼び出して新しいデータソースを作成します。たとえば、HydrationSource です。

HTTP メソッド

POST

リクエスト 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 ステータス コードになります。レスポンスの本文には、後続のリクエストのデータソース ID として使用できる datasource.dataStreamId プロパティなど、データソースの JSON 表現が含まれます。

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

リクエスト 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