Wenn Sie die Anmeldung mit Google-Konten unterstützen, können Sie die Anmeldung über One Tap verwenden um Ihren Nutzern eine reibungslose Kontoerstellung zu bieten, werden sie nie aus dem Kontext Ihrer App genommen.
Wenn die One Tap-Benutzeroberfläche angezeigt wird, werden die Nutzer aufgefordert, ein neues Konto mit Ihre App über eines der Google-Konten auf ihrem Gerät nutzen. Wenn der Nutzer erhalten Sie ein ID-Token mit grundlegenden Profilinformationen, Ihr Profilbild und die bestätigte E-Mail-Adresse, mit der Sie um das neue Konto zu erstellen.
Die Implementierung der One Tap-Kontoerstellung besteht aus zwei Teilen:
- Integrieren des One Tap-Clients in Ihre App, wie auf dieser Seite beschrieben. Dies entspricht größtenteils der Anmeldung über One Tap, Konfiguration.
- Die Möglichkeit, Nutzerkonten über die Google-ID zu erstellen, wird zu Ihrem Backend hinzugefügt. Tokens, die unter ID-Tokens auf dem Back-End verwenden erläutert werden.
Wo sollte ich die One Tap-Registrierung nutzen?
Die One Tap-Registrierung ist am wirkungsvollsten, wenn werden durch eine Anmeldung neue Funktionen aktiviert. Versuchen Sie zuerst, den Nutzer mit einem Anmeldedaten gespeichert werden. Wenn keine gespeicherten Anmeldedaten gefunden werden, bieten Sie an, neue zu erstellen. für den Nutzer.
Hinweis
Richten Sie Ihr Projekt in der Google APIs-Konsole und Ihr Android-Projekt wie beschrieben ein. Weitere Informationen finden Sie unter Erste Schritte mit der One Tap-Anmeldung.
1. One Tap-Client konfigurieren
So konfigurieren Sie den One Tap-Client für die Kontoerstellung:
- Aktivieren Sie keine Anfragen für Passwortanmeldedaten. (Die Registrierung ist nur mit nur einmal tippen möglich. mit tokenbasierter Authentifizierung.)
Aktivieren Sie Google-ID-Tokenanfragen mit
setGoogleIdTokenRequestOptions()und diese Einstellungen:- Legen Sie als Server-Client-ID die ID fest, die Sie in den Google APIs erstellt haben. Konsolen aus. Dies ist die Client-ID deines Servers, Ihre Android-Client-ID.
- Konfigurieren Sie den Client so, dass alle Google-Konten auf dem Gerät angezeigt werden, nicht nach autorisierten Konten filtern.
- Optional können Sie auch die bestätigte Telefonnummer anfordern. Nummer für das Konto.
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. Informationen zur Kündigung der One Tap-Benutzeroberfläche
Prüfen Sie, ob der Nutzer One Tap bereits abgelehnt hat. schließen Sie die Aufforderung oder tippen Sie außerhalb der Aufforderung, um sich zu registrieren. Dies kann als eine boolesche Eigenschaft deiner Aktivität. Weitere Informationen finden Sie unter One Tap nicht mehr anzeigen UI (siehe unten).
3. Benutzeroberfläche für die Anmeldung über One Tap aufrufen
Wenn der Nutzer die Erstellung eines neuen Kontos über One Tap nicht abgelehnt hat, rufen Sie den
beginSignIn()-Methode des Clientobjekts hinzufügen und dem Task-Element Listener hinzufügen
Rücksendungen. Bei Apps wird dieser Schritt normalerweise ausgeführt, wenn bei einer One Tap-Anmeldeanfrage keine
alle gespeicherten Anmeldedaten, d. h. im Fehler-Listener des Anmeldevorgangs
Der One Tap-Client ruft den Erfolgs-Listener auf, wenn der Nutzer mindestens einen
Google-Konten, die auf dem Gerät eingerichtet sind. Rufen Sie im Erfolgs-Listener den Status "Pending"
Intent aus dem Task-Ergebnis aus und übergeben ihn an startIntentSenderForResult()
um die One Tap-Benutzeroberfläche zu starten.
Wenn der Nutzer keine Google-Konten auf dem Gerät hat, ruft den Fehler-Listener auf. In diesem Fall müssen Sie nichts weiter tun. Sie können einfach weiterhin die App ohne Anmeldung präsentieren. mit dem normalen Kontoerstellungsprozess anmelden.
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. Die Antwort des Nutzers verarbeiten
Die Antwort des Nutzers auf die Aufforderung zur Registrierung über One Tap wird an Ihre App gemeldet
mithilfe der onActivityResult()-Methode deiner Aktivität. Wenn der Nutzer ein
Konto ist das Ergebnis ein Google-ID-Token. Wenn der Nutzer die Registrierung abgelehnt hat,
entweder durch Schließen der One Tap-Benutzeroberfläche oder durch Tippen außerhalb der Benutzeroberfläche, wird das Ergebnis
mit dem Code RESULT_CANCELED. Ihre App muss beide Möglichkeiten unterstützen.
Konto mit einem Google-ID-Token erstellen
Wenn sich der Nutzer mit einem Google-Konto registriert hat, können Sie ein ID-Token für
durch Übergabe der Intent-Daten von onActivityResult() an One Tap
getSignInCredentialFromIntent()-Methode des Clients. Die Anmeldedaten haben Folgendes:
googleIdToken-Property ungleich null.
Verwenden Sie das ID-Token, um ein Konto in Ihrem Backend zu erstellen (siehe Authentifizierung mit einem Back-End mit ID-Tokens) und melden Sie den Nutzer an.
Der Berechtigungsnachweis enthält auch alle von Ihnen angeforderten zusätzlichen Informationen, z. B.: die bestätigte Telefonnummer des Kontos, falls verfügbar.
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) { // ... } } } // ... }
One Tap-Benutzeroberfläche nicht mehr anzeigen
Wenn der Nutzer die Anmeldung abgelehnt hat, wird getSignInCredentialFromIntent() angerufen
gibt ApiException mit dem Statuscode CommonStatusCodes.CANCELED aus.
In diesem Fall sollten Sie die One Tap-Anmeldebenutzeroberfläche vorübergehend nicht mehr anzeigen.
damit die Nutzer nicht durch wiederholte Aufforderungen verärgert werden. Im folgenden Beispiel
legt eine Eigenschaft für die Aktivität fest, mit der sie
Feststellen, ob dem Nutzer eine One Tap-Anmeldung angeboten wird Sie könnten aber auch
einen Wert unter SharedPreferences speichern oder eine andere Methode verwenden.
Es ist wichtig, dass Sie Ihre eigene Ratenbegrenzung für Aufforderungen zur Anmeldung über One Tap implementieren. Wenn das nicht der Fall ist und ein Nutzer mehrere Aufforderungen hintereinander abbricht, wird der One Tap-Client den Nutzer in den nächsten 24 Stunden nicht mehr auffordert.
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})") } } } } } } // ... }
Nächste Schritte
Wenn ein Nutzer die One Tap-Registrierung abgeschlossen hat, erhalten Sie ein Google-ID-Token, das einige grundlegende Profilinformationen enthält: die E-Mail-Adresse, den vollständigen Namen, und die URL des Profilbilds. Bei vielen Apps reichen diese Informationen aus, Nutzer am Backend authentifizieren und ein neues Konto erstellen
Wenn Sie zusätzliche Informationen benötigen, um die Kontoerstellung abzuschließen, z. B. das Geburtsdatum des Nutzers. Dem Nutzer wird ein Vorgang mit Anmeldedetails präsentiert, in dem wenn Sie diese zusätzlichen Informationen anfordern. Senden Sie es dann an Ihr Backend, um die Kontoerstellung abzuschließen.