血糖データの書き込み

アプリは、com.google.blood_glucose データ型に書き込むことで血糖データを記録できます。このデータ型では、各データポイントは単一の瞬間的な血糖値を表します。データポイントには、血糖値、食事や睡眠の時間的関係、測定された検体のソースのフィールドが含まれています。血糖濃度を除くすべてのフィールドは省略可能です。

  • 血糖濃度は mmol/L で測定します（1 mmol/L は 18 mg/dL に相当します）。
  • 指定する場合、食事との時間的関係は、FIELD_TEMPORAL_RELATION_TO_MEAL にリストされている値のいずれかである必要があります。
  • 食事の種類は、FIELD_MEAL_TYPE に記載されている値のいずれかにする必要があります。食事の種類が不明な場合は、MEAL_TYPE_UNKNOWN を使用します。
  • 指定する場合、睡眠との時間的関係は、FIELD_TEMPORAL_RELATION_TO_SLEEP にリストされている値のいずれかである必要があります。
  • 指定する場合、血糖試料源は FIELD_BLOOD_GLUCOSE_SPECIMEN_SOURCE に記載されている値のいずれかである必要があります。

データソースを作成する

Android

血糖データポイントを書き込むには、次の例に示すように、TYPE_BLOOD_GLUCOSE の新しい DataSource を作成します。

val bloodGlucoseSource = DataSource.Builder()
    .setDataType(TYPE_BLOOD_GLUCOSE)
    // ...
    .build()

REST

血糖データポイントを書き込むには、新しいデータソースを作成します。

HTTP メソッド

POST

リクエスト URL

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

リクエストの本文

{
  "dataStreamName": "BloodGlucose",
  "type": "raw",
  "application": {
    "detailsUrl": "http://example.com",
    "name": "My Example App",
    "version": "1"
  },
  "dataType": {
    "name": "com.google.blood_glucose"
   }
}

レスポンス

データソースが正常に作成された場合、レスポンスは 200 OK ステータス コードです。レスポンスの本文には、後続のリクエストのデータソース ID として使用できる datasource.dataStreamId プロパティを含む、データソースの JSON 表現が含まれます。

CURL コマンド

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

データの追加

Android

上記で作成したソースにデータを追加するには、このデータソースのデータポイントを作成します。これは、History API を使用して挿入できます。

val bloodGlucose = DataPoint.builder(bloodGlucoseSource)
    .setTimestamp(timestamp, TimeUnit.MILLISECONDS)
    .setField(FIELD_BLOOD_GLUCOSE_LEVEL, 5.0f) // 90 mg/dL
    .setField(FIELD_TEMPORAL_RELATION_TO_MEAL, FIELD_TEMPORAL_RELATION_TO_MEAL_BEFORE_MEAL)
    .setField(FIELD_MEAL_TYPE, MEAL_TYPE_BREAKFAST)
    .setField(FIELD_TEMPORAL_RELATION_TO_SLEEP, TEMPORAL_RELATION_TO_SLEEP_ON_WAKING)
    .setField(FIELD_BLOOD_GLUCOSE_SPECIMEN_SOURCE, BLOOD_GLUCOSE_SPECIMEN_SOURCE_CAPILLARY_BLOOD)
    .build()

REST

この例では、上で作成したデータソースを使用して血糖データを追加する方法を示します。

HTTP メソッド

PATCH

リクエスト URL

https://www.googleapis.com/fitness/v1/users/me/dataSources/datasource.dataStreamId/datasets/1574159699023000000-1574159699023000000

リクエストの本文

以下の JSON 本文では、ヘルス フィールドの定数の使用方法を示すコメントを注釈を付けています。現在 Fit API ではコメントがドロップされますが、JSON は公式にコメントをサポートしていないため、コードからコメントを削除することを強くおすすめします。

{
  "minStartTimeNs": 1574159699023000000,
  "maxEndTimeNs": 1574159699023000000,
  "dataSourceId": "datasource.dataStreamId",
  "point": [
    {
      "startTimeNanos": 1574159699023000000,
      "endTimeNanos": 1574159699023000000,
      "dataTypeName": "com.google.blood_glucose",
      "value": [
        {
          // Blood glucose level, 90 mg/dL
          "fpVal": 5.0
        },
        {
          // FIELD_TEMPORAL_RELATION_TO_MEAL_BEFORE_MEAL
          "intVal": 3
        },
        {
          // MEAL_TYPE_BREAKFAST
          "intVal": 1
        },
        {
          // TEMPORAL_RELATION_TO_SLEEP_ON_WAKING
          "intVal": 3
        },
        {
          // BLOOD_GLUCOSE_SPECIMEN_SOURCE_CAPILLARY_BLOOD
          "intVal": 2
        }
      ]
    }
  ]
}

レスポンス

血糖データが正常に追加されると、レスポンスは 200 OK ステータス コードです。レスポンスの本文には、追加された血糖データの JSON 表現が含まれます。

CURL コマンド

$ curl --header "Authorization: Bearer ya29.yourtokenvalue --request PATCH \
    --header "Content-Type: application/json;encoding=utf-8" --data @blood-glucose-data.json \
    https://www.googleapis.com/fitness/v1/users/me/dataSources/datasource.dataStreamId/datasets/1574159699023000000-1574159699023000000