Ottenere un ID client OAuth 2.0

Panoramica

Per usare Google Fit per Android, devi avere un ID client OAuth 2.0 per App per Android

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

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

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

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

Trovare le informazioni del certificato dell'app

La chiave API è basata su una forma breve del certificato digitale della tua app, nota come impronta SHA-1. Per visualizzare l'algoritmo SHA-1 l'impronta digitale per il certificato, assicurati prima di usare certificato. Puoi avere due certificati:

  • Un certificato di debug. Gli strumenti dell'SDK Android generano automaticamente questo certificato quando esegui una build di debug. Usa solo questo 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 in Firma in modalità di debug nella documentazione per gli sviluppatori di Android.
  • Un certificato di rilascio. Gli strumenti dell'SDK Android generano questo certificato quando esegui una build di release. Puoi anche generare utilizzando il programma keytool. Utilizza questo certificato quando puoi rendere disponibile la tua app al mondo.

Segui questi passaggi per visualizzare l'impronta SHA-1 di un certificato utilizzando Il programma keytool con il parametro -v. Per maggiori informazioni informazioni su Keytool, consulta 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 progetto. Per impostazione predefinita, viene archiviata nella stessa directory di Android File per dispositivi virtuali (VMD):

    • 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 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

  1. Individua il file dell'archivio chiavi del certificato di rilascio. Non esiste un valore predefinito la posizione o il nome dell'archivio chiavi di release. Se non ne specifichi uno quando crei la tua app per la release, la build lascerà .apk non è stato firmato e dovrai firmarlo prima di poter e pubblicarla. Per il certificato di rilascio, è necessaria anche la l'alias e le password dell'archivio chiavi e del certificato. Puoi elencare gli alias di tutte le chiavi in un archivio chiavi inserendo:

    keytool -list -keystore your_keystore_name

    Sostituisci your_keystore_name con il nome completo percorso e nome dell'archivio chiavi, incluso .keystore . Viene richiesta la password dell'archivio chiavi. Poi keytool visualizza tutti gli alias nell'archivio chiavi.

  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 completo percorso e nome dell'archivio chiavi, incluso .keystore . Sostituisci your_alias_name con l'alias associato assegnato al certificato al momento della 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'algoritmo SHA-1 del certificato impronta. L'impronta è la sequenza di 20 cifre esadecimali a due cifre numeri separati da due punti.

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 nel Console API di Google, abilitare l'API Fitness e richiedere un ID client OAuth 2.0.

Se desideri seguire la procedura guidata e attivare il API Fitness, fai clic

Ottenere un ID client

In alternativa, segui questa procedura per abilitare l'API Fitness nel nella console API di Google e ottieni un ID client OAuth 2.0.

  1. Vai alla pagina Console API di Google.
  2. Seleziona un progetto o creane uno nuovo. Utilizza lo stesso progetto per Android e REST dell'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 pacchetto dell'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 tuo nuovo ID client OAuth 2.0 e il tuo nuovo segreto Android sono visualizzati in l'elenco di ID per il tuo progetto. Un ID client OAuth 2.0 è una stringa caratteri, in questo modo:

    780816631155-gbvyo1o7r2pn95qc4ei9d61io4uh48hl.apps.googleusercontent.com