Ottenere un ID client OAuth 2.0

Panoramica

Per utilizzare Google Fit per Android, devi disporre di un ID client OAuth 2.0 per le app per Android.

Tutte le app per Android sono firmate con un certificato digitale di cui possiedi la chiave privata. Per saperne di più sui certificati digitali, consulta la guida di Android alla firma delle applicazioni.

Gli ID client OAuth per Android sono collegati a coppie di certificati/pacchetti specifiche. Devi disporre di un solo ID per ogni certificato, indipendentemente dal numero di utenti dell'app.

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

  1. Trova le informazioni sul certificato della tua app.
  2. Crea o modifica un progetto nella console API di Google.
  3. Richiedi un ID client OAuth 2.0.

Trova le informazioni sul certificato della tua app

La chiave API si basa su una forma abbreviata del certificato digitale della tua app, nota come impronta SHA-1. Per visualizzare l'impronta digitale SHA-1 del certificato, assicurati innanzitutto di utilizzare il certificato corretto. Puoi avere due certificati:

  • Un certificato di debug: gli strumenti SDK Android generano questo certificato automaticamente 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 in modo più dettagliato nella sezione Firma in modalità di debug della documentazione per lo sviluppo Android.
  • Un certificato di release: gli Strumenti SDK Android generano questo certificato quando crei una build di release. Puoi anche generare questo certificato utilizzando il programma keytool. Utilizza questo certificato quando vuoi rilasciare la tua app al pubblico.

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

Certificato di debug

Visualizzazione dell'impronta del certificato di debug

  1. 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, viene archiviato nella stessa directory dei file Android Virtual Device (AVD):

    • macOS e Linux: ~/.android/
    • Windows Vista e Windows 7: C:\Users\your_user_name\.android\
  2. 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 visualizzare 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

  1. Individua il file dell'archivio chiavi del certificato di release. Non esiste una località o un nome predefinito per il keystore di release. Se non ne specifichi uno quando crei la tua app per il rilascio, la build lascerà il tuo .apk non firmato e dovrai firmarlo prima di poterlo pubblicare. Per il certificato di release, devi anche avere l'alias del certificato e le password per il keystore e il certificato. Puoi elencare gli alias di tutte le chiavi in un keystore 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à chiesta la password dell'archivio chiavi. Quindi, keytool visualizza tutti gli alias nel keystore.

  2. Inserisci quanto segue in un terminale o 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 visualizzare 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 digitale SHA-1 del certificato. La fingerprint è la sequenza di 20 numeri esadecimali a due cifre separati da due punti.

Richiedi 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 ricevere assistenza durante la procedura e attivare l'API Fitness automaticamente, fai clic su

Ottieni un ID client

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

  1. Vai alla console API di Google.
  2. Seleziona un progetto oppure creane uno nuovo. Utilizza lo stesso progetto per le versioni Android e REST della tua app.
  3. Fai clic su Continua per abilitare l'API Fitness.
  4. Fai clic su Vai alle credenziali.
  5. Fai clic su Nuove credenziali, quindi seleziona ID client OAuth.
  6. In Tipo di applicazione, seleziona Android.
  7. Nella finestra di dialogo visualizzata, inserisci l'impronta SHA-1 e il nome del pacchetto della tua app. 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

  8. Fai clic su Crea. Il nuovo ID client Android OAuth 2.0 e il secret vengono visualizzati nell'elenco degli ID del tuo progetto. Un ID client OAuth 2.0 è una stringa di caratteri, simile a questa:

    780816631155-gbvyo1o7r2pn95qc4ei9d61io4uh48hl.apps.googleusercontent.com