Lenguaje

AccountManager.GetAuthToken Método

Definición

Sobrecargas

Nombre Description
GetAuthToken(Account, String, Boolean, IAccountManagerCallback, Handler)
Obsoletos.

Obtiene un token de autenticación del tipo especificado para una cuenta determinada, lo que opcionalmente genera una notificación si el usuario debe escribir credenciales.

GetAuthToken(Account, String, Bundle, Activity, IAccountManagerCallback, Handler)

Obtiene un token de autenticación del tipo especificado para una cuenta determinada, que solicita al usuario las credenciales si es necesario.

GetAuthToken(Account, String, Bundle, Boolean, IAccountManagerCallback, Handler)

Obtiene un token de autenticación del tipo especificado para una cuenta determinada, lo que opcionalmente genera una notificación si el usuario debe escribir credenciales.

GetAuthToken(Account, String, Boolean, IAccountManagerCallback, Handler)

Precaución

deprecated

Obtiene un token de autenticación del tipo especificado para una cuenta determinada, lo que opcionalmente genera una notificación si el usuario debe escribir credenciales.

[Android.Runtime.Register("getAuthToken", "(Landroid/accounts/Account;Ljava/lang/String;ZLandroid/accounts/AccountManagerCallback;Landroid/os/Handler;)Landroid/accounts/AccountManagerFuture;", "GetGetAuthToken_Landroid_accounts_Account_Ljava_lang_String_ZLandroid_accounts_AccountManagerCallback_Landroid_os_Handler_Handler")]
[Android.Runtime.RequiresPermission("android.permission.USE_CREDENTIALS")]
[System.Obsolete("deprecated")]
public virtual Android.Accounts.IAccountManagerFuture? GetAuthToken(Android.Accounts.Account? account, string? authTokenType, bool notifyAuthFailure, Android.Accounts.IAccountManagerCallback? callback, Android.OS.Handler? handler);
[<Android.Runtime.Register("getAuthToken", "(Landroid/accounts/Account;Ljava/lang/String;ZLandroid/accounts/AccountManagerCallback;Landroid/os/Handler;)Landroid/accounts/AccountManagerFuture;", "GetGetAuthToken_Landroid_accounts_Account_Ljava_lang_String_ZLandroid_accounts_AccountManagerCallback_Landroid_os_Handler_Handler")>]
[<Android.Runtime.RequiresPermission("android.permission.USE_CREDENTIALS")>]
[<System.Obsolete("deprecated")>]
abstract member GetAuthToken : Android.Accounts.Account * string * bool * Android.Accounts.IAccountManagerCallback * Android.OS.Handler -> Android.Accounts.IAccountManagerFuture
override this.GetAuthToken : Android.Accounts.Account * string * bool * Android.Accounts.IAccountManagerCallback * Android.OS.Handler -> Android.Accounts.IAccountManagerFuture

Parámetros

account
Account

Cuenta para la que se va a capturar un token de autenticación

authTokenType
String

El tipo de token de autenticación, un token de cadena dependiente del autenticador, no debe ser NULL.

notifyAuthFailure
Boolean

True para agregar una notificación para solicitar al usuario una contraseña si es necesario, false para dejarla en el autor de la llamada.

callback
IAccountManagerCallback

Devolución de llamada para invocar cuando se completa la solicitud, null para ninguna devolución de llamada

handler
Handler

Handler identificar el subproceso de devolución de llamada, null para el subproceso principal

Devoluciones

Que AccountManagerFuture se resuelve en un paquete con al menos los siguientes campos de éxito: <ul><li#KEY_ACCOUNT_NAME> - el nombre de la cuenta que proporcionó <li>#KEY_ACCOUNT_TYPE - el tipo de cuenta <li>#KEY_AUTHTOKEN - el token de autenticación que quería </ul>

        (Other authenticator-specific values may be returned.)  If the user
        must enter credentials, the returned Bundle contains only
        <code data-dev-comment-type="c">#KEY_INTENT</code> with the <code data-dev-comment-type="c">Intent</code> needed to launch a prompt.

        If an error occurred, <code data-dev-comment-type="c">AccountManagerFuture#getResult()</code> throws:
        &lt;ul&gt;
        &lt;li&gt; <code data-dev-comment-type="c">AuthenticatorException</code> if the authenticator failed to respond
        &lt;li&gt; <code data-dev-comment-type="c">OperationCanceledException</code> if the operation is canceled for
             any reason, incluidng the user canceling a credential request
        &lt;li&gt; <code data-dev-comment-type="c">IOException</code> if the authenticator experienced an I/O problem
             creating a new auth token, usually because of network trouble
        &lt;/ul&gt;
        If the account is no longer present on the device, the return value is
        authenticator-dependent.  The caller should verify the validity of the
        account before requesting an auth token.
Atributos

Comentarios

Obtiene un token de autenticación del tipo especificado para una cuenta determinada, lo que opcionalmente genera una notificación si el usuario debe escribir credenciales. Este método está pensado para tareas en segundo plano y servicios en los que el usuario no debe interrumpirse inmediatamente con una solicitud de contraseña.

Si se almacena en caché un token de autenticación generado previamente para esta cuenta y tipo, se devuelve. De lo contrario, si hay una contraseña guardada disponible, se envía al servidor para generar un nuevo token de autenticación. De lo contrario, se devuelve un Intent que, cuando se inicia, solicitará al usuario una contraseña. Si se establece el parámetro notifyAuthFailure, también se crea una notificación de barra de estado con la misma intención, lo que alerta al usuario de que necesita escribir una contraseña en algún momento.

En ese caso, es posible que tenga que esperar hasta que el usuario responda, lo que podría tardar horas o días o para siempre. Cuando el usuario responde y proporciona una nueva contraseña, el administrador de cuentas difundirá la #LOGIN_ACCOUNTS_CHANGED_ACTION intención y notificará OnAccountsUpdateListener qué aplicaciones pueden usar para volver a intentarlo.

Si notifyAuthFailure no está establecido, es responsabilidad de la aplicación iniciar la intención devuelta en algún momento. En cualquier caso, el resultado de esta llamada no esperará la acción del usuario.

Algunos autenticadores tienen tipos em>de< token <de autenticación/em>, cuyo valor depende del autenticador. Algunos servicios usan distintos tipos de token para acceder a distintas funciones; por ejemplo, Google usa tokens de autenticación diferentes para acceder a Gmail y Google Calendar para la misma cuenta.

Se puede llamar a este método desde cualquier subproceso, pero no se debe usar el devuelto en el subproceso AccountManagerFuture principal.

Este miembro está en desuso. use #getAuthToken(Account, String, android.os.Bundle, boolean, AccountManagerCallback, android.os.Handler) en su lugar

Java documentación para android.accounts.AccountManager.getAuthToken(android.accounts.Account, java.lang.String, boolean, android.accounts.AccountManagerCallback<android.os.Bundle>, android.os.Handler).

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.

Se aplica a

GetAuthToken(Account, String, Bundle, Activity, IAccountManagerCallback, Handler)

Obtiene un token de autenticación del tipo especificado para una cuenta determinada, que solicita al usuario las credenciales si es necesario.

[Android.Runtime.Register("getAuthToken", "(Landroid/accounts/Account;Ljava/lang/String;Landroid/os/Bundle;Landroid/app/Activity;Landroid/accounts/AccountManagerCallback;Landroid/os/Handler;)Landroid/accounts/AccountManagerFuture;", "GetGetAuthToken_Landroid_accounts_Account_Ljava_lang_String_Landroid_os_Bundle_Landroid_app_Activity_Landroid_accounts_AccountManagerCallback_Landroid_os_Handler_Handler")]
[Android.Runtime.RequiresPermission("android.permission.USE_CREDENTIALS")]
public virtual Android.Accounts.IAccountManagerFuture? GetAuthToken(Android.Accounts.Account? account, string? authTokenType, Android.OS.Bundle? options, Android.App.Activity? activity, Android.Accounts.IAccountManagerCallback? callback, Android.OS.Handler? handler);
[<Android.Runtime.Register("getAuthToken", "(Landroid/accounts/Account;Ljava/lang/String;Landroid/os/Bundle;Landroid/app/Activity;Landroid/accounts/AccountManagerCallback;Landroid/os/Handler;)Landroid/accounts/AccountManagerFuture;", "GetGetAuthToken_Landroid_accounts_Account_Ljava_lang_String_Landroid_os_Bundle_Landroid_app_Activity_Landroid_accounts_AccountManagerCallback_Landroid_os_Handler_Handler")>]
[<Android.Runtime.RequiresPermission("android.permission.USE_CREDENTIALS")>]
abstract member GetAuthToken : Android.Accounts.Account * string * Android.OS.Bundle * Android.App.Activity * Android.Accounts.IAccountManagerCallback * Android.OS.Handler -> Android.Accounts.IAccountManagerFuture
override this.GetAuthToken : Android.Accounts.Account * string * Android.OS.Bundle * Android.App.Activity * Android.Accounts.IAccountManagerCallback * Android.OS.Handler -> Android.Accounts.IAccountManagerFuture

Parámetros

account
Account

Cuenta para la que se va a capturar un token de autenticación

authTokenType
String

El tipo de token de autenticación, un token de cadena dependiente del autenticador, no debe ser NULL.

options
Bundle

Las opciones específicas del autenticador para la solicitud pueden ser nulas o vacías.

activity
Activity

El Activity contexto que se va a usar para iniciar una nueva sub-actividad definida por el autenticador para solicitar al usuario una contraseña si es necesario; se usa solo para llamar a startActivity(); no debe ser NULL.

callback
IAccountManagerCallback

Devolución de llamada para invocar cuando se completa la solicitud, null para ninguna devolución de llamada

handler
Handler

Handler identificar el subproceso de devolución de llamada, null para el subproceso principal

Devoluciones

Que AccountManagerFuture se resuelve en un paquete con al menos los siguientes campos: ul><li>#KEY_ACCOUNT_NAME - <el nombre de la cuenta que proporcionó <li>#KEY_ACCOUNT_TYPE - el tipo de cuenta <li>#KEY_AUTHTOKEN - el token de autenticación que quería </ul>

        (Other authenticator-specific values may be returned.)  If an auth token
        could not be fetched, <code data-dev-comment-type="c">AccountManagerFuture#getResult()</code> throws:
        &lt;ul&gt;
        &lt;li&gt; <code data-dev-comment-type="c">AuthenticatorException</code> if the authenticator failed to respond
        &lt;li&gt; <code data-dev-comment-type="c">OperationCanceledException</code> if the operation is canceled for
             any reason, incluidng the user canceling a credential request
        &lt;li&gt; <code data-dev-comment-type="c">IOException</code> if the authenticator experienced an I/O problem
             creating a new auth token, usually because of network trouble
        &lt;/ul&gt;
        If the account is no longer present on the device, the return value is
        authenticator-dependent.  The caller should verify the validity of the
        account before requesting an auth token.
Atributos

Comentarios

Obtiene un token de autenticación del tipo especificado para una cuenta determinada, que solicita al usuario las credenciales si es necesario. Este método está pensado para las aplicaciones que se ejecutan en primer plano, donde tiene sentido pedir al usuario directamente una contraseña.

Si se almacena en caché un token de autenticación generado previamente para esta cuenta y tipo, se devuelve. De lo contrario, si hay una contraseña guardada disponible, se envía al servidor para generar un nuevo token de autenticación. De lo contrario, se pide al usuario que escriba una contraseña.

Algunos autenticadores tienen tipos em>de< token <de autenticación/em>, cuyo valor depende del autenticador. Algunos servicios usan distintos tipos de token para acceder a distintas funciones; por ejemplo, Google usa tokens de autenticación diferentes para acceder a Gmail y Google Calendar para la misma cuenta.

<b>NOTA:</b> Si el destino de la aplicación funciona en el nivel de API 22 y antes, se necesita USE_CREDENTIALS permiso para esas plataformas. Consulte la documentación de esta función en el nivel de API 22.

Se puede llamar a este método desde cualquier subproceso, pero no se debe usar el devuelto en el subproceso AccountManagerFuture principal.

Java documentación para android.accounts.AccountManager.getAuthToken(android.accounts.Account, java.lang.String, android.os.Bundle, android.app.Activity, android.accounts.AccountManagerCallback<android.os.Bundle>, android.os.Handler).

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.

Se aplica a

GetAuthToken(Account, String, Bundle, Boolean, IAccountManagerCallback, Handler)

Obtiene un token de autenticación del tipo especificado para una cuenta determinada, lo que opcionalmente genera una notificación si el usuario debe escribir credenciales.

[Android.Runtime.Register("getAuthToken", "(Landroid/accounts/Account;Ljava/lang/String;Landroid/os/Bundle;ZLandroid/accounts/AccountManagerCallback;Landroid/os/Handler;)Landroid/accounts/AccountManagerFuture;", "GetGetAuthToken_Landroid_accounts_Account_Ljava_lang_String_Landroid_os_Bundle_ZLandroid_accounts_AccountManagerCallback_Landroid_os_Handler_Handler")]
[Android.Runtime.RequiresPermission("android.permission.USE_CREDENTIALS")]
public virtual Android.Accounts.IAccountManagerFuture? GetAuthToken(Android.Accounts.Account? account, string? authTokenType, Android.OS.Bundle? options, bool notifyAuthFailure, Android.Accounts.IAccountManagerCallback? callback, Android.OS.Handler? handler);
[<Android.Runtime.Register("getAuthToken", "(Landroid/accounts/Account;Ljava/lang/String;Landroid/os/Bundle;ZLandroid/accounts/AccountManagerCallback;Landroid/os/Handler;)Landroid/accounts/AccountManagerFuture;", "GetGetAuthToken_Landroid_accounts_Account_Ljava_lang_String_Landroid_os_Bundle_ZLandroid_accounts_AccountManagerCallback_Landroid_os_Handler_Handler")>]
[<Android.Runtime.RequiresPermission("android.permission.USE_CREDENTIALS")>]
abstract member GetAuthToken : Android.Accounts.Account * string * Android.OS.Bundle * bool * Android.Accounts.IAccountManagerCallback * Android.OS.Handler -> Android.Accounts.IAccountManagerFuture
override this.GetAuthToken : Android.Accounts.Account * string * Android.OS.Bundle * bool * Android.Accounts.IAccountManagerCallback * Android.OS.Handler -> Android.Accounts.IAccountManagerFuture

Parámetros

account
Account

Cuenta para la que se va a capturar un token de autenticación

authTokenType
String

El tipo de token de autenticación, un token de cadena dependiente del autenticador, no debe ser NULL.

options
Bundle

Las opciones específicas del autenticador para la solicitud pueden ser nulas o vacías.

notifyAuthFailure
Boolean

True para agregar una notificación para solicitar al usuario una contraseña si es necesario, false para dejarla en el autor de la llamada.

callback
IAccountManagerCallback

Devolución de llamada para invocar cuando se completa la solicitud, null para ninguna devolución de llamada

handler
Handler

Handler identificar el subproceso de devolución de llamada, null para el subproceso principal

Devoluciones

Que AccountManagerFuture se resuelve en un paquete con al menos los siguientes campos de éxito: <ul><li#KEY_ACCOUNT_NAME> - el nombre de la cuenta que proporcionó <li>#KEY_ACCOUNT_TYPE - el tipo de cuenta <li>#KEY_AUTHTOKEN - el token de autenticación que quería </ul>

        (Other authenticator-specific values may be returned.)  If the user
        must enter credentials, the returned Bundle contains only
        <code data-dev-comment-type="c">#KEY_INTENT</code> with the <code data-dev-comment-type="c">Intent</code> needed to launch a prompt.

        If an error occurred, <code data-dev-comment-type="c">AccountManagerFuture#getResult()</code> throws:
        &lt;ul&gt;
        &lt;li&gt; <code data-dev-comment-type="c">AuthenticatorException</code> if the authenticator failed to respond
        &lt;li&gt; <code data-dev-comment-type="c">OperationCanceledException</code> if the operation is canceled for
             any reason, incluidng the user canceling a credential request
        &lt;li&gt; <code data-dev-comment-type="c">IOException</code> if the authenticator experienced an I/O problem
             creating a new auth token, usually because of network trouble
        &lt;/ul&gt;
        If the account is no longer present on the device, the return value is
        authenticator-dependent.  The caller should verify the validity of the
        account before requesting an auth token.
Atributos

Comentarios

Obtiene un token de autenticación del tipo especificado para una cuenta determinada, lo que opcionalmente genera una notificación si el usuario debe escribir credenciales. Este método está pensado para tareas en segundo plano y servicios en los que el usuario no debe interrumpirse inmediatamente con una solicitud de contraseña.

Si se almacena en caché un token de autenticación generado previamente para esta cuenta y tipo, se devuelve. De lo contrario, si hay una contraseña guardada disponible, se envía al servidor para generar un nuevo token de autenticación. De lo contrario, se devuelve un Intent que, cuando se inicia, solicitará al usuario una contraseña. Si se establece el parámetro notifyAuthFailure, también se crea una notificación de barra de estado con la misma intención, lo que alerta al usuario de que necesita escribir una contraseña en algún momento.

En ese caso, es posible que tenga que esperar hasta que el usuario responda, lo que podría tardar horas o días o para siempre. Cuando el usuario responde y proporciona una nueva contraseña, el administrador de cuentas difundirá la #LOGIN_ACCOUNTS_CHANGED_ACTION intención y notificará OnAccountsUpdateListener qué aplicaciones pueden usar para volver a intentarlo.

Si notifyAuthFailure no está establecido, es responsabilidad de la aplicación iniciar la intención devuelta en algún momento. En cualquier caso, el resultado de esta llamada no esperará la acción del usuario.

Algunos autenticadores tienen tipos em>de< token <de autenticación/em>, cuyo valor depende del autenticador. Algunos servicios usan distintos tipos de token para acceder a distintas funciones; por ejemplo, Google usa tokens de autenticación diferentes para acceder a Gmail y Google Calendar para la misma cuenta.

Se puede llamar a este método desde cualquier subproceso, pero no se debe usar el devuelto en el subproceso AccountManagerFuture principal.

<b>NOTA:</b> Si el destino de la aplicación funciona en el nivel de API 22 y antes, se necesita USE_CREDENTIALS permiso para esas plataformas. Consulte la documentación de esta función en el nivel de API 22.

Java documentación para android.accounts.AccountManager.getAuthToken(android.accounts.Account, java.lang.String, android.os.Bundle, boolean, android.accounts.AccountManagerCallback<android.os.Bundle>, android.os.Handler).

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.

Se aplica a