應用程式可以藉由寫入
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
如要寫入血糖資料點,請建立新的 DataSource
/TYPE_BLOOD_GLUCOSE,
如以下範例所示:
val bloodGlucoseSource = DataSource.Builder()
    .setDataType(TYPE_BLOOD_GLUCOSE)
    // ...
    .build()
REST
如要寫入血糖資料點,請建立新的資料來源。
HTTP 方法
POST
要求網址
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 狀態
再也不是件繁重乏味的工作回應主體包含資料來源的 JSON 表示法,
包括可用於資料的 datasource.dataStreamId 屬性
後續要求的來源 ID
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
要求網址
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
