カロリーとエネルギーのデータ型

Google Health API は、ユーザーのカロリーとエネルギー消費量を追跡するデータ型を提供します。これらの型は、総消費量、活動中の消費量、安静時（基礎）代謝率など、エネルギー消費のさまざまな側面を測定します。

これらのデータ型の違いを理解して、アプリケーションに適した指標を判断します。

サポートされるデータタイプ

この API は、消費カロリーとエネルギー消費量を測定するために次のデータ型をサポートしています。

表: Google Health API のカロリー データ型
データ型
  dataType
  filter パラメータ		 Record
type		 利用可能な
オペレーション		 スコープ 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
基礎代謝率 (BMR)
  basal-metabolic-rate
  basal_metabolic_rate 		サンプル list、reconcile 栄養

以降のセクションでは、各データ型の技術的な詳細について説明します。これには、REST 表現の例や特定の統合制約が含まれます。

総カロリー

Total Calories は、ユーザーが消費したすべてのエネルギー（基礎代謝と活動エネルギーを含む）をキロカロリー（kcal）で測定する読み取り専用の派生データ型です。この値は、活動エネルギー消費量とユーザーの基礎代謝率から計算されます。

活動エネルギー消費量

「アクティブな消費カロリー」は、ユーザーが活動中に消費したエネルギー（基礎代謝量を除く）を表します。単位はキロカロリー（kcal）です。

REST 表現の例

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

基礎エネルギー消費量

基礎消費エネルギーは、ユーザーの安静時の代謝によって消費されたカロリーを一定期間にわたって測定したもので、キロカロリー（kcal）で表されます。

注: このデータ型では、ロールアップと毎日のロールアップ オペレーションは使用できません。毎日の基礎代謝量を取得するには、基礎代謝率のデータ型を使用してください。

基礎代謝率

基礎代謝率は、安静時の身体が消費するエネルギーを測定したもので、1 日あたりのキロカロリー（kcal/day）で測定されます。このレートは、体重などの身体の変化によって時間とともに変動するため、API は BMR をレート サンプルの時系列として記録します。

デベロッパーは、basal-metabolic-rate サンプルの rateKcalPerDay フィールドを、基礎代謝量の 1 日のロールアップに対応する 1 日の消費カロリーとして扱うことができます。

REST 表現の例

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

ガイドライン

アプリでカロリーとエネルギーの指標を統合する際は、次のガイドラインを使用してください。

  • 1 日の概要: 1 日の総消費カロリーを表示するには、total-calories データ型の 1 日のロールアップをリクエストします。
  • アクティビティのみの消費量: 特定のワークアウト中または 1 日を通して消費されたカロリーを、安静時の代謝率を除いてトラッキングするには、active-energy-burned をクエリします。
  • 基礎指標: 基礎代謝率または基礎代謝の傾向を追跡するには、basal-metabolic-rate に BMR 値をクエリします。BMR サンプルは、ユーザーの安静時のエネルギー消費量の 1 日のベースラインとして扱います。
前へ
データ型のインデックス