Commencer à intégrer Google Sign-In à votre application Android

Avertissement:La fonctionnalité de connexion Google pour Android est obsolète et n'est plus prise en charge. Pour assurer la sécurité et la facilité d'utilisation continues de votre application, migrez vers le Gestionnaire d'identifiants dès aujourd'hui. Le Gestionnaire d'identifiants est compatible avec l'authentification par clé d'accès, mot de passe et identité fédérée (comme Se connecter avec Google), ce qui renforce la sécurité et offre une expérience utilisateur plus cohérente. Pour les développeurs Wear: le Gestionnaire d'identifiants sera compatible avec Wear OS 5.1 et versions ultérieures sur certaines montres. Les développeurs qui prennent activement en charge les appareils Wear OS 3, 4 et 5.0 avec Se connecter avec Google doivent continuer à utiliser Google Sign-In pour Android pour leurs applications Wear. La fonctionnalité Se connecter avec Google sera disponible sur les API Gestionnaire d'identifiants pour ces versions de Wear OS à une date ultérieure.

Avant de pouvoir intégrer Google Sign-In à votre propre application, vous devez configurer un projet dans la console Google APIs et configurer votre projet Android Studio. Les étapes décrites sur cette page vous y aideront. Les étapes suivantes expliquent ensuite comment intégrer Google Sign-In à votre application.

Prérequis

Google Sign-In pour Android présente les exigences suivantes:

• Un appareil Android compatible exécutant Android 6.0 ou version ultérieure et incluant le Google Play Store, ou un émulateur avec un AVD exécutant la plate-forme des API Google basée sur Android 4.2.2 ou version ultérieure et disposant des services Google Play version 15.0.0 ou ultérieure.
• La dernière version du SDK Android, y compris le composant SDK Tools. Le SDK est disponible dans le SDK Manager d'Android d'Android Studio.
• Un projet configuré pour compiler avec Android 6.0 (Marshmallow) ou version ultérieure.

Ce guide est destiné aux utilisateurs d'Android Studio, qui est l'environnement de développement recommandé.

Ajouter les services Google Play

Dans le fichier build.gradle de premier niveau de votre projet, assurez-vous que le dépôt Maven de Google est inclus:

allprojects {
    repositories {
        google()

        // If you're using a version of Gradle lower than 4.1, you must instead use:
        // maven {
        //     url 'https://maven.google.com'
        // }
    }
}

Ensuite, dans le fichier build.gradle au niveau de l'application, déclarez les services Google Play comme dépendance:

apply plugin: 'com.android.application'
    ...

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

Configurer un projet dans la console Google APIs

1. Ouvrez votre projet dans la console API ou créez-en un si vous n'en avez pas déjà un.
2. Sur la page de l'écran d'autorisation OAuth, assurez-vous que toutes les informations sont complètes et exactes.
3. Sur la page "Identifiants", créez un ID client de type Android pour votre application si vous n'en avez pas déjà un. Vous devrez spécifier le nom du package et l'empreinte du certificat SHA-1 de votre application. Pour en savoir plus, consultez la section Authentifier votre client.

Obtenir l'ID client OAuth 2.0 de votre serveur backend

Si votre application s'authentifie avec un serveur backend ou accède aux API Google à partir de votre serveur backend, vous devez obtenir l'ID client OAuth 2.0 qui représente votre serveur backend.

Pour créer un ID client pour votre serveur:

1. Ouvrez votre projet dans la console API.

2. Sur la page "Identifiants", créez un ID client de type application Web. Notez la chaîne d'ID client, que vous devrez transmettre à la méthode requestIdToken ou requestServerAuthCode lorsque vous créerez l'objet GoogleSignInOptions.

Étapes suivantes

Maintenant que vous avez configuré un projet dans la console Google APIs et configuré votre projet Android Studio, vous pouvez intégrer Google Sign-In à votre application.