GetGoogleIdOption.Builder
public final class GetGoogleIdOption.Builder
Ein Builder für GetGoogleIdOption.
Zusammenfassung
Öffentliche Konstruktoren |
|---|
Builder() |
Öffentliche Methoden |
|
|---|---|
final @NonNull GetGoogleIdOption.Builder |
associateLinkedAccounts(Legt fest, ob die Anmeldung mit Google-Konten unterstützt werden soll, die mit den Konten Ihrer Nutzer verknüpft sind. |
final @NonNull GetGoogleIdOption |
build() |
final @NonNull GetGoogleIdOption.Builder |
setAutoSelectEnabled(boolean autoSelectEnabled)Legt das Verhalten für die automatische Auswahl in der Anfrage fest. |
final @NonNull GetGoogleIdOption.Builder |
Legt die Ansprüche fest, die im Google-ID-Token enthalten sein sollen. |
final @NonNull GetGoogleIdOption.Builder |
setFilterByAuthorizedAccounts(boolean filterByAuthorizedAccounts)Legt fest, ob der Nutzer nur Google-Konten auswählen darf, die bereits für die Anmeldung in Ihrer Anwendung autorisiert sind. |
final @NonNull GetGoogleIdOption.Builder |
setHostedDomainFilter(String hostedDomainFilter)Legt den Filter für gehostete Domains fest, um die Google-Anmeldung auf Konten in einer bestimmten Google Workspace-Domain zu beschränken. |
final @NonNull GetGoogleIdOption.Builder |
Legt die Nonce fest, die beim Generieren eines Google-ID-Tokens verwendet werden soll. |
final @NonNull GetGoogleIdOption.Builder |
setRequestVerifiedPhoneNumber(boolean requestVerifiedPhoneNumber)Legt fest, ob bei der Registrierung eine bestätigte Telefonnummer angefordert werden soll. |
final @NonNull GetGoogleIdOption.Builder |
setServerClientId(@NonNull String serverClientId)Legt die Client-ID des Servers fest, die als Zielgruppe für Google-ID-Tokens verwendet werden soll, die während der Anmeldung generiert werden. |
Öffentliche Konstruktoren
Öffentliche Methoden
associateLinkedAccounts
public final @NonNull GetGoogleIdOption.Builder associateLinkedAccounts(
@NonNull String linkedServiceId,
List<@NonNull String> idTokenDepositionScopes
)
Legt fest, ob die Anmeldung mit Google-Konten unterstützt werden soll, die mit den Konten Ihrer Nutzer verknüpft sind.
Wenn ein solches Anmeldedatenpaar ausgewählt wird, wird zuerst ein Google-ID-Token für das Google-Konto, mit dem das ausgewählte Konto verknüpft ist, auf Ihrem Server gespeichert und dann an Sie zurückgegeben. Ähnlich wie bei der regulären Anmeldung kann Ihr Backend das ID-Token verwenden, um den Nutzer anzumelden. Das ID-Token wird nur bei der ersten Anmeldung mit diesen Anmeldedaten hinterlegt. Bei nachfolgenden Anmeldungen ist keine Ablagerung erforderlich, da das ID-Token bereits mit dem Konto des Nutzers verknüpft wurde.
| Parameter | |
|---|---|
@NonNull String linkedServiceId |
Die Dienst-ID, die beim Verknüpfen von Konten mit einem Google-Konto verwendet wird. |
List<@NonNull String> idTokenDepositionScopes |
OAuth-Bereiche, die Google benötigt, um ein Google-ID-Token auf dem Backend-Server Ihrer Anwendung zu hinterlegen. Dies ist optional und kann auf „null“ gesetzt werden. Nur erforderlich, wenn Google bestimmte Bereiche benötigt, um das ID-Token zu hinterlegen. |
setAutoSelectEnabled
public final @NonNull GetGoogleIdOption.Builder setAutoSelectEnabled(boolean autoSelectEnabled)
Legt das Verhalten für die automatische Auswahl in der Anfrage fest.
Wenn Nutzer die automatische Auswahl aktivieren, kann eine Anmeldedaten automatisch ausgewählt werden, ohne dass auf eine Nutzeraktion gewartet werden muss, z. B. auf das Tippen auf die Schaltfläche „Weiter“. Anmeldedaten können automatisch ausgewählt werden, wenn 1) nur eine Anmeldedatenart für die Anmeldung verwendet werden kann und 2) keine weiteren Aktionen für diese Anmeldedaten erforderlich sind (z. B. wenn die Berechtigungen für die Datenfreigabe für ein Google-Konto bereits eingeholt wurden).
setClaims
public final @NonNull GetGoogleIdOption.Builder setClaims(@NonNull List<@NonNull Claim> claims)
Legt die Ansprüche fest, die im Google-ID-Token enthalten sein sollen.
Eine Liste der verfügbaren Behauptungen finden Sie in der Dokumentation. Nicht unterstützte Ansprüche werden ignoriert.
setFilterByAuthorizedAccounts
public final @NonNull GetGoogleIdOption.Builder setFilterByAuthorizedAccounts(boolean filterByAuthorizedAccounts)
Legt fest, ob der Nutzer nur Google-Konten auswählen darf, die bereits für die Anmeldung in Ihrer Anwendung autorisiert sind. Der Standardwert ist true.
Wenn {@code true}, kann der Nutzer kein Google-Konto auswählen, für das ansonsten eine explizite Autorisierung erforderlich wäre, um grundlegende Profil-/E-Mail-Daten mit Ihrer Anwendung zu teilen. Dies kann die Anmeldung vereinfachen und garantiert, dass die zurückgegebenen Anmeldedaten für einen „wiederkehrenden Nutzer“ sind. Allerdings wird die Auswahl der Google-Konten auf dem Gerät eingeschränkt.
| Parameter | |
|---|---|
boolean filterByAuthorizedAccounts |
ob der Nutzer nur Google-Konten auswählen darf, die bereits für die Anmeldung bei Ihrer Anwendung autorisiert sind |
setHostedDomainFilter
public final @NonNull GetGoogleIdOption.Builder setHostedDomainFilter(String hostedDomainFilter)
Legt den Filter für gehostete Domains fest, um die Google-Anmeldung auf Konten in einer bestimmten Google Workspace-Domain zu beschränken.
Wenn Sie einen Null- oder leeren String übergeben, erfolgt keine Filterung.
| Parameter | |
|---|---|
String hostedDomainFilter |
die Domain, nach der gefiltert werden soll (z.B. beispiel.de) |
setNonce
public final @NonNull GetGoogleIdOption.Builder setNonce(String nonce)
Legt die Nonce fest, die beim Generieren eines Google-ID-Tokens verwendet werden soll.
| Parameter | |
|---|---|
String nonce |
Die Nonce, die bei der Generierung des ID-Tokens verwendet werden soll |
setRequestVerifiedPhoneNumber
public final @NonNull GetGoogleIdOption.Builder setRequestVerifiedPhoneNumber(boolean requestVerifiedPhoneNumber)
Legt fest, ob bei der Registrierung eine bestätigte Telefonnummer angefordert werden soll.
Damit Sie diese Funktion nutzen können, muss das Feld [filterByAuthorizedAccounts] explizit auf „false“ gesetzt werden, da diese Funktion nur bei der Registrierung verfügbar ist.
setServerClientId
public final @NonNull GetGoogleIdOption.Builder setServerClientId(@NonNull String serverClientId)
Legt die Client-ID des Servers fest, die als Zielgruppe für Google-ID-Tokens verwendet werden soll, die während der Anmeldung generiert werden.