熱量和能量資料類型

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

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

支援的資料類型

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

表格：Google Health API 熱量資料類型

資料類型   dataType   filter 參數	記錄 類型	可用的 作業	範圍	Webhook 支援	支援真正的零
消耗的活動熱量   active-energy-burned   active_energy_burned	時間間隔	list、reconcile、rollup、dailyRollup	activity_and_fitness
基礎消耗的熱量   basal-energy-burned   basal_energy_burned	時間間隔	list、reconcile	activity_and_fitness
基礎代謝率   basal-metabolic-rate   basal_metabolic_rate	範例	list、reconcile	營養學

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

總卡路里

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

活動時消耗的熱量

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

REST 表示法範例

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

基礎消耗的能量

基礎能量消耗量是指使用者在一段時間內，因靜止代謝而消耗的卡路里，以大卡 (kcal) 為單位。

注意：這類資料不支援匯總和每日匯總作業。如要取得每日基礎能量值，請使用基礎代謝率資料類型。

基礎代謝率

基礎代謝率是指身體在正常休息狀態下消耗的能量，測量單位為每日千卡 (kcal/day)。由於基礎代謝率會隨著時間和身體變化 (例如體重) 而有所不同，因此 API 會將基礎代謝率記錄為速率樣本的時間序列。

開發人員可以將rateKcalPerDay樣本中的 rateKcalPerDay 欄位視為每日消耗基礎能量的每日匯總資料。basal-metabolic-rate

REST 表示法範例

{
  "date": {
    "year": 2026,
    "month": 4,
    "day": 20
  },
  "dataSource": { ... },
  "rateKcalPerDay": 1650.0
}

規範

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

• 每日總覽：如要顯示每日總卡路里消耗量，請要求 total-calories 資料類型的每日匯總。
• 僅限活動的熱量消耗：如要追蹤特定運動或全天燃燒的卡路里，但不包括靜止代謝率，請查詢 active-energy-burned。
• 基礎指標：如要追蹤靜止代謝率或基礎代謝趨勢，請查詢 basal-metabolic-rate 的基礎代謝率值。將 BMR 樣本視為使用者每日靜止能量消耗的基準。