Le API Google Fit, inclusa l'API REST Google Fit, non saranno più disponibili dopo il 30 giugno 2025. A partire dal 1° maggio 2024, gli sviluppatori non possono registrarsi per utilizzare queste API.

Per istruzioni sull'API o sulla piattaforma verso cui eseguire la migrazione, visita la guida alla migrazione di Connessione Salute. Per un confronto tra Connessione Salute con le API Google Fit e le API web di Fitbit, visita la guida al confronto di Connessione Salute.

Scopri di più su Connessione Salute e su come eseguire l'integrazione con l'API.

Questa pagina è stata tradotta dall'API Cloud Translation.

Ottenere un ID client OAuth 2.0

Panoramica

Per utilizzare Google Fit per Android, è necessario un ID client OAuth 2.0 per le app per Android.

Tutte le app Android sono firmate con un certificato digitale per il quale possiedi la chiave privata. Per ulteriori informazioni sui certificati digitali, consulta la guida Android alla firma delle applicazioni.

Gli ID client OAuth per Android sono collegati a coppie specifiche di certificato/pacchetto. È sufficiente un solo ID per ogni certificato, indipendentemente da quanti utenti hai per l'app.

Per ottenere un ID per la tua app sono necessari diversi passaggi. Questi passaggi sono descritti di seguito.

Trova le informazioni del certificato dell'app.
Crea o modifica un progetto nella console API di Google.
Richiedere un ID client OAuth 2.0.

Trovare le informazioni del certificato dell'app

La chiave API si basa su una breve forma di certificato digitale dell'app, noto come Fingerprint SHA-1. Per visualizzare l'impronta SHA-1 per il tuo certificato, assicurati innanzitutto di utilizzare il certificato corretto. Puoi avere due certificati:

Un certificato di debug: gli strumenti dell'SDK Android generano automaticamente questo certificato quando esegui una build di debug. Utilizza questo certificato solo con le app che stai testando. Non tentare di pubblicare un'app firmata con un certificato di debug. Il certificato di debug è descritto più dettagliatamente nella sezione relativa alla firma in modalità di debug nella documentazione per gli sviluppatori Android.
Un certificato di rilascio: gli strumenti dell'SDK Android generano questo certificato quando esegui una build di release. Puoi generare questo certificato anche utilizzando il programma keytool. Utilizza questo certificato quando vuoi rilasciare la tua app a tutti.

Segui i passaggi riportati di seguito per visualizzare l'impronta SHA-1 di un certificato utilizzando il programma keytool con il parametro -v. Per ulteriori informazioni su Keytool, consulta la documentazione di Oracle.

Certificato di debug

Visualizzazione dell'impronta del certificato di debug

Individua il file dell'archivio chiavi di debug. Il nome del file è debug.keystore e viene creato la prima volta che crei il progetto. Per impostazione predefinita, vengono archiviati nella stessa directory dei file dei dispositivi virtuali Android (AVD):
- macOS e Linux: ~/.android/
- Windows Vista e Windows 7: C:\Users\your_user_name\.android\

Elenca l'impronta SHA-1:

Per Linux o macOS, apri una finestra del terminale e inserisci quanto segue:

keytool -list -v -keystore ~/.android/debug.keystore -alias androiddebugkey -storepass android -keypass android

Per Windows Vista e Windows 7, esegui:

keytool -list -v -keystore "%USERPROFILE%\.android\debug.keystore" -alias androiddebugkey -storepass android -keypass android

Dovresti vedere un output simile al seguente:

Alias name: androiddebugkey
Creation date: Jan 01, 2013
Entry type: PrivateKeyEntry
Certificate chain length: 1
Certificate[1]:
Owner: CN=Android Debug, O=Android, C=US
Issuer: CN=Android Debug, O=Android, C=US
Serial number: 4aa9b300
Valid from: Mon Jan 01 08:04:04 UTC 2013 until: Mon Jan 01 18:04:04 PST 2033
Certificate fingerprints:
     MD5:  AE:9F:95:D0:A6:86:89:BC:A8:70:BA:34:FF:6A:AC:F9
     SHA1: BB:0D:AC:74:D3:21:E1:43:07:71:9B:62:90:AF:A1:66:6E:44:5D:75
     Signature algorithm name: SHA1withRSA
     Version: 3

Certificato di rilascio

È visualizzata l'impronta del certificato di rilascio

Individua il file dell'archivio chiavi del certificato di rilascio. Non esistono località o nomi predefiniti per l'archivio chiavi di release. Se non ne specifichi una quando crei la tua app per la release, la build lascerà .apk non firmata e dovrai firmarla per poterla pubblicare. Per il certificato di rilascio sono necessari anche l'alias del certificato e le password per l'archivio chiavi e il certificato. Puoi elencare gli alias per tutte le chiavi in un archivio chiavi inserendo:
```
keytool -list -keystore your_keystore_name
```
Sostituisci your_keystore_name con il nome e il percorso completo dell'archivio chiavi, compresa l'estensione .keystore. Ti verrà richiesta la password dell'archivio chiavi. Dopodiché keytool mostra tutti gli alias nell'archivio chiavi.
Inserisci quanto segue in un terminale o in un prompt dei comandi:
```
keytool -list -v -keystore your_keystore_name -alias your_alias_name
```
Sostituisci your_keystore_name con il nome e il percorso completo dell'archivio chiavi, compresa l'estensione .keystore. Sostituisci your_alias_name con l'alias assegnato al certificato durante la creazione.

Dovresti vedere un output simile al seguente:

Alias name: <alias_name>
Creation date: Feb 02, 2013
Entry type: PrivateKeyEntry
Certificate chain length: 1
Certificate[1]:
Owner: CN=Android Debug, O=Android, C=US
Issuer: CN=Android Debug, O=Android, C=US
Serial number: 4cc9b300
Valid from: Mon Feb 02 08:01:04 UTC 2013 until: Mon Feb 02 18:05:04 PST 2033
Certificate fingerprints:
    MD5:  AE:9F:95:D0:A6:86:89:BC:A8:70:BA:34:FF:6B:AC:F9
    SHA1: BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:90:AF:A1:66:6E:44:5D:75
    Signature algorithm name: SHA1withRSA
    Version: 3

La riga che inizia con SHA1 contiene l'impronta SHA-1 del certificato. L'impronta è la sequenza di 20 numeri esadecimali a due cifre separati da due punti.

Attenzione: per proteggere l'archivio chiavi e la chiave, non inserire gli argomenti storepass o keypass nella riga di comando, a meno che tu non abbia la certezza della sicurezza del computer. Ad esempio, su un computer pubblico, qualcuno potrebbe consultare la cronologia delle finestre del terminale o l'elenco dei processi in esecuzione, ottenere la password e poi avere accesso in scrittura al certificato di firma. In questo modo, questa persona può modificare o sostituire la tua app con la propria.

Richiedere un ID client OAuth 2.0 nella console API di Google

Segui questi passaggi per creare o modificare un progetto per la tua app nella console API di Google, attivare l'API Fitness e richiedere un ID client OAuth 2.0.

Se vuoi seguire la procedura e attivare automaticamente l'API Fitness, fai clic su

Ottieni un ID client

In alternativa, segui questi passaggi per abilitare l'API Fitness nella console API di Google e ottenere un ID client OAuth 2.0.

Vai alla console API di Google.
Seleziona un progetto o creane uno nuovo. Usa lo stesso progetto per le versioni Android e REST dell'app.
Fai clic su Continua per abilitare l'API Fitness.
Fai clic su Go to credentials (Vai alle credenziali).
Fai clic su Nuove credenziali e seleziona ID client OAuth.
In Tipo di applicazione, seleziona Android.
Nella finestra di dialogo visualizzata, inserisci l'impronta SHA-1 dell'app e il nome del pacchetto. Ad esempio:

BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75

com.example.android.fit-example
Fai clic su Crea. Il nuovo ID client OAuth 2.0 e il tuo nuovo secret per Android vengono visualizzati nell'elenco degli ID del tuo progetto. Un ID client OAuth 2.0 è una stringa di caratteri, simile al seguente:

780816631155-gbvyo1o7r2pn95qc4ei9d61io4uh48hl.apps.googleusercontent.com