Obtenir un ID client OAuth 2.0

Présentation

Afin d'utiliser Google Fit pour Android, vous avez besoin d'un ID client OAuth 2.0 pour applications Android.

Toutes les applications Android sont signées avec un certificat numérique dont vous détenez la clé privée. Consultez le guide Android sur la signature de vos applications. pour en savoir plus sur les certificats numériques.

Les ID client OAuth Android sont associés à des paires de certificats/packages spécifiques. Vous n'avez besoin que d'un seul ID pour chaque certificat, quel que soit le nombre d'utilisateurs de l'application.

Obtenir un ID pour votre application nécessite plusieurs étapes. Ces étapes sont décrites ci-dessous.

  1. Recherchez les informations sur le certificat de votre application.
  2. Créez ou modifiez un projet dans la console Google APIs.
  3. Demandez un ID client OAuth 2.0.

Rechercher des informations sur le certificat de votre application

La clé API est basée sur une version abrégée du certificat numérique de l'application, appelée empreinte SHA-1. Pour afficher l'empreinte SHA-1 de votre certificat, assurez-vous d'abord d'utiliser le bon certificat. Il existe deux types de certificats :

  • Un certificat de débogage : les outils Android SDK génèrent automatiquement ce certificat lorsque vous exécutez une version de débogage. Utilisez ce certificat uniquement avec les applications que vous testez. N'essayez pas de publier une application signée avec un certificat de débogage. Le certificat de débogage est décrit plus en détail dans la section Connexion en mode débogage de la documentation pour les développeurs Android.
  • Un certificat de version : le SDK Tools pour Android génère ce certificat lorsque vous créez une build. Vous pouvez également générer ce certificat à l'aide du programme keytool. Utilisez ce certificat lorsque vous êtes prêt à proposer une version publique de l'application.

Procédez comme suit pour afficher l'empreinte numérique SHA-1 d'un certificat à l'aide du programme keytool avec le paramètre -v. Pour plus d'informations sur Keytool, consultez la documentation Oracle.

Certificat de débogage

Afficher l'empreinte du certificat de débogage

  1. Recherchez le fichier keystore de débogage. Le fichier est nommé debug.keystore. Il est créé lorsque vous compilez votre projet pour la première fois. Par défaut, il est stocké dans le même répertoire que vos fichiers AVD (Android Virtual Device) :

    • macOS et Linux : ~/.android/
    • Windows Vista et Windows 7 : C:\Users\your_user_name\.android\
  2. Affichez l'empreinte SHA-1 :

    • Pour Linux ou macOS, ouvrez une fenêtre sur le terminal et procédez comme suit :

      keytool -list -v -keystore ~/.android/debug.keystore -alias androiddebugkey -storepass android -keypass android
    • Pour Windows Vista et Windows 7, exécutez la commande suivante :

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

Le résultat doit ressembler à ce qui suit :

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
Certificat de version

Afficher l'empreinte du certificat de version

  1. Recherchez le fichier keystore du certificat de version. Il n'existe pas d'emplacement ou de nom par défaut pour le keystore de version. Si vous n'en spécifiez aucun lorsque vous compilez une version de votre application, le fichier .apk ne sera pas signé et vous devrez le signer avant la publication. Pour le certificat de version, vous avez également besoin de l'alias du certificat et des mots de passe du keystore et du certificat. Vous pouvez afficher les alias de toutes les clés d'un keystore en saisissant :

    keytool -list -keystore your_keystore_name

    Remplacez your_keystore_name par le chemin d'accès complet et le nom du keystore, y compris l'extension .keystore. Vous êtes alors invité à saisir le mot de passe du keystore. L'outil keytool affiche alors tous les alias du keystore.

  2. Saisissez la commande suivante sur un terminal ou dans une invite de commande :

    keytool -list -v -keystore your_keystore_name -alias your_alias_name

    Remplacez your_keystore_name par le chemin d'accès complet et le nom du keystore, y compris l'extension .keystore. Remplacez your_alias_name par l'alias que vous avez attribué au certificat lorsque vous l'avez créé.

Le résultat doit ressembler à ce qui suit :

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 ligne commençant par SHA1 contient l'empreinte SHA-1 du certificat. L'empreinte correspond à la séquence de 20 nombres hexadécimaux à deux chiffres séparés par un deux-points.

Demander un ID client OAuth 2.0 dans la console Google APIs

Suivez ces étapes pour créer ou modifier un projet pour votre application dans la console Google APIs, activer l'API Fitness et demander un ID client OAuth 2.0.

Si vous souhaitez être guidé tout au long du processus et activer automatiquement l'API Fitness, cliquez sur

Obtenir un ID client

Vous pouvez également suivre ces étapes pour activer Fitness API dans le la console Google APIs et obtenez un ID client OAuth 2.0.

  1. Accédez à la console Google APIs.
  2. Sélectionnez un projet ou créez-en un. Utilisez le même projet pour les versions Android et REST de votre application.
  3. Cliquez sur Continuer pour activer l'API Fitness.
  4. Cliquez sur Passer à l'étape "Identifiants".
  5. Cliquez sur Nouveaux identifiants, puis sélectionnez ID client OAuth.
  6. Sous Type d'application, sélectionnez Android.
  7. Dans la boîte de dialogue qui s'affiche, saisissez l'empreinte SHA-1 et le package de votre application. son nom. Exemple :

    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. Cliquez sur Créer. Votre nouvel ID client OAuth 2.0 et votre secret Android OAuth 2.0 apparaissent dans la liste des ID de votre projet. Un ID client OAuth 2.0 est une chaîne des caractères, comme ceci:

    780816631155-gbvyo1o7r2pn95qc4ei9d61io4uh48hl.apps.googleusercontent.com