Cette méthode d'authentification ou une autre doit être appelée avant ee.initialize().
Notez que si l'utilisateur n'a pas encore accordé l'accès à l'application identifiée par l'ID client, une fenêtre de dialogue s'affiche par défaut pour l'inviter à accorder l'autorisation requise. Toutefois, ce pop-up peut être bloqué par le navigateur. Pour éviter cela, spécifiez le rappel opt_onImmediateFailed, puis affichez un bouton de connexion sur la page et appelez ee.data.authenticateViaPopup() à partir du gestionnaire d'événements de clic de ce bouton. Le navigateur ne bloque plus le pop-up, car il est désormais le résultat direct d'une action de l'utilisateur.
Le jeton d'authentification sera actualisé automatiquement lorsque cela sera possible. Vous pouvez partir du principe que tous les appels asynchrones seront envoyés avec les identifiants appropriés. Toutefois, pour les appels synchrones, vous devez rechercher un jeton d'authentification avec ee.data.getAuthToken() et appeler ee.data.refreshAuthToken() manuellement s'il n'y en a pas. L'opération d'actualisation du jeton est asynchrone et ne peut pas être effectuée en arrière-plan à la demande avant les appels synchrones.
| Utilisation | Renvoie |
|---|---|
ee.data.authenticateViaOauth(clientId, success, error, extraScopes, onImmediateFailed, suppressDefaultScopes) |
| Argument | Type | Détails |
|---|---|---|
clientId | Chaîne | ID client OAuth de l'application ou valeur nulle pour désactiver les appels authentifiés. Vous pouvez l'obtenir dans la console Google Developers. Le projet doit avoir une origine JavaScript qui correspond au domaine sur lequel le script s'exécute. |
success | Fonction | Fonction à appeler si l'authentification a réussi. |
error | Fonction, facultatif | Fonction à appeler en cas d'échec de l'authentification, en transmettant le message d'erreur. Si l'authentification en mode immédiat (en arrière-plan) échoue et que opt_onImmediateFailed est spécifié, cette fonction est appelée à la place de opt_error. |
extraScopes | List<String>, facultatif | Champs d'application OAuth supplémentaires à demander. |
onImmediateFailed | Fonction, facultatif | Fonction à appeler en cas d'échec de l'authentification automatique en arrière-plan. La valeur par défaut est ee.data.authenticateViaPopup(), liée aux rappels transmis. |
suppressDefaultScopes | Booléen, facultatif | Si la valeur est "true", seuls les champs d'application spécifiés dans opt_extraScopes sont demandés. Les champs d'application par défaut ne sont pas demandés, sauf s'ils sont explicitement spécifiés dans opt_extraScopes. |