AccountManager.GetAuthToken Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
| Nome | Description |
|---|---|
| GetAuthToken(Account, String, Boolean, IAccountManagerCallback, Handler) |
Obsoleto.
Obtém um token de autenticação do tipo especificado para uma conta específica, opcionalmente, gerando uma notificação se o usuário precisar inserir credenciais. |
| GetAuthToken(Account, String, Bundle, Activity, IAccountManagerCallback, Handler) |
Obtém um token de autenticação do tipo especificado para uma conta específica, solicitando ao usuário credenciais, se necessário. |
| GetAuthToken(Account, String, Bundle, Boolean, IAccountManagerCallback, Handler) |
Obtém um token de autenticação do tipo especificado para uma conta específica, opcionalmente, gerando uma notificação se o usuário precisar inserir credenciais. |
GetAuthToken(Account, String, Boolean, IAccountManagerCallback, Handler)
Cuidado
deprecated
Obtém um token de autenticação do tipo especificado para uma conta específica, opcionalmente, gerando uma notificação se o usuário precisar inserir credenciais.
[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
A conta para buscar um token de autenticação
- authTokenType
- String
O tipo de token de autenticação, um token de cadeia de caracteres dependente do autenticador, não deve ser nulo
- notifyAuthFailure
- Boolean
True para adicionar uma notificação para solicitar ao usuário uma senha, se necessário, false para deixar isso para o chamador
- callback
- IAccountManagerCallback
Retorno de chamada a ser invocado quando a solicitação for concluída, nulo para nenhum retorno de chamada
- handler
- Handler
Handler identificando o thread de retorno de chamada, nulo para o thread principal
Retornos
Um AccountManagerFuture que é resolvido para um Pacote com pelo menos os seguintes campos de êxito: <ul><li#KEY_ACCOUNT_NAME> - o nome da conta que <você forneceu li#KEY_ACCOUNT_TYPE> - o tipo da conta <li>#KEY_AUTHTOKEN - o token de autenticação que você queria </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:
<ul>
<li> <code data-dev-comment-type="c">AuthenticatorException</code> if the authenticator failed to respond
<li> <code data-dev-comment-type="c">OperationCanceledException</code> if the operation is canceled for
any reason, incluidng the user canceling a credential request
<li> <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
</ul>
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
Comentários
Obtém um token de autenticação do tipo especificado para uma conta específica, opcionalmente, gerando uma notificação se o usuário precisar inserir credenciais. Esse método destina-se a tarefas em segundo plano e serviços em que o usuário não deve ser interrompido imediatamente com um prompt de senha.
Se um token de autenticação gerado anteriormente for armazenado em cache para essa conta e digitar, ele será retornado. Caso contrário, se uma senha salva estiver disponível, ela será enviada ao servidor para gerar um novo token de autenticação. Caso contrário, será retornado um Intent que, quando iniciado, solicitará ao usuário uma senha. Se o parâmetro notifyAuthFailure estiver definido, uma notificação de barra de status também será criada com a mesma Intenção, alertando o usuário de que ele precisa inserir uma senha em algum momento.
Nesse caso, talvez seja necessário aguardar até que o usuário responda, o que pode levar horas ou dias ou para sempre. Quando o usuário responder e fornecer uma nova senha, o gerenciador de contas transmitirá a #LOGIN_ACCOUNTS_CHANGED_ACTION Intenção e notificará OnAccountsUpdateListener quais aplicativos podem usar para tentar novamente.
Se notifyAuthFailure não estiver definido, será responsabilidade do aplicativo iniciar a Intenção retornada em algum momento. De qualquer forma, o resultado dessa chamada não aguardará a ação do usuário.
Alguns autenticadores têm tipos/em> de< token <>de autenticação, cujo valor depende do autenticador. Alguns serviços usam tipos de token diferentes para acessar diferentes funcionalidades , por exemplo, o Google usa tokens de autenticação diferentes para acessar o Gmail e o Google Calendar para a mesma conta.
Esse método pode ser chamado de qualquer thread, mas o retornado AccountManagerFuture não deve ser usado no thread principal.
Este membro foi preterido. em vez disso, use #getAuthToken(Account, String, android.os.Bundle, boolean, AccountManagerCallback, android.os.Handler)
Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.
Aplica-se a
GetAuthToken(Account, String, Bundle, Activity, IAccountManagerCallback, Handler)
Obtém um token de autenticação do tipo especificado para uma conta específica, solicitando ao usuário credenciais, se necessário.
[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
A conta para buscar um token de autenticação
- authTokenType
- String
O tipo de token de autenticação, um token de cadeia de caracteres dependente do autenticador, não deve ser nulo
- options
- Bundle
As opções específicas do autenticador para a solicitação podem ser nulas ou vazias
- activity
- Activity
O Activity contexto a ser usado para iniciar uma nova sub-atividade definida pelo autenticador para solicitar ao usuário uma senha, se necessário, usado apenas para chamar startActivity(); não deve ser nulo.
- callback
- IAccountManagerCallback
Retorno de chamada a ser invocado quando a solicitação for concluída, nulo para nenhum retorno de chamada
- handler
- Handler
Handler identificando o thread de retorno de chamada, nulo para o thread principal
Retornos
Um AccountManagerFuture que resolve para um Pacote com pelo menos os seguintes campos: <ul><li>#KEY_ACCOUNT_NAME - o nome da conta que <você forneceu li>#KEY_ACCOUNT_TYPE - o tipo da conta <li>#KEY_AUTHTOKEN - o token de autenticação que você queria </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:
<ul>
<li> <code data-dev-comment-type="c">AuthenticatorException</code> if the authenticator failed to respond
<li> <code data-dev-comment-type="c">OperationCanceledException</code> if the operation is canceled for
any reason, incluidng the user canceling a credential request
<li> <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
</ul>
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
Comentários
Obtém um token de autenticação do tipo especificado para uma conta específica, solicitando ao usuário credenciais, se necessário. Esse método destina-se a aplicativos em execução em primeiro plano, em que faz sentido pedir uma senha diretamente ao usuário.
Se um token de autenticação gerado anteriormente for armazenado em cache para essa conta e digitar, ele será retornado. Caso contrário, se uma senha salva estiver disponível, ela será enviada ao servidor para gerar um novo token de autenticação. Caso contrário, o usuário será solicitado a inserir uma senha.
Alguns autenticadores têm tipos/em> de< token <>de autenticação, cujo valor depende do autenticador. Alguns serviços usam tipos de token diferentes para acessar diferentes funcionalidades , por exemplo, o Google usa tokens de autenticação diferentes para acessar o Gmail e o Google Calendar para a mesma conta.
<b>OBSERVAÇÃO:</b> Se o destino do aplicativo funcionar no nível 22 da API e antes, USE_CREDENTIALS permissão será necessária para essas plataformas. Consulte documentos para essa função no nível 22 da API.
Esse método pode ser chamado de qualquer thread, mas o retornado AccountManagerFuture não deve ser usado no thread principal.
Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.
Aplica-se a
GetAuthToken(Account, String, Bundle, Boolean, IAccountManagerCallback, Handler)
Obtém um token de autenticação do tipo especificado para uma conta específica, opcionalmente, gerando uma notificação se o usuário precisar inserir credenciais.
[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
A conta para buscar um token de autenticação
- authTokenType
- String
O tipo de token de autenticação, um token de cadeia de caracteres dependente do autenticador, não deve ser nulo
- options
- Bundle
As opções específicas do autenticador para a solicitação podem ser nulas ou vazias
- notifyAuthFailure
- Boolean
True para adicionar uma notificação para solicitar ao usuário uma senha, se necessário, false para deixar isso para o chamador
- callback
- IAccountManagerCallback
Retorno de chamada a ser invocado quando a solicitação for concluída, nulo para nenhum retorno de chamada
- handler
- Handler
Handler identificando o thread de retorno de chamada, nulo para o thread principal
Retornos
Um AccountManagerFuture que é resolvido para um Pacote com pelo menos os seguintes campos de êxito: <ul><li#KEY_ACCOUNT_NAME> - o nome da conta que <você forneceu li#KEY_ACCOUNT_TYPE> - o tipo da conta <li>#KEY_AUTHTOKEN - o token de autenticação que você queria </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:
<ul>
<li> <code data-dev-comment-type="c">AuthenticatorException</code> if the authenticator failed to respond
<li> <code data-dev-comment-type="c">OperationCanceledException</code> if the operation is canceled for
any reason, incluidng the user canceling a credential request
<li> <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
</ul>
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
Comentários
Obtém um token de autenticação do tipo especificado para uma conta específica, opcionalmente, gerando uma notificação se o usuário precisar inserir credenciais. Esse método destina-se a tarefas em segundo plano e serviços em que o usuário não deve ser interrompido imediatamente com um prompt de senha.
Se um token de autenticação gerado anteriormente for armazenado em cache para essa conta e digitar, ele será retornado. Caso contrário, se uma senha salva estiver disponível, ela será enviada ao servidor para gerar um novo token de autenticação. Caso contrário, será retornado um Intent que, quando iniciado, solicitará ao usuário uma senha. Se o parâmetro notifyAuthFailure estiver definido, uma notificação de barra de status também será criada com a mesma Intenção, alertando o usuário de que ele precisa inserir uma senha em algum momento.
Nesse caso, talvez seja necessário aguardar até que o usuário responda, o que pode levar horas ou dias ou para sempre. Quando o usuário responder e fornecer uma nova senha, o gerenciador de contas transmitirá a #LOGIN_ACCOUNTS_CHANGED_ACTION Intenção e notificará OnAccountsUpdateListener quais aplicativos podem usar para tentar novamente.
Se notifyAuthFailure não estiver definido, será responsabilidade do aplicativo iniciar a Intenção retornada em algum momento. De qualquer forma, o resultado dessa chamada não aguardará a ação do usuário.
Alguns autenticadores têm tipos/em> de< token <>de autenticação, cujo valor depende do autenticador. Alguns serviços usam tipos de token diferentes para acessar diferentes funcionalidades , por exemplo, o Google usa tokens de autenticação diferentes para acessar o Gmail e o Google Calendar para a mesma conta.
Esse método pode ser chamado de qualquer thread, mas o retornado AccountManagerFuture não deve ser usado no thread principal.
<b>OBSERVAÇÃO:</b> Se o destino do aplicativo funcionar no nível 22 da API e antes, USE_CREDENTIALS permissão será necessária para essas plataformas. Consulte documentos para essa função no nível 22 da API.
Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.