Fitbit API to Google Health API Mapping

Reference mapping for RestoreHealth.app studies migrating from Fitbit Web API scopes, data types, and endpoint patterns.

Migration Reference

RestoreHealth.app uses the Google Health API migration model to align legacy Fitbit Web API concepts with Google Health API authorization scopes, data types, and REST methods. This page is a study-team reference for planning scope requests, IRB language, and exports.

Source: Google Health API migration specifications .

Scope Mapping

Fitbit Web API Scope	Google Health API Scope	RestoreHealth.app Notes
activity	activity_and_fitness.readonly / activity_and_fitness.writeonly	Use readonly for participant activity collection; use writeonly only when a study sends data.
blood_glucose	health_metrics_and_measurements.readonly / health_metrics_and_measurements.writeonly	Use for glucose-related health measurement workflows.
cardio_fitness	activity_and_fitness.readonly / activity_and_fitness.writeonly	Includes fitness-oriented measures such as VO2 max.
electrocardiogram	ecg.readonly	Read access for eligible ECG data when supported and approved.
heartrate	health_metrics_and_measurements.readonly / health_metrics_and_measurements.writeonly	Use for heart rate and related measurement data.
irregular_rhythm_notifications	irn.readonly	Read access for irregular rhythm notification records.
location	location.readonly	Request only when location is explicitly required by the protocol.
nutrition	nutrition.readonly / nutrition.writeonly	Use for food, hydration, and nutrition log workflows.
oxygen_saturation	health_metrics_and_measurements.readonly / health_metrics_and_measurements.writeonly	Use for SpO2 summaries and intraday oxygen saturation data.
profile	profile.readonly / profile.writeonly	Use for profile fields approved by the study and consent flow.
respiratory_rate	health_metrics_and_measurements.readonly / health_metrics_and_measurements.writeonly	Use for respiratory rate and related measurement data.
settings	settings.readonly / settings.writeonly	Use for unit and timezone workflows when needed.
sleep	sleep.readonly / sleep.writeonly	Use readonly for sleep sessions and sleep-stage collection.
temperature	health_metrics_and_measurements.readonly / health_metrics_and_measurements.writeonly	Use for core body temperature and sleep temperature derivations.
weight	health_metrics_and_measurements.readonly / health_metrics_and_measurements.writeonly	Use for weight and body composition measures.

Data Type Mapping

Fitbit Web API Data Type	Google Health API Data Type	Google Health API Identifier
Activity Calories	Active Energy Burned	active-energy-burned
Active Zone Minutes	Active Zone Minutes	active-zone-minutes
User activity level changes	Activity Level	activity-level
Elevation	Altitude	altitude
Activity caloriesBMR	Basal Energy Burned	basal-energy-burned
Blood Glucose	Blood Glucose	blood-glucose
Body fat	Body Fat	body-fat
caloriesOut in each heart rate zone	Calories In Heart Rate Zone	calories-in-heart-rate-zone
Temperature (Core)	Core Body Temperature	core-body-temperature
HRV summary	Daily Heart Rate Variability	daily-heart-rate-variability
SpO2 summary	Daily Oxygen Saturation	daily-oxygen-saturation
Resting heart rate	Daily Resting Heart Rate	daily-resting-heart-rate
Skin temperature	Daily Sleep Temperature Derivations	daily-sleep-temperature-derivations
Distance	Distance	distance
Electrocardiogram (ECG)	Electrocardiogram (ECG)	electrocardiogram
Recorded activity	Exercise	exercise
Floors	Floors	floors
Food	Food	food
Food Measurement Unit	Food Measurement Unit	food-measurement-unit
Heart Rate	Heart Rate	heart-rate
HRV Intraday	Heart Rate Variability	heart-rate-variability
Irregular Rhythm Notifications (IRN)	Irregular Rhythm Notification	irregular-rhythm-notification
Food Log	Nutrition Log	nutrition-log
SpO2 Intraday	Oxygen Saturation	oxygen-saturation
VO2 Max value when the user runs	Run VO2 Max	run-vo2-max
Sedentary activity time series	Sedentary Period	sedentary-period
Sleep	Sleep	sleep
Steps	Steps	steps
Swimming strokes time series	Swim Lengths Data	swim-lengths-data
Activity caloriesOut	Total Calories	total-calories
VO2 Max value	VO2 Max	vo2-max
Weight	Weight	weight

Endpoint and Method Mapping

Fitbit Web API Pattern	Google Health API Pattern
Single-day log, summary, or daily summary requests	dailyRollup with a one-day window
Intraday requests	list method
Time series requests by date or interval	rollup or dailyRollup over a date range
Log list requests	list method
Create or update logs	patch method
Delete logs	batchDelete method
Get profile	users.getProfile and users.getSettings
Update profile	users.updateProfile and users.updateSettings
Get user ID	users.getIdentity
Get devices	users.pairedDevices
Create, delete, or list subscriptions	projects.subscribers.subscriptions methods

Google Health API endpoints use https://health.googleapis.com as the service endpoint. RestoreHealth.app requests should use the smallest approved scope set for each study.

Learn about Google Health API support in RestoreHealth.app