GetGoogleIdOption.Builder
public final class GetGoogleIdOption.Builder
Un costruttore per GetGoogleIdOption.
Riepilogo
Costruttori pubblici |
|---|
Builder() |
Metodi pubblici |
|
|---|---|
final @NonNull GetGoogleIdOption.Builder |
associateLinkedAccounts(Imposta se supportare l'accesso utilizzando gli Account Google collegati agli account degli utenti. |
final @NonNull GetGoogleIdOption |
build() |
final @NonNull GetGoogleIdOption.Builder |
setAutoSelectEnabled(boolean autoSelectEnabled)Imposta il comportamento di selezione automatica nella richiesta. |
final @NonNull GetGoogleIdOption.Builder |
Imposta le rivendicazioni da includere nel token ID Google. |
final @NonNull GetGoogleIdOption.Builder |
setFilterByAuthorizedAccounts(boolean filterByAuthorizedAccounts)Determina se consentire all'utente di selezionare solo gli Account Google già autorizzati ad accedere alla tua applicazione. |
final @NonNull GetGoogleIdOption.Builder |
setHostedDomainFilter(String hostedDomainFilter)Imposta il filtro del dominio ospitato per limitare l'accesso con Google agli account all'interno di un dominio Google Workspace specifico. |
final @NonNull GetGoogleIdOption.Builder |
Imposta il nonce da utilizzare durante la generazione di un token ID Google. |
final @NonNull GetGoogleIdOption.Builder |
setRequestVerifiedPhoneNumber(boolean requestVerifiedPhoneNumber)Imposta se richiedere un numero di telefono verificato durante le registrazioni. |
final @NonNull GetGoogleIdOption.Builder |
setServerClientId(@NonNull String serverClientId)Imposta l'ID client del server da utilizzare come pubblico per i token ID Google generati durante l'accesso. |
Costruttori pubblici
Metodi pubblici
associateLinkedAccounts
public final @NonNull GetGoogleIdOption.Builder associateLinkedAccounts(
@NonNull String linkedServiceId,
List<@NonNull String> idTokenDepositionScopes
)
Imposta se supportare l'accesso utilizzando gli Account Google collegati agli account degli utenti.
Quando viene selezionata una credenziale di questo tipo, un token ID Google per l'Account Google a cui è collegato l'account selezionato viene prima depositato sul tuo server e poi restituito. Analogamente all'accesso normale, il backend potrebbe utilizzare il token ID per consentire l'accesso dell'utente. Tieni presente che il deposito del token ID avverrà solo al primo accesso utilizzando queste credenziali. Gli accessi successivi non richiederanno una deposizione, poiché il token ID sarà già stato associato all'account dell'utente.
| Parametri | |
|---|---|
@NonNull String linkedServiceId |
ID servizio utilizzato per collegare gli account a un Account Google. |
List<@NonNull String> idTokenDepositionScopes |
Ambiti OAuth che Google dovrà utilizzare per depositare un token ID Google nel server di backend dell'applicazione. Questo campo è facoltativo e può essere impostato su null. Obbligatorio solo se Google richiede ambiti particolari per poter depositare il token ID. |
setAutoSelectEnabled
public final @NonNull GetGoogleIdOption.Builder setAutoSelectEnabled(boolean autoSelectEnabled)
Imposta il comportamento di selezione automatica nella richiesta.
Per gli utenti che attivano questa opzione, la selezione automatica consente di selezionare automaticamente una credenziale senza attendere un'azione dell'utente (ad esempio toccare il pulsante "Continua"). Una credenziale può essere selezionata automaticamente se 1) è possibile utilizzare una sola credenziale per l'accesso e 2) non sono necessarie ulteriori azioni per questa credenziale (ad esempio, le autorizzazioni di condivisione dei dati sono già raccolte per un Account Google).
setClaims
public final @NonNull GetGoogleIdOption.Builder setClaims(@NonNull List<@NonNull Claim> claims)
Imposta le rivendicazioni da includere nel token ID Google.
Per un elenco delle rivendicazioni disponibili, consulta la documentazione. Eventuali rivendicazioni non supportate verranno ignorate.
setFilterByAuthorizedAccounts
public final @NonNull GetGoogleIdOption.Builder setFilterByAuthorizedAccounts(boolean filterByAuthorizedAccounts)
Determina se consentire all'utente di selezionare solo gli Account Google già autorizzati ad accedere alla tua applicazione. Il valore predefinito è true.
Se {@code true}, l'utente non potrà selezionare alcun Account Google che altrimenti richiederebbe un'autorizzazione esplicita per condividere i dati di base del profilo/email con la tua applicazione. In questo modo, si riducono alcuni inconvenienti nel percorso dell'utente per l'accesso e si garantisce che le credenziali restituite siano per un "utente di ritorno", ma si limita la libertà dell'utente di scegliere tra tutti gli Account Google sul dispositivo.
| Parametri | |
|---|---|
boolean filterByAuthorizedAccounts |
Se consentire all'utente di selezionare solo gli Account Google già autorizzati ad accedere alla tua applicazione |
setHostedDomainFilter
public final @NonNull GetGoogleIdOption.Builder setHostedDomainFilter(String hostedDomainFilter)
Imposta il filtro del dominio ospitato per limitare l'accesso con Google agli account all'interno di un dominio Google Workspace specifico.
Il passaggio di una stringa nulla o vuota non comporterà alcun filtro.
| Parametri | |
|---|---|
String hostedDomainFilter |
il dominio in base al quale filtrare (ad es. "example.com") |
setNonce
public final @NonNull GetGoogleIdOption.Builder setNonce(String nonce)
Imposta il nonce da utilizzare durante la generazione di un token ID Google.
| Parametri | |
|---|---|
String nonce |
il nonce da utilizzare durante la generazione del token ID |
setRequestVerifiedPhoneNumber
public final @NonNull GetGoogleIdOption.Builder setRequestVerifiedPhoneNumber(boolean requestVerifiedPhoneNumber)
Imposta se richiedere un numero di telefono verificato durante le registrazioni.
Per utilizzare questa funzionalità, il campo [filterByAuthorizedAccounts] deve essere impostato in modo esplicito su false, perché questa funzionalità è disponibile solo durante le registrazioni.
setServerClientId
public final @NonNull GetGoogleIdOption.Builder setServerClientId(@NonNull String serverClientId)
Imposta l'ID client del server da utilizzare come pubblico per i token ID Google generati durante l'accesso.