Le API Google Fit, inclusa l'API REST di Google Fit, verranno ritirate nel 2026. A partire dal 1° maggio 2024, gli sviluppatori non possono registrarsi per utilizzare queste API.

Ti consigliamo di eseguire la migrazione all'API Google Health per le integrazioni basate sul cloud o a Health Connect per il monitoraggio dei passi e le app per Android mobile-first. Per istruzioni sull'API o sulla piattaforma a cui eseguire la migrazione, consulta la guida alla migrazione di Fit.

Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

Inizia su Android

Questa guida spiega come iniziare lo sviluppo con Google Fit su Android.

Configurazione

Prima di iniziare a creare l'app, completa i passaggi descritti nelle sezioni seguenti.

Crea un Account Google

Per utilizzare le API Google Fit, devi disporre di un Account Google. Puoi creare un nuovo account o utilizzarne uno esistente. Ti consigliamo di creare un account separato per testare la tua app dal punto di vista di un utente.

Installa Google Play Services

Scarica la libreria client più recente per Google Play Services sul tuo host di sviluppo:

Apri SDK Manager Android.
In Strumenti SDK, trova Google Play Services.
Se lo stato di questi pacchetti non è Installato, selezionali entrambi e fai clic su Installa pacchetti.

Ottieni un ID client OAuth 2.0

Per abilitare l'API Fitness, ottieni un ID client OAuth 2.0.

Crea e configura il progetto

Per creare un'app con l'API Fitness, ti consigliamo di utilizzare l'ambiente di sviluppo Android Studio. Per i dettagli su come creare un nuovo progetto e configurarlo in Android Studio, consulta Crea un progetto.

Aggiungi la libreria client di Google Play Services

In Android Studio, apri il file build.gradle del tuo modulo e aggiungi la libreria client di Google Play Services come dipendenza:

Kotlin DSL

plugin {
    id("com.android.application")
}

...

dependencies {
        implementation("com.google.android.gms:play-services-fitness:21.3.0")
        implementation("com.google.android.gms:play-services-auth:22.0.0")
}

DSL Groovy

apply plugin: 'com.android.application'

...

dependencies {
    implementation 'com.google.android.gms:play-services-fitness:21.3.0'
    implementation 'com.google.android.gms:play-services-auth:22.0.0'
}

In questo modo, Gradle scarica automaticamente l'SDK Fitness quando crea la tua app.

Crea e testa la tua app

Dopo aver completato i passaggi di configurazione, puoi iniziare a creare la tua app. Per iniziare, scopri i tipi di dati che la tua app può archiviare e leggere. Scopri di più sull'utilizzo dei dati in Google Fit.

Ottieni le autorizzazioni Android necessarie

Per leggere e scrivere alcuni tipi di dati, l'app deve richiedere le autorizzazioni Android.

Ottieni le autorizzazioni OAuth

I tipi di dati a cui la tua app è autorizzata ad accedere corrispondono agli ambiti di autorizzazione. Per richiedere queste autorizzazioni, devi aggiungere i tipi di dati a cui l'app deve accedere in un'istanza FitnessOptions. Quando la tua app chiede di utilizzare uno dei tipi di dati di Google Fit, l'SDK Android controlla automaticamente a quali ambiti appartengono e chiede all'utente l'autorizzazione per questi ambiti.

Crea un client API

Crea un client API e aggiungi i tipi di dati a cui la tua app deve accedere per scrivere o leggere i dati. Sono disponibili i seguenti endpoint:

SensorsClient: accedi a diverse origini di dati su salute e benessere dai sensori hardware del dispositivo locale e dei dispositivi complementari.
RecordingClient: per la raccolta in background dei dati dei sensori a basso consumo e sempre attiva.
HistoryClient: inserisci, elimina e leggi i dati storici in Google Fit.
SessionsClient: crea e gestisci le sessioni dell'attività utente.
GoalsClient: legge gli obiettivi di Punti cardio e passi creati dagli utenti in Google Fit.
ConfigClient: accedi a tipi di dati e impostazioni personalizzati nella piattaforma Google Fit.

Guarda un esempio di come creare un client API Fitness.

Flusso di autorizzazione utente risultante

Di seguito è riportato il flusso di autorizzazione risultante che gli utenti sperimentano quando vengono richieste le autorizzazioni:

**Figura 1.**Il flusso di autorizzazione per gli utenti.

Autorizzazioni Android: gli utenti vedono quali autorizzazioni Android sono state richieste dalla tua app prima di scaricarla. Dopo aver scaricato l'app, questa richiede le autorizzazioni di runtime necessarie e gli utenti le concedono o le negano.
Controlla e connetti: l'app verifica se le autorizzazioni sono state concesse prima di richiedere l'accesso ad altri tipi di dati.
Richiesta di ambiti OAuth: Google chiede all'utente di concedere alla tua app gli ambiti OAuth necessari per i tipi di dati a cui vuole accedere.
Accesso applicato: dopo che l'utente ha concesso le autorizzazioni, la tua app può accedere ai tipi di dati che appartengono agli ambiti per cui l'utente ha concesso l'autorizzazione.

Richiedi la verifica

Dopo aver creato e testato l'app, devi richiedere la verifica con diversi livelli di giustificazione necessari per gli ambiti sensibili e con restrizioni.