Cette page a été traduite par l'API Cloud Translation.

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.

Pour intégrer Google Sign-In à votre application Android, configurez Google Sign-In et ajoutez un bouton à la mise en page de votre application qui lance le flux de connexion.

Avant de commencer

Configurez un projet dans la console Google APIs et configurez votre projet Android Studio.

Configurer Google Sign-In et l'objet GoogleSignInClient

Dans la méthode onCreate de votre activité de connexion, configurez Google Sign-In de sorte qu'il demande les données utilisateur requises par votre application. Par exemple, pour configurer Google Sign-In de sorte qu'il demande l'ID et les informations de profil de base des utilisateurs, créez un objet GoogleSignInOptions avec le paramètre DEFAULT_SIGN_IN. Pour demander également les adresses e-mail des utilisateurs, créez l'objet GoogleSignInOptions avec l'option requestEmail.
```
// Configure sign-in to request the user's ID, email address, and basic
// profile. ID and basic profile are included in DEFAULT_SIGN_IN.
GoogleSignInOptions gso = new GoogleSignInOptions.Builder(GoogleSignInOptions.DEFAULT_SIGN_IN)
        .requestEmail()
        .build();
```
Si vous devez demander des champs d'application supplémentaires pour accéder aux API Google, spécifiez-les avec requestScopes. Pour une expérience utilisateur optimale, lors de la connexion, ne demandez que les niveaux d'accès nécessaires au fonctionnement minimal de votre application. Ne demandez des portées supplémentaires que lorsque vous en avez besoin, afin que vos utilisateurs voient l'écran d'autorisation dans le contexte d'une action qu'ils ont effectuée. Consultez la section Demander des champs d'application supplémentaires.
Ensuite, dans la méthode onCreate de votre activité de connexion, créez un objet GoogleSignInClient avec les options que vous avez spécifiées.
```
// Build a GoogleSignInClient with the options specified by gso.
mGoogleSignInClient = GoogleSignIn.getClient(this, gso);
```

Vérifier si un utilisateur connecté existe

Dans la méthode onStart de votre activité, vérifiez si un utilisateur s'est déjà connecté à votre application avec Google.

// Check for existing Google Sign In account, if the user is already signed in
// the GoogleSignInAccount will be non-null.
GoogleSignInAccount account = GoogleSignIn.getLastSignedInAccount(this);
updateUI(account);

Si GoogleSignIn.getLastSignedInAccount renvoie un objet GoogleSignInAccount (plutôt que null), l'utilisateur s'est déjà connecté à votre application avec Google. Mettez à jour votre UI en conséquence, c'est-à-dire en masquant le bouton de connexion, en lançant votre activité principale ou en effectuant toute autre action appropriée pour votre application.

Si GoogleSignIn.getLastSignedInAccount renvoie null, l'utilisateur ne s'est pas encore connecté à votre application avec Google. Mettez à jour votre UI pour afficher le bouton de connexion Google.

Ajouter le bouton Google Sign-In à votre application

Bouton de connexion Google standard Ajoutez le SignInButton à la mise en page de votre application:

<com.google.android.gms.common.SignInButton
 android:id="@+id/sign_in_button"
 android:layout_width="wrap_content"
 android:layout_height="wrap_content" />

Facultatif: Si vous utilisez l'image du bouton de connexion par défaut au lieu de fournir vos propres composants de bouton de connexion, vous pouvez personnaliser la taille du bouton à l'aide de la méthode setSize.
```
// Set the dimensions of the sign-in button.
SignInButton signInButton = findViewById(R.id.sign_in_button);
signInButton.setSize(SignInButton.SIZE_STANDARD);
```
Dans l'activité Android (par exemple, dans la méthode onCreate), enregistrez l'OnClickListener de votre bouton pour connecter l'utilisateur lorsqu'il clique dessus:
```
findViewById(R.id.sign_in_button).setOnClickListener(this);
```

Démarrer le flux de connexion

Dans la méthode onClick de l'activité, gérez les appuis sur le bouton de connexion en créant un intent de connexion avec la méthode getSignInIntent et en démarrant l'intent avec startActivityForResult.
```
@Override
public void onClick(View v) {
    switch (v.getId()) {
        case R.id.sign_in_button:
            signIn();
            break;
        // ...
    }
}
```
```
private void signIn() {
    Intent signInIntent = mGoogleSignInClient.getSignInIntent();
    startActivityForResult(signInIntent, RC_SIGN_IN);
}
```
Le démarrage de l'intent invite l'utilisateur à sélectionner un compte Google avec lequel se connecter. Si vous avez demandé des champs d'application autres que profile, email et openid, l'utilisateur est également invité à accorder l'accès aux ressources demandées.

Une fois l'utilisateur connecté, vous pouvez obtenir un objet GoogleSignInAccount pour l'utilisateur dans la méthode onActivityResult de l'activité.

@Override
public void onActivityResult(int requestCode, int resultCode, Intent data) {
    super.onActivityResult(requestCode, resultCode, data);

    // Result returned from launching the Intent from GoogleSignInClient.getSignInIntent(...);
    if (requestCode == RC_SIGN_IN) {
        // The Task returned from this call is always completed, no need to attach
        // a listener.
        Task<GoogleSignInAccount> task = GoogleSignIn.getSignedInAccountFromIntent(data);
        handleSignInResult(task);
    }
}

L'objet GoogleSignInAccount contient des informations sur l'utilisateur connecté, comme son nom.

private void handleSignInResult(Task<GoogleSignInAccount> completedTask) {
    try {
        GoogleSignInAccount account = completedTask.getResult(ApiException.class);

        // Signed in successfully, show authenticated UI.
        updateUI(account);
    } catch (ApiException e) {
        // The ApiException status code indicates the detailed failure reason.
        // Please refer to the GoogleSignInStatusCodes class reference for more information.
        Log.w(TAG, "signInResult:failed code=" + e.getStatusCode());
        updateUI(null);
    }
}

Vous pouvez également obtenir l'adresse e-mail de l'utilisateur avec getEmail, son ID Google (pour une utilisation côté client) avec getId et un jeton d'identification pour l'utilisateur avec getIdToken. Si vous devez transmettre l'utilisateur actuellement connecté à un serveur backend, envoyez le jeton d'ID à votre serveur backend et validez le jeton sur le serveur.