Inizia su Android

Come procurarsi un account Google

Per usare le API Google Fit è necessario un Account Google. Puoi creare un nuovo account oppure usano un account esistente. Consigliamo di creare un account distinto per eseguire test la tua app dal punto di vista dell'utente.

Installa Google Play Services

Scarica la libreria client più recente per Google Play Services in relazione al tuo sviluppo host:

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

Ottenere un ID client OAuth 2.0

Per attivare l'API Fitness, richiedi 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 su come creare un nuovo progetto e configurarlo in Android Studio, consulta Crea un progetto.

Aggiungere la libreria client di Google Play Services

In Android Studio, apri il file build.gradle del 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.2.0")
        implementation("com.google.android.gms:play-services-auth:21.2.0")
}

apply plugin: 'com.android.application'

...

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

In questo modo Gradle scarica automaticamente l'SDK per il fitness quando crea la tua app.

Ottieni le autorizzazioni Android necessarie

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

Ottieni autorizzazioni OAuth

I tipi di dati a cui la tua app può accedere corrispondono ambiti di autorizzazione. Per chiedere per queste autorizzazioni, devi aggiungere i tipi di dati a cui la tua app deve accedere in un FitnessOptions di Cloud Shell. Quando l'app chiede l'utilizzo dei dati di Google Fit di tipi, l'SDK Android controlla automaticamente a quali ambiti appartengono e chiede per l'autorizzazione all'utente.

Crea un client API

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

• SensorsClient: accedi a diverse fonti di dati su salute e benessere provenienti dai sensori hardware nel dispositivo locale e nei dispositivi associati.
• RecordingClient: per la raccolta dei dati dei sensori a basso consumo e sempre attiva in background.
• HistoryClient: consente di inserire, eliminare e leggere i dati storici in Google Fit.
• SessionsClient: crea e gestisci le sessioni di attività utente.
• GoalsClient: consente di leggere gli obiettivi relativi a punti cardio e passi creati dagli utenti in Google Fit.
• ConfigClient: accedi a impostazioni e tipi di dati personalizzati nella piattaforma Google Fit.

Guarda un esempio di come creare un client API Fitness.

Flusso di autorizzazione utente risultante

Di seguito viene mostrato il flusso di autorizzazione risultante degli utenti quando viene richiesta l'autorizzazione:

1. Autorizzazioni Android: gli utenti vedono quali autorizzazioni Android dà accesso alla tua app richiesto prima di scaricarlo. Una volta scaricata, l'app richiede le autorizzazioni di runtime di cui ha bisogno e gli utenti concedono o negano queste autorizzazioni.
2. Controlla e connetti: l'app controlla se le autorizzazioni sono state concessi prima di richiedere l'accesso ad altri tipi di dati.
3. Richiesta ambiti OAuth: Google chiede all'utente di concedere la 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, l'app può consente di accedere ai tipi di dati che appartengono agli ambiti concessi dall'utente per cui disponi dell'autorizzazione di autorizzazione.