Inizia su Android

Come procurarsi un account Google

Per utilizzare le API Google Fit, è necessario un Account Google. Puoi creare un nuovo account o utilizzare un account esistente. Potresti voler 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 sull'host di sviluppo:

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

Recuperare un ID client OAuth 2.0

Per attivare 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 informazioni dettagliate su come creare un nuovo progetto e configurarlo in Android Studio, consulta Creare un progetto.

Aggiungere la libreria client di Google Play Services

In Android Studio, apri il file build.gradle per il tuo modulo e aggiungi la libreria client dei servizi Google Play 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.4.0")
}

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.4.0'
}

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

Ottenere le autorizzazioni Android necessarie

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

Ottenere le autorizzazioni OAuth

I tipi di dati a cui la tua app ha l'autorizzazione di accedere corrispondono agli ambiti di autorizzazione. Per richiedere queste autorizzazioni, devi aggiungere a un'FitnessOptions istanza i tipi di dati a cui la tua app deve accedere. 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.

Creare 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 provenienti dai sensori hardware del dispositivo locale e dei dispositivi complementari.
• 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 a tipi di dati e impostazioni personalizzati nella piattaforma Google Fit.

Visualizza un esempio di come creare un client API Fitness.

Flusso di autorizzazione utente risultante

Di seguito viene mostrato 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 prima di scaricarla. Dopo aver scaricato l'app, questa richiede le autorizzazioni di runtime necessarie e gli utenti concedono o negano queste autorizzazioni.
2. Controlla e connetti: la tua app verifica 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 i quali l'utente ha concesso l'autorizzazione.