Questo o un altro metodo di autenticazione deve essere chiamato prima di ee.initialize().
Tieni presente che, se l'utente non ha precedentemente concesso l'accesso all'applicazione identificata dall'ID client, per impostazione predefinita verrà visualizzata una finestra di dialogo che chiede all'utente di concedere l'autorizzazione richiesta. Tuttavia, questo popup può essere bloccato dal browser. Per evitare questo problema, specifica il callback opt_onImmediateFailed e al suo interno esegui il rendering di un pulsante di accesso nella pagina, quindi chiama ee.data.authenticateViaPopup() dal gestore eventi di clic di questo pulsante. In questo modo, il browser non blocca il popup, in quanto è il risultato diretto di un'azione utente.
Il token di autenticazione verrà aggiornato automaticamente quando possibile. Puoi dare per scontato che tutte le chiamate asincrone verranno inviate con le credenziali appropriate. Per le chiamate sincrone, tuttavia, devi verificare la presenza di un token di autenticazione con ee.data.getAuthToken() e chiamare ee.data.refreshAuthToken() manualmente se non è presente. L'operazione di aggiornamento del token è asincrona e non può essere eseguita in background su richiesta prima delle chiamate sincrone.
| Utilizzo | Resi |
|---|---|
ee.data.authenticateViaOauth(clientId, success, error, extraScopes, onImmediateFailed, suppressDefaultScopes) |
| Argomento | Tipo | Dettagli |
|---|---|---|
clientId | Stringa | L'ID client OAuth dell'applicazione o null per disattivare le chiamate autenticate. Puoi ottenerlo tramite Google Developers Console. Il progetto deve avere un'origine JavaScript che corrisponda al dominio in cui viene eseguito lo script. |
success | Funzione | La funzione da chiamare se l'autenticazione è riuscita. |
error | Funzione, facoltativa | La funzione da chiamare se l'autenticazione non è riuscita, ha superato il messaggio di errore. Se l'autenticazione in modalità immediata (in background) non va a buon fine e viene specificata opt_onImmediateFailed, viene chiamata questa funzione anziché opt_error. |
extraScopes | List<String>, facoltativo | Ambiti OAuth aggiuntivi da richiedere. |
onImmediateFailed | Funzione, facoltativa | La funzione da chiamare se l'autenticazione automatica in background non va a buon fine. Il valore predefinito è ee.data.authenticateViaPopup(), associato ai callback passati. |
suppressDefaultScopes | Booleano, facoltativo | Se il valore è true, vengono richiesti solo gli ambiti specificati in opt_extraScopes; gli ambiti predefiniti non vengono richiesti, a meno che non siano specificati esplicitamente in opt_extraScopes. |