Google Health API のデータ型

次の表に、データ型の完全なリストを示します。この表には、Google Health API での各型の表現と、各型が使用可能なスコープを理解するのに役立ついくつかの列が含まれています。

重要: データ型に複数の単語が含まれている場合、データ型識別子の形式が異なります。エンドポイントでは、 データ型名はbody-fat のようにケバブケースにする必要があります。ただし、フィルタ パラメータでは、 データ型名は body_fatのようにスネークケースにする必要があります。

表: Google Health API のデータ型

データ型   dataType   filter パラメータ	レコード タイプ	使用可能な オペレーション	範囲	Webhook のサポート	True zeros のサポート
消費アクティブ エネルギー   active-energy-burned   active_energy_burned	インターバル	list、reconcile、rollup、dailyRollup	activity_and_fitness
アクティブな時間（分）   active-minutes   active_minutes	インターバル	list、reconcile、rollup、dailyRollup	activity_and_fitness
アクティブ ゾーン時間   active-zone-minutes   active_zone_minutes	インターバル	list、reconcile、rollup、dailyRollup	activity_and_fitness
アクティビティ レベル   activity-level   activity_level	インターバル	list、reconcile	activity_and_fitness
高度   altitude   altitude	インターバル	list、reconcile、rollup、dailyRollup	activity_and_fitness
血糖値   blood-glucose   blood_glucose	サンプル	list、get、reconcile、rollup、dailyRollup	health_metrics_and_measurements
体脂肪   body-fat   body_fat	サンプル	list、get、reconcile、rollup、dailyRollup、create、update、batchDelete	health_metrics_and_measurements
心拍ゾーンのカロリー   calories-in-heart-rate-zone   calories_in_heart_rate_zone	インターバル	rollup、dailyRollup	activity_and_fitness
深部体温   core-body-temperature   core_body_temperature	サンプル	list、get、reconcile、rollup、dailyRollup	health_metrics_and_measurements
1 日の心拍変動   daily-heart-rate-variability   daily_heart_rate_variability	毎日	list、reconcile	health_metrics_and_measurements
1 日の心拍ゾーン   daily-heart-rate-zones   daily_heart_rate_zones	毎日	list、reconcile	health_metrics_and_measurements
1 日の酸素飽和度   daily-oxygen-saturation   daily_oxygen_saturation	毎日	list、reconcile	health_metrics_and_measurements
1 日の呼吸数   daily-respiratory-rate   daily_respiratory_rate	毎日	list、reconcile	health_metrics_and_measurements
1 日の安静時の心拍数   daily-resting-heart-rate   daily_resting_heart_rate	毎日	list、reconcile	health_metrics_and_measurements
1 日の睡眠時の体温の推定値   daily-sleep-temperature-derivations   daily_sleep_temperature_derivations	毎日	list、reconcile	health_metrics_and_measurements
1 日の最大酸素摂取量   daily-vo2-max   daily_vo2_max	毎日	list、reconcile	activity_and_fitness
距離   distance   distance	インターバル	list、reconcile、rollup、dailyRollup	activity_and_fitness
心電図   electrocardiogram   electrocardiogram	セッション	list	ecg
運動   exercise   exercise	セッション	list、get、reconcile、create、update、batchDelete	activity_and_fitness
階数   floors   floors	インターバル	reconcile、rollup、dailyRollup	activity_and_fitness
食べ物   food   food	食べ物	list、get	nutrition
食品の測定単位   food-measurement-unit   food_measurement_unit	食べ物	list、get	nutrition
心拍数   heart-rate   heart_rate	サンプル	list、reconcile、rollup、dailyRollup	health_metrics_and_measurements
心拍変動   heart-rate-variability   heart_rate_variability	サンプル	list、reconcile	health_metrics_and_measurements
身長   height   height	サンプル	list、get、reconcile、create、update、batchDelete	health_metrics_and_measurements
水分摂取量の記録   hydration-log   hydration_log	セッション	list、get、reconcile、rollup、dailyRollup、create、update、batchDelete	nutrition
不整脈の通知   irregular-rhythm-notification   irregular_rhythm_notification	セッション	list	irn
栄養摂取量の記録   nutrition-log   nutrition_log	サンプル	list、get、reconcile、rollup、dailyRollup、create、update、batchDelete	nutrition
酸素飽和度   oxygen-saturation   oxygen_saturation	サンプル	list、reconcile	health_metrics_and_measurements
呼吸数睡眠サマリー   respiratory-rate-sleep-summary   respiratory_rate_sleep_summary	サンプル	list、reconcile	health_metrics_and_measurements
ランニング時の最大酸素摂取量   run-vo2-max   run_vo2_max	サンプル	list、reconcile、rollup、dailyRollup	activity_and_fitness
座りがちな時間   sedentary-period   sedentary_period	インターバル	list、reconcile、rollup、dailyRollup	activity_and_fitness
睡眠   sleep   sleep	セッション	list、get、reconcile、create、update、batchDelete	sleep
歩数   steps   steps	インターバル	list、reconcile、rollup、dailyRollup	activity_and_fitness
プールの長さのデータ   swim-lengths-data   swim_lengths_data	インターバル	list、reconcile、rollup、dailyRollup	activity_and_fitness
心拍ゾーンの時間   time-in-heart-rate-zone   time_in_heart_rate_zone	インターバル	list、reconcile、rollup、dailyRollup	activity_and_fitness
総カロリー   total-calories   total_calories	インターバル	rollup、dailyRollup	activity_and_fitness
最大酸素摂取量   vo2-max   vo2_max	サンプル	list、reconcile	activity_and_fitness
体重   weight   weight	サンプル	list、get、reconcile、rollup、dailyRollup、create、update、batchDelete	health_metrics_and_measurements

クエリの制約

API からデータポイント、ロールアップ、1 日のロールアップをクエリする場合は、次の制約に注意してください。

• フィルタの要件: total-calories などの読み取り専用の派生データ型では、間隔の開始時刻を指定するフィルタ（物理時間または市民時間を使用）が必要です。
• クエリ範囲の上限: calories-in-heart-rate-zone、heart-rate、active-minutes、 total-calories のクエリ範囲の上限は 14 日です。他のすべてのデータ型のクエリ範囲の上限は 90 日です。

データの可用性

ユーザーのデータは、アクティビティ トラッカーを同期するか、Fitbit モバイルアプリまたはウェブアプリに新しいデータを手動で入力した後にのみ更新されます。Fitbit アプリがモバイル デバイスで開いていて、2 つのデバイスがアクティブなデータ接続を持ち、Bluetooth 範囲内にある場合、Fitbit デバイスと Fitbit モバイルアプリは 15 分ごとに自動的に同期できます。ユーザーが MobileTrack を使用してアクティビティをトラッキングしている場合、アプリが開いている限り、MobileTrack は 1 時間ごとに同期されます。

サードパーティによるアクセス

Fitbit デバイスは、サードパーティのアプリやサービスと直接通信できません。これらのデバイスは、Fitbit モバイルアプリとのみ通信して同期するように設計されています。

Fitbit アプリが開いているときは、デバイスは 1 日を通してデータを自動的に同期します。Bluetooth が有効で、アプリがバックグラウンドで実行されている場合は、15 分ごとに同期されます。この同期プロセスが完了すると、Google Health API を介してサードパーティ サービスでデータを利用できるようになります。

距離の標準

elevationGainMillimeters などの運動距離は、次の理由からミリメートル単位で測定されます。

1. データの精度を維持する: ミリメートルを使用する最も重要な理由は、読み取って提供するデータの精度を損なわないようにするためです。ミリメートルなどの細かい単位を使用すると、測定値を高い精度で表すことができます。
2. 標準化: ミリメートルは、サービス全体で設計された標準単位です。 この一貫性により、API のさまざまな部分を操作するデベロッパーは、統一されたエクスペリエンスを得ることができます。
3. 幅広い測定システムをサポート: ミリメートルなどの基本単位を使用すると、デベロッパーは、メートル法、 ヤード・ポンド法、その他の測定システムを使用しているかどうかにかかわらず、選択した 他の単位に簡単に変換できます。

日照時間の変動

Health API による時刻処理では、夏時間や旅行による日照時間の変動を考慮して、ユーザーの時刻が優先されます。すべてのデータポイントは、物理的な UTC タイムスタンプと、イベント発生時に有効な UTC オフセットの両方で保存されます。これにより、システムは次のことが可能になります。

• イベントを正確な物理的な瞬間にマッピングする。
• 集計のために、時刻をユーザーのローカル コンテキストに修正する。

夏時間

夏時間になると、「フォールバック」により市民時間が 25 時間になり、その日付のロールアップには 25 時間分のデータが含まれます。「スプリング フォワード」では、時刻が標準時に戻る 23 時間の市民時間になります。

旅行

タイムゾーンをまたぐ旅行では、1 日の物理的な長さがさらに大きく変動する可能性があります。

dailyRollUp エンドポイントを使用して、タイムゾーンの違いを調整します。ユーザーの現地時間に従って記録された日付にデータが自動的に割り当てられるため、タイムゾーンが変更されても 1 日を効果的に「つなぎ合わせる」ことができます。