We're making some changes to the Google Fit APIs. Learn about how these changes might affect your app. Read our new policy.

Create a Fitness API client

This example shows how to create a Fitness API client.

Create the API client as follows:

  1. Create a FitnessOptions instance, declaring the data types and access type (read and/or write) your app needs:

    val fitnessOptions = FitnessOptions.builder()
        .addDataType(DataType.TYPE_STEP_COUNT_DELTA, FitnessOptions.ACCESS_READ)
        .addDataType(DataType.AGGREGATE_STEP_COUNT_DELTA, FitnessOptions.ACCESS_READ)
  2. Get an instance of the Account object to use with the API:

    val account = GoogleSignIn.getAccountForExtension(this, fitnessOptions)
  3. Check if the user has previously granted the necessary data access, and if not, initiate the authorization flow:

    if (!GoogleSignIn.hasPermissions(account, fitnessOptions)) {
            this, // your activity
    } else {
  4. If the authorization flow is required, handle the user's response:

    override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
        super.onActivityResult(requestCode, resultCode, data)
        when (resultCode) {
            Activity.RESULT_OK -> when (requestCode) {
                GOOGLE_FIT_PERMISSIONS_REQUEST_CODE -> accessGoogleFit()
                else -> {
                    // Result wasn't from Google Fit
            else -> {
                // Permission not granted
  5. After the user has authorized access to the data requested, create a fitness client (for example, a HistoryClient to read and/or write historic fitness data) based on your app's purpose and needs:

    private fun accessGoogleFit() {
        val end = LocalDateTime.now()
        val start = end.minusYears(1)
        val endSeconds = end.atZone(ZoneId.systemDefault()).toEpochSecond()
        val startSeconds = start.atZone(ZoneId.systemDefault()).toEpochSecond()
        val readRequest = DataReadRequest.Builder()
            .setTimeRange(startSeconds, endSeconds, TimeUnit.SECONDS)
            .bucketByTime(1, TimeUnit.DAYS)
        val account = GoogleSignIn.getAccountForExtension(this, fitnessOptions)
        Fitness.getHistoryClient(this, account)
            .addOnSuccessListener({ response ->
                // Use response data here
                Log.i(TAG, "OnSuccess()")
            .addOnFailureListener({ e -> Log.d(TAG, "OnFailure()", e) })