熱量和能量資料類型

Google 健康資料 API 提供可追蹤使用者卡路里和能量消耗的資料類型。這些類型會測量能量消耗的不同層面，包括總消耗量、活動消耗量和靜止 (基礎) 代謝率。

瞭解這些資料類型的差異，判斷哪些指標適合您的應用程式。

支援的資料類型

這項 API 支援下列資料類型，可測量熱量和能量消耗：

表格：Google Health API 熱量資料類型
資料類型
  dataType
  filter 參數		 記錄
類型		 可用的
作業		 範圍 Webhook
支援		 支援真正的零
消耗的活動熱量
  active-energy-burned
  active_energy_burned 		時間間隔 list、reconcile、rollup、dailyRollup .activity_and_fitness.readonly
.activity_and_fitness.writeonly
總熱量
  total-calories
  total_calories 		時間間隔 rollup、dailyRollup .activity_and_fitness.readonly
.activity_and_fitness.writeonly

以下各節提供各資料類型的技術詳細資料，包括 REST 表示法範例和特定整合限制。

總卡路里

「總熱量」是唯讀的衍生資料類型，可追蹤使用者消耗的所有能量，包括基礎代謝和活動能量，以千卡 (kcal) 為單位。這項值是根據活動能量消耗和使用者的基礎代謝率計算得出。

total-calories 資料類型的查詢必須包含時間間隔篩選器 (例如 total_calories.interval.start_time 或 total_calories.interval.civil_start_time)。這類查詢的範圍上限為 14 天。

查詢示例

如要查詢 total-calories 資料類型，請將要求傳送至 list 端點，並使用間隔篩選器：

要求

GET https://health.googleapis.com/v4/users/me/dataTypes/total-calories/dataPoints?filter=total_calories.interval.start_time >= "2026-04-20T00:00:00Z" AND total_calories.interval.start_time < "2026-04-21T00:00:00Z"
Authorization: Bearer access-token
Accept: application/json

活動時消耗的熱量

「活動時消耗的能量」是指使用者在活動期間消耗的能量，不包括基礎能量消耗，以千卡 (kcal) 為單位。

REST 表示法範例

{
  "startTime": "2026-04-20T08:00:00Z",
  "startUtcOffset": "0s",
  "endTime": "2026-04-20T08:30:00Z",
  "endUtcOffset": "0s",
  "dataSource": { ... },
  "kcal": 150.0
}

規範

在應用程式中整合卡路里和能量指標時，請遵循下列規範：

  • 每日總覽：如要顯示每日總卡路里消耗量，請要求 total-calories 資料類型的每日匯總。
  • 僅限活動的熱量消耗：如要追蹤特定運動或全天燃燒的卡路里，但不包括靜止代謝率，請查詢 active-energy-burned。
上一頁
裝置相容性
下一頁
生命徵象