Integrazione di Accedi con Google nell'app Android

Nota: Accedi con Google per Android si basa su una libreria precedente precedente che non dispone di molte nuove funzionalità, ora disponibili nella nuova raccolta, come descritto nella sezione Accedi con un tocco/Registrazione One Services di Google Identity.

Per integrare Accedi con Google nella tua app Android, configura Accedi con Google e aggiungi un pulsante al layout dell'app che avvia la procedura di accesso.

Prima di iniziare

Configura un progetto nella console API di Google e imposta il tuo progetto Android Studio.

Configurare Accedi con Google e l'oggetto GoogleSignInClient

1. Nel metodo onCreate dell'attività di accesso, configura Accedi con Google per richiedere i dati utente richiesti dalla tua app. Ad esempio, per configurare Accedi con Google per richiedere l'ID utente e le informazioni di base del profilo, crea un oggetto GoogleSignInOptions con il parametro DEFAULT_SIGN_IN. Per richiedere anche gli indirizzi email degli utenti, crea l'oggetto GoogleSignInOptions con l'opzione 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();

   Se devi richiedere ambiti aggiuntivi per accedere alle API di Google, specificali con requestScopes. Per garantire un'esperienza utente ottimale, quando esegui l'accesso richiedi solo gli ambiti necessari per il funzionamento minimo dell'app. Richiedi eventuali ambiti aggiuntivi solo quando ti servono, in modo che gli utenti vedano la schermata di consenso nel contesto di un'azione che hanno eseguito. Vedi Richiedere ambiti aggiuntivi.

2. Quindi, anche nel metodo onCreate dell'attività di accesso, crea un oggetto GoogleSignInClient con le opzioni specificate.

   // Build a GoogleSignInClient with the options specified by gso.
   mGoogleSignInClient = GoogleSignIn.getClient(this, gso);

Controllare se un utente ha eseguito l'accesso

Nel metodo onStart della tua attività, controlla se un utente ha già eseguito l'accesso alla tua app con 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);

Se GoogleSignIn.getLastSignedInAccount restituisce un oggetto GoogleSignInAccount (anziché null), l'utente ha già eseguito l'accesso alla tua app con Google. Aggiorna l'interfaccia utente di conseguenza, ad esempio nascondi il pulsante di accesso, lancia l'attività principale o qualsiasi altro elemento appropriato per l'app.

Se GoogleSignIn.getLastSignedInAccount restituisce null, l'utente non ha ancora eseguito l'accesso all'app con Google. Aggiorna la tua UI per visualizzare il pulsante Accedi con Google.

Nota: se devi rilevare modifiche allo stato di autenticazione di un utente che si verificano all'esterno dell'app, ad esempio la revoca del token di accesso o del token ID, o per eseguire l'accesso cross-device, puoi chiamare anche GoogleSignInClient.silentSignIn all'avvio dell'app.

Aggiungi il pulsante Accedi con Google alla tua app

1. Aggiungi SignInButton nel layout della tua applicazione:

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

2. (Facoltativo) Se utilizzi la grafica predefinita del pulsante di accesso anziché fornire le risorse per il pulsante di accesso, puoi personalizzare le dimensioni del pulsante con il metodo setSize.

   // Set the dimensions of the sign-in button.
   SignInButton signInButton = findViewById(R.id.sign_in_button);
   signInButton.setSize(SignInButton.SIZE_STANDARD);
   

3. Nell'attività Android (ad esempio, nel metodo onCreate), registra il OnClickListener del pulsante per accedere all'utente quando fa clic:

   findViewById(R.id.sign_in_button).setOnClickListener(this);
   

Avviare la procedura di accesso

1. Nel metodo onClick dell'attività, gestisci i tocchi con i pulsanti di accesso creando un intent di accesso con il metodo getSignInIntent e iniziando con 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);
   }

   L'avvio dell'intent richiede all'utente di selezionare un Account Google con cui accedere. Se hai richiesto ambiti diversi da profile, email e openid, all'utente viene chiesto di concedere l'accesso alle risorse richieste.

2. Dopo che l'utente ha eseguito l'accesso, puoi ricevere un oggetto GoogleSignInAccount nel metodo onActivityResult dell'attività.

   @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'oggetto GoogleSignInAccount contiene informazioni sull'utente che ha eseguito l'accesso, ad esempio il nome dell'utente.

   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);
       }
   }

   Puoi anche ottenere l'indirizzo email dell'utente con getEmail, l'ID Google dell'utente (per l'uso lato client) con getId e un token ID per l'utente con getIdToken. Se devi passare l'utente che ha eseguito l'accesso a un server di backend, invia il token ID al server di backend e convalidalo sul server.