アプリは、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