The History API enables your app to perform bulk operations on the fitness store: reading, inserting, and deleting fitness data. Use the History API to:
- Import batch data into Google Fit.
- Read fitness data that was inserted or recorded using other apps.
- Delete data that your app previously stored in the fitness history.
- Disable Google Fit for an app.
To insert fitness data with session metadata, you can use the Sessions API.
Read detailed and aggregate data
To read data from the fitness history, first create a
The data request can specify multiple data types to return, effectively combining
multiple data queries into one call. This example only specifies the
data type. The data request can also indicate whether to return
time-series data points or aggregated data points. This example uses aggregated data points
where each point represents the number of steps walked in a day. For this particular use case,
aggregated data points have two advantages:
- Your app and the fitness store exchange smaller amounts of data.
- Your app does not have to aggregate the data manually.
The following example demonstrates how to obtain the points from a dataset:
Read daily total data
Google Fit also provides simple access to the daily total of a
specified data type. Use the
method to retrieve data type that you specify as of midnight of the current day
on the device's current timezone. For example, pass in the
data type to this method to retrieve the daily total steps. You may pass in
an instananeous data type
that has a respective aggregate daily total. For more information on the
supported data types, see
The system does not require authorization to access the
data type from the
method. This can be useful if you require step data for use in areas where
you are unable to show the permissions panel (for example, Android Wear
watch faces and activities or widget activities). For more information on how
to use this data in a watch face, see
Showing Information in Watch Faces.
To insert data into the fitness history, first create a
Google Fit enables your app to delete fitness data that it inserted into the fitness history.
To delete fitness data from the fitness history, use the
Apps can provide specific sessions or delete all data. Fore more information, see the API