Inizia su Android

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 l'app dal punto di vista dell'utente.

Installa Google Play Services

Scarica la libreria client più recente per Google Play Services sull'host di sviluppo:

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

Ottieni un ID client OAuth 2.0

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

Crea e configura il progetto

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

Aggiungi la libreria client di Google Play Services

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

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:21.5.1")
}

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:21.5.1'
}

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

Ottieni le autorizzazioni Android necessarie

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

Ottieni le autorizzazioni OAuth

I tipi di dati a cui la tua app ha l'autorizzazione ad accedere corrispondono a ambiti di autorizzazione. Per richiedere queste autorizzazioni, devi aggiungere i tipi di dati a cui la tua app deve accedere in un'FitnessOptions istanza. 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 associati.
• RecordingClient: per la raccolta in background a basso consumo energetico e sempre attiva dei dati dei sensori.
• HistoryClient: inserisci, elimina e leggi i dati storici in Google Fit.
• SessionsClient: crea e gestisci le sessioni di attività utente.
• GoalsClient: leggi gli obiettivi Punti cardio e Passi creati dagli utenti in Google Fit.
• ConfigClient: accedi ai tipi di dati e alle impostazioni personalizzati nella piattaforma Google Fit.

Consulta 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:

1. Autorizzazioni Android: gli utenti vedono le autorizzazioni Android richieste dalla tua app ha richiesto prima di scaricarla. Dopo aver scaricato l'app, questa richiede le autorizzazioni di runtime necessarie e gli utenti le concedono o le negano queste autorizzazioni.
2. Controlla e connetti: la tua app controlla se le autorizzazioni sono state concesse prima di richiedere l'accesso ad altri tipi di dati.
3. 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.
4. 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.