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

Google Health API は、ユーザーのカロリーとエネルギー消費量をトラッキングするデータ型を提供します。これらのタイプは、総消費量、アクティブな消費量、安静時（基礎）代謝率など、エネルギー消費のさまざまな側面を測定します。

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

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

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

表: Google Health API のカロリー データ型
データ型
  dataType
  filter パラメータ		 Record
type		 利用可能な
オペレーション		 スコープ Webhook
サポート		 True zeros
サポート
アクティブな消費カロリー
  active-energy-burned
  active_energy_burned 		間隔 list、reconcile、rollup、dailyRollup activity_and_fitness
総カロリー
  total-calories
  total_calories 		間隔 rollup、dailyRollup activity_and_fitness

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

総カロリー

Total Calories は、基礎代謝や活動エネルギーなど、ユーザーが消費したすべてのエネルギーをキロカロリー（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
}

ガイドライン

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

  • 1 日の概要: 1 日の総消費カロリーを表示するには、total-calories データ型の 1 日のロールアップをリクエストします。
  • アクティビティのみの消費量: 特定のワークアウト中または 1 日を通して消費されたカロリーを、安静時の代謝率を除いてトラッキングするには、active-energy-burned をクエリします。
前へ
デバイスの互換性
次へ
主な指標