Se debe llamar a este o a otro método de autenticación antes de ee.initialize().
Ten en cuenta que, si el usuario no otorgó acceso previamente a la aplicación identificada por el ID de cliente, de forma predeterminada, se intentará mostrar una ventana de diálogo que le solicite al usuario que otorgue el permiso requerido. Sin embargo, el navegador puede bloquear esta ventana emergente. Para evitar esto, especifica la devolución de llamada opt_onImmediateFailed y, en ella, renderiza un botón de acceso en la página. Luego, llama a ee.data.authenticateViaPopup() desde el controlador de eventos de clic de este botón. Esto evita que el navegador bloquee la ventana emergente, ya que ahora es el resultado directo de una acción del usuario.
El token de autorización se actualizará automáticamente cuando sea posible. Puedes suponer con seguridad que todas las llamadas asíncronas se enviarán con las credenciales adecuadas. Sin embargo, para las llamadas síncronas, debes verificar si hay un token de autorización con ee.data.getAuthToken() y llamar a ee.data.refreshAuthToken() de forma manual si no hay ninguno. La operación de actualización del token es asíncrona y no se puede realizar de forma oculta a pedido antes de las llamadas síncronas.
| Uso | Muestra |
|---|---|
ee.data.authenticateViaOauth(clientId, success, error, extraScopes, onImmediateFailed, suppressDefaultScopes) |
| Argumento | Tipo | Detalles |
|---|---|---|
clientId | String | Es el ID de cliente de OAuth de la aplicación o un valor nulo para inhabilitar las llamadas autenticadas. Se puede obtener a través de Google Developers Console. El proyecto debe tener un origen de JavaScript que corresponda al dominio en el que se ejecuta la secuencia de comandos. |
success | Función | Es la función a la que se llama si la autenticación se realizó correctamente. |
error | Función, opcional | Es la función que se llama si falla la autenticación y se pasa el mensaje de error. Si falla la autenticación en el modo inmediato (en segundo plano) y se especifica opt_onImmediateFailed, se llama a esa función en lugar de opt_error. |
extraScopes | List<String>, opcional | Permisos de OAuth adicionales que se solicitarán. |
onImmediateFailed | Función, opcional | Es la función que se llamará si falla la autenticación automática en segundo plano. El valor predeterminado es ee.data.authenticateViaPopup(), vinculado a las devoluciones de llamada pasadas. |
suppressDefaultScopes | Booleano, opcional | Cuando es verdadero, solo se solicitan los permisos especificados en opt_extraScopes. Los permisos predeterminados no se solicitan, a menos que se especifiquen de forma explícita en opt_extraScopes. |