Crea nuovi account con un tocco

Se supporti l'accesso con gli Account Google, puoi utilizzare il client accesso One Tap per offrire ai tuoi utenti un'esperienza di creazione dell'account senza problemi che non li allontani mai dal contesto della tua app.

Interfaccia utente di registrazione One Tap

Quando visualizzi la UI di One Tap, agli utenti viene chiesto di creare un nuovo account con la tua app utilizzando uno degli Account Google sul loro dispositivo. Se l'utente sceglie di continuare, ricevi un token ID con le informazioni di base del profilo, ovvero nome, foto del profilo e indirizzo email verificato, che puoi utilizzare per creare il nuovo account.

L'implementazione della creazione di account One Tap è composta da due parti:

  • Integrare il client One Tap nella tua app, come descritto in questa pagina. È quasi uguale all'utilizzo dell'accesso One Tap, ma con alcune differenze nella configurazione.
  • Aggiunta al backend della possibilità di creare account utente da token ID Google, argomento trattato in Utilizzo dei token ID sul backend.

Dove devo utilizzare la registrazione One Tap?

Il punto più efficace per offrire la registrazione One Tap agli utenti è un contesto in cui l'accesso attiverebbe nuove funzionalità. Innanzitutto, prova ad accedere con una credenziale salvata. Se non vengono trovate credenziali salvate, offri di creare un nuovo account per l'utente.

Prima di iniziare

Configura il progetto nella console API di Google e il progetto Android come descritto in Inizia a utilizzare l'accesso One Tap.

1. Configurare il client One Tap

Per configurare il client One Tap per la creazione dell'account:

  • Non attivare le richieste di credenziali della password. (La registrazione One Tap è possibile solo con l'autenticazione basata su token.)

  • Attiva le richieste di token ID Google utilizzando setGoogleIdTokenRequestOptions() e queste impostazioni:

Java

public class YourActivity extends AppCompatActivity {

  // ...

  private SignInClient oneTapClient;
  private BeginSignInRequest signUpRequest;

  @Override
  public void onCreate(@Nullable Bundle savedInstanceState,
                       @Nullable PersistableBundle persistentState) {
      super.onCreate(savedInstanceState, persistentState);

      oneTapClient = Identity.getSignInClient(this);
      signUpRequest = BeginSignInRequest.builder()
              .setGoogleIdTokenRequestOptions(GoogleIdTokenRequestOptions.builder()
                      .setSupported(true)
                      // Your server's client ID, not your Android client ID.
                      .setServerClientId(getString(R.string.your_web_client_id))
                      // Show all accounts on the device.
                      .setFilterByAuthorizedAccounts(false)
                      .build())
              .build();

      // ...
  }
}

Kotlin

class YourActivity : AppCompatActivity() {
    // ...

    private lateinit var oneTapClient: SignInClient
    private lateinit var signUpRequest: BeginSignInRequest

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        oneTapClient = Identity.getSignInClient(this)
        signUpRequest = BeginSignInRequest.builder()
            .setGoogleIdTokenRequestOptions(
                BeginSignInRequest.GoogleIdTokenRequestOptions.builder()
                    .setSupported(true)
                    // Your server's client ID, not your Android client ID.
                    .setServerClientId(getString(R.string.your_web_client_id))
                    // Show all accounts on the device.
                    .setFilterByAuthorizedAccounts(false)
                    .build())
            .build()
        // ...
    }
    // ...
}

2. Monitorare l'annullamento dell'UI di One Tap

Devi tenere traccia se l'utente ha già rifiutato di utilizzare la registrazione One Tap chiudendo la richiesta o toccando al di fuori di essa. Può trattarsi di una semplice proprietà booleana dell'attività. (vedi la sezione Interrompere la visualizzazione dell'interfaccia utente One Tap di seguito).

3. Visualizzare la UI di registrazione One Tap

Se l'utente non ha rifiutato di utilizzare One Tap per creare un nuovo account, chiama il metodo beginSignIn() dell'oggetto client e collega i listener all'Task restituito. Le app in genere eseguono questo passaggio quando una richiesta di accesso One Tap non trova credenziali salvate, ovvero nel listener di errore della richiesta di accesso.

Il client One Tap chiamerà il listener di successo se l'utente ha configurato uno o più Account Google sul dispositivo. Nel listener di successo, ottieni l'intent in attesa dal risultato Task e passalo a startIntentSenderForResult() per avviare l'interfaccia utente One Tap.

Se l'utente non ha Account Google sul dispositivo, il client One Tap chiamerà il listener di errore. In questo caso, non è necessario alcun intervento: puoi semplicemente continuare a presentare l'esperienza di disconnessione dell'app e l'utente può registrarsi con il normale flusso di creazione dell'account.

Java

oneTapClient.beginSignIn(signUpRequest)
        .addOnSuccessListener(this, new OnSuccessListener<BeginSignInResult>() {
            @Override
            public void onSuccess(BeginSignInResult result) {
                try {
                    startIntentSenderForResult(
                            result.getPendingIntent().getIntentSender(), REQ_ONE_TAP,
                            null, 0, 0, 0);
                } catch (IntentSender.SendIntentException e) {
                    Log.e(TAG, "Couldn't start One Tap UI: " + e.getLocalizedMessage());
                }
            }
        })
        .addOnFailureListener(this, new OnFailureListener() {
            @Override
            public void onFailure(@NonNull Exception e) {
                // No Google Accounts found. Just continue presenting the signed-out UI.
                Log.d(TAG, e.getLocalizedMessage());
            }
        });

Kotlin

oneTapClient.beginSignIn(signUpRequest)
    .addOnSuccessListener(this) { result ->
        try {
            startIntentSenderForResult(
                result.pendingIntent.intentSender, REQ_ONE_TAP,
                null, 0, 0, 0)
        } catch (e: IntentSender.SendIntentException) {
            Log.e(TAG, "Couldn't start One Tap UI: ${e.localizedMessage}")
        }
    }
    .addOnFailureListener(this) { e ->
        // No Google Accounts found. Just continue presenting the signed-out UI.
        Log.d(TAG, e.localizedMessage)
    }

4. Gestire la risposta dell'utente

La risposta dell'utente al prompt di registrazione One Tap verrà segnalata alla tua app utilizzando il metodo onActivityResult() dell'attività. Se l'utente ha scelto di creare un account, il risultato sarà un token ID Google. Se l'utente ha rifiutato di registrarsi, chiudendo l'interfaccia utente One Tap o toccando al di fuori, il risultato verrà restituito con il codice RESULT_CANCELED. La tua app deve gestire entrambe le possibilità.

Crea un account con un token ID Google

Se l'utente ha scelto di registrarsi con un Account Google, puoi ottenere un token ID per l'utente passando i dati intent da onActivityResult() al metodo getSignInCredentialFromIntent() del client One Tap. La credenziale avrà una proprietà googleIdToken non nulla.

Utilizza il token ID per creare un account sul backend (vedi Autenticarsi con un backend utilizzando i token ID) e accedere.

La credenziale contiene anche eventuali dettagli aggiuntivi che hai richiesto, ad esempio il numero di telefono verificato dell'account, se disponibile.

Java

public class YourActivity extends AppCompatActivity {

  // ...
  private static final int REQ_ONE_TAP = 2;  // Can be any integer unique to the Activity.
  private boolean showOneTapUI = true;
  // ...

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

      switch (requestCode) {
          case REQ_ONE_TAP:
              try {
                  SignInCredential credential = oneTapClient.getSignInCredentialFromIntent(data);
                  String idToken = credential.getGoogleIdToken();
                  if (idToken !=  null) {
                      // Got an ID token from Google. Use it to authenticate
                      // with your backend.
                      Log.d(TAG, "Got ID token.");
                  }
              } catch (ApiException e) {
                  // ...
              }
              break;
      }
  }
}

Kotlin

class YourActivity : AppCompatActivity() {

    // ...
    private val REQ_ONE_TAP = 2  // Can be any integer unique to the Activity
    private var showOneTapUI = true
    // ...

    override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
        super.onActivityResult(requestCode, resultCode, data)

        when (requestCode) {
             REQ_ONE_TAP -> {
                try {
                    val credential = oneTapClient.getSignInCredentialFromIntent(data)
                    val idToken = credential.googleIdToken
                    when {
                        idToken != null -> {
                            // Got an ID token from Google. Use it to authenticate
                            // with your backend.
                            Log.d(TAG, "Got ID token.")
                        }
                        else -> {
                            // Shouldn't happen.
                            Log.d(TAG, "No ID token!")
                        }
                    }
                } catch (e: ApiException) {
                    // ...
            }
        }
    }
    // ...
}

Interrompere la visualizzazione della UI di Accesso One Tap

Se l'utente ha rifiutato di accedere, la chiamata a getSignInCredentialFromIntent() genererà un ApiException con un codice di stato CommonStatusCodes.CANCELED. In questo caso, devi interrompere temporaneamente la visualizzazione dell'interfaccia utente di accesso One Tap per non infastidire gli utenti con richieste ripetute. L'esempio seguente lo fa impostando una proprietà sull'Activity, che utilizza per determinare se offrire all'utente l'accesso One Tap; tuttavia, potresti anche salvare un valore in SharedPreferences o utilizzare un altro metodo.

È importante implementare la limitazione della frequenza dei prompt di accesso One Tap. In caso contrario, se un utente annulla diverse richieste di seguito, il client One Tap non mostrerà richieste all'utente per le 24 ore successive.

Java

public class YourActivity extends AppCompatActivity {

  // ...
  private static final int REQ_ONE_TAP = 2;  // Can be any integer unique to the Activity.
  private boolean showOneTapUI = true;
  // ...

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

      switch (requestCode) {
          case REQ_ONE_TAP:
              try {
                  // ...
              } catch (ApiException e) {
                  switch (e.getStatusCode()) {
                      case CommonStatusCodes.CANCELED:
                          Log.d(TAG, "One-tap dialog was closed.");
                          // Don't re-prompt the user.
                          showOneTapUI = false;
                          break;
                      case CommonStatusCodes.NETWORK_ERROR:
                          Log.d(TAG, "One-tap encountered a network error.");
                          // Try again or just ignore.
                          break;
                      default:
                          Log.d(TAG, "Couldn't get credential from result."
                                  + e.getLocalizedMessage());
                          break;
                  }
              }
              break;
      }
  }
}

Kotlin

class YourActivity : AppCompatActivity() {

    // ...
    private val REQ_ONE_TAP = 2  // Can be any integer unique to the Activity
    private var showOneTapUI = true
    // ...

    override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
        super.onActivityResult(requestCode, resultCode, data)

        when (requestCode) {
            REQ_ONE_TAP -> {
                try {
                    // ...
                } catch (e: ApiException) {
                    when (e.statusCode) {
                        CommonStatusCodes.CANCELED -> {
                            Log.d(TAG, "One-tap dialog was closed.")
                            // Don't re-prompt the user.
                            showOneTapUI = false
                        }
                        CommonStatusCodes.NETWORK_ERROR -> {
                            Log.d(TAG, "One-tap encountered a network error.")
                            // Try again or just ignore.
                        }
                        else -> {
                            Log.d(TAG, "Couldn't get credential from result." +
                                " (${e.localizedMessage})")
                        }
                    }
                }
            }
        }
    }
    // ...
}

Passaggi successivi

Quando un utente completa il flusso di registrazione One Tap, ricevi un token ID Google, che include alcune informazioni di base del profilo: l'indirizzo email, il nome completo e l'URL dell'immagine del profilo dell'utente. Per molte app, queste informazioni sono sufficienti per autenticare l'utente sul backend e creare un nuovo account.

Se hai bisogno di ulteriori informazioni per completare la creazione dell'account, ad esempio la data di nascita dell'utente, mostra all'utente un flusso di dettagli di registrazione, in cui richiedi queste informazioni aggiuntive. Quindi, inviale al backend per completare la creazione dell'account.