讀取食物份量

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 月 1 日 00:00:00 UTC 到 2019 年 1 月 2 日 00:00:00 的 datasetId。

注意：您可以使用欄位遮罩，只接收回應中的相關值。此範例使用 point/value/stringVal 欄位遮罩，只取得攝入食物的名稱 (如 stringVal 所示)。這會排除資料集資源中 com.google.nutrition 資料點 (例如 nutrients、meal_type 和 food_item) 的其他預設欄位。您可以編輯欄位遮罩以新增或移除屬性。舉例來說，point(startTimeNanos,value/stringVal) 會納入每個食品的時間戳記。

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