閱讀攝取的食物

Android

應用程式可以建立資料讀取要求並查詢 DataType.TYPE_NUTRITION，取得指定時間範圍內的食品清單，如以下範例所示：

val readRequest = DataReadRequest.Builder()
    .read(DataType.TYPE_NUTRITION)
    .setTimeRange(startTime, endTime, TimeUnit.MILLISECONDS)
    .build()

如要進一步瞭解讀取資料，請參閱「使用健身記錄」。

REST

透過 REST API 擷取食用的食物清單有三個階段程序：

  1. 擷取 com.google.nutrition 資料類型可用的資料來源清單。或者，如果已知道資料來源詳細資料，就能在下一個步驟中直接使用這些資料。
  2. 請依序從各個資料來源取得一份食物清單。
  3. (如果有多個資料來源) 請在用戶端應用程式內合併食物項目清單。

擷取食物資料來源清單

由於每個資料來源都需要 datasource.dataStreamId，因此可以使用欄位遮罩 (如此處所示)，將回應限制為僅限這個屬性。

HTTP 方法

GET

要求網址

https://www.googleapis.com/fitness/v1/users/me/dataSources?dataTypeName=com.google.nutrition&fields=dataSource(dataStreamId)

回應

如果成功，回應會顯示 200 OK 狀態碼。回應主體包含 JSON 清單，清單中每個項目對應一個資料來源。

例如：

{
 "dataSource": [
  {
   "dataStreamId": "raw:com.google.nutrition:com.example.nutritionSource1:"
  },
  {
   "dataStreamId": "raw:com.google.nutrition:com.example.nutritionSource2:"
  }
 ]
}

CURL 指令

$ curl \
  'https://www.googleapis.com/fitness/v1/users/me/dataSources?dataTypeName=com.google.nutrition&fields=dataSource(dataStreamId)' \
      --header 'Authorization: Bearer ya29.yourtokenvalue' \
      --header 'Accept: application/json' \
      --compressed

從資料來源取得飲食清單

依序使用步驟 1 中各個來源的 dataSource.dataStreamId 來擷取飲食清單。

datasetId 是必要時間範圍的開始和結束時間，以奈秒為單位，如資料集資源中所定義。

舉例來說，1546300800000000000-1546387200000000000 代表 2019 年 1 月 01 日 00:00:00 (世界標準時間) 至 2019 年 1 月 2 日 00:00:00 的 datasetId。

HTTP 方法

GET

要求網址

https://www.googleapis.com/fitness/v1/users/me/dataSources/dataSource.dataStreamId/datasets/1546300800000000000-1546387200000000000?fields=point%2Fvalue%2FstringVal

回應

{
 "point": [
  {
   "value": [
    {},
    {},
    {
     "stringVal": "apple"
    }
   ]
  },
  {
   "value": [
    {},
    {},
    {
     "stringVal": "banana"
    }
   ]
  },
  {
   "value": [
    {},
    {},
    {
     "stringVal": "carrot"
    }
   ]
  }
 ]
}

CURL 指令

$ curl \
  'https://www.googleapis.com/fitness/v1/users/me/dataSources/dataSource.dataStreamId/datasets/157059699023000000-1575159699023999000?fields=point%2Fvalue%2FstringVal' \
      --header 'Authorization: Bearer ya29.yourtokenvalue' \
      --header 'Accept: application/json' \
      --compressed