Added in [API level 5](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) Summary: [Constants](https://developer.android.com/reference/android/accounts/AccountManager#constants) \| [Methods](https://developer.android.com/reference/android/accounts/AccountManager#pubmethods) \| [Inherited Methods](https://developer.android.com/reference/android/accounts/AccountManager#inhmethods)
# AccountManager
*** ** * ** ***
` public class AccountManager `
` extends https://developer.android.com/reference/java/lang/Object ` ` `
|---|---|
| [java.lang.Object](https://developer.android.com/reference/java/lang/Object) ||
| ↳ | android.accounts.AccountManager |
*** ** * ** ***
This class provides access to a centralized registry of the user's online accounts. The user enters credentials (username and password) once per account, granting applications access to online resources with "one-click" approval.
Different online services have different ways of handling accounts and authentication, so the account manager uses pluggable *authenticator* modules for different *account types*. Authenticators (which may be written by third parties) handle the actual details of validating account credentials and storing account information. For example, Google, Facebook, and Microsoft Exchange each have their own authenticator.
Many servers support some notion of an *authentication token* , which can be used to authenticate a request to the server without sending the user's actual password. (Auth tokens are normally created with a separate request which does include the user's credentials.) AccountManager can generate auth tokens for applications, so the application doesn't need to handle passwords directly. Auth tokens are normally reusable and cached by AccountManager, but must be refreshed periodically. It's the responsibility of applications to *invalidate* auth tokens when they stop working so the AccountManager knows it needs to regenerate them.
Applications accessing a server normally go through these steps:
- Get an instance of AccountManager using `https://developer.android.com/reference/android/accounts/AccountManager#get(android.content.Context)`.
- List the available accounts using `https://developer.android.com/reference/android/accounts/AccountManager#getAccountsByType(java.lang.String)` or `https://developer.android.com/reference/android/accounts/AccountManager#getAccountsByTypeAndFeatures(java.lang.String,%20java.lang.String[],%20android.accounts.AccountManagerCallback,%20android.os.Handler)`. Normally applications will only be interested in accounts with one particular *type* , which identifies the authenticator. Account *features* are used to identify particular account subtypes and capabilities. Both the account type and features are authenticator-specific strings, and must be known by the application in coordination with its preferred authenticators.
- Select one or more of the available accounts, possibly by asking the user for their preference. If no suitable accounts are available, `https://developer.android.com/reference/android/accounts/AccountManager#addAccount(java.lang.String,%20java.lang.String,%20java.lang.String[],%20android.os.Bundle,%20android.app.Activity,%20android.accounts.AccountManagerCallback,%20android.os.Handler)` may be called to prompt the user to create an account of the appropriate type.
- **Important:** If the application is using a previously remembered account selection, it must make sure the account is still in the list of accounts returned by `https://developer.android.com/reference/android/accounts/AccountManager#getAccountsByType(java.lang.String)`. Requesting an auth token for an account no longer on the device results in an undefined failure.
- Request an auth token for the selected account(s) using one of the `https://developer.android.com/reference/android/accounts/AccountManager#getAuthToken(android.accounts.Account,%20java.lang.String,%20android.os.Bundle,%20android.app.Activity,%20android.accounts.AccountManagerCallback,%20android.os.Handler)` methods or related helpers. Refer to the description of each method for exact usage and error handling details.
- Make the request using the auth token. The form of the auth token, the format of the request, and the protocol used are all specific to the service you are accessing. The application may use whatever network and protocol libraries are useful.
- **Important:** If the request fails with an authentication error, it could be that a cached auth token is stale and no longer honored by the server. The application must call `https://developer.android.com/reference/android/accounts/AccountManager#invalidateAuthToken(java.lang.String,%20java.lang.String)` to remove the token from the cache, otherwise requests will continue failing! After invalidating the auth token, immediately go back to the "Request an auth token" step above. If the process fails the second time, then it can be treated as a "genuine" authentication failure and the user notified or other appropriate actions taken.
Some AccountManager methods may need to interact with the user to prompt for credentials, present options, or ask the user to add an account. The caller may choose whether to allow AccountManager to directly launch the necessary user interface and wait for the user, or to return an Intent which the caller may use to launch the interface, or (in some cases) to install a notification which the user can select at any time to launch the interface. To have AccountManager launch the interface directly, the caller must supply the current foreground `https://developer.android.com/reference/android/app/Activity` context.
Many AccountManager methods take `https://developer.android.com/reference/android/accounts/AccountManagerCallback` and `https://developer.android.com/reference/android/os/Handler` as parameters. These methods return immediately and run asynchronously. If a callback is provided then `https://developer.android.com/reference/android/accounts/AccountManagerCallback#run(android.accounts.AccountManagerFuture)` will be invoked on the Handler's thread when the request completes, successfully or not. The result is retrieved by calling `https://developer.android.com/reference/android/accounts/AccountManagerFuture#getResult()` on the `https://developer.android.com/reference/android/accounts/AccountManagerFuture` returned by the method (and also passed to the callback). This method waits for the operation to complete (if necessary) and either returns the result or throws an exception if an error occurred during the operation. To make the request synchronously, call `https://developer.android.com/reference/android/accounts/AccountManagerFuture#getResult()` immediately on receiving the future from the method; no callback need be supplied.
Requests which may block, including `https://developer.android.com/reference/android/accounts/AccountManagerFuture#getResult()`, must never be called on the application's main event thread. These operations throw `https://developer.android.com/reference/java/lang/IllegalStateException` if they are used on the main thread.
## Summary
| ### Constants ||
|---|---|
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/accounts/AccountManager#ACTION_ACCOUNT_REMOVED` Action sent as a broadcast Intent by the AccountsService when any account is removed or renamed. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/accounts/AccountManager#ACTION_AUTHENTICATOR_INTENT`
|
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/accounts/AccountManager#AUTHENTICATOR_ATTRIBUTES_NAME`
|
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/accounts/AccountManager#AUTHENTICATOR_META_DATA_NAME`
|
| `int` | `https://developer.android.com/reference/android/accounts/AccountManager#ERROR_CODE_BAD_ARGUMENTS`
|
| `int` | `https://developer.android.com/reference/android/accounts/AccountManager#ERROR_CODE_BAD_AUTHENTICATION`
|
| `int` | `https://developer.android.com/reference/android/accounts/AccountManager#ERROR_CODE_BAD_REQUEST`
|
| `int` | `https://developer.android.com/reference/android/accounts/AccountManager#ERROR_CODE_CANCELED`
|
| `int` | `https://developer.android.com/reference/android/accounts/AccountManager#ERROR_CODE_INVALID_RESPONSE`
|
| `int` | `https://developer.android.com/reference/android/accounts/AccountManager#ERROR_CODE_NETWORK_ERROR`
|
| `int` | `https://developer.android.com/reference/android/accounts/AccountManager#ERROR_CODE_REMOTE_EXCEPTION`
|
| `int` | `https://developer.android.com/reference/android/accounts/AccountManager#ERROR_CODE_UNSUPPORTED_OPERATION`
|
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/accounts/AccountManager#KEY_ACCOUNTS`
|
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/accounts/AccountManager#KEY_ACCOUNT_AUTHENTICATOR_RESPONSE`
|
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/accounts/AccountManager#KEY_ACCOUNT_MANAGER_RESPONSE`
|
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/accounts/AccountManager#KEY_ACCOUNT_NAME` Bundle key used for the `https://developer.android.com/reference/java/lang/String` account name in results from methods which return information about a particular account. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/accounts/AccountManager#KEY_ACCOUNT_SESSION_BUNDLE` Bundle key used for a `https://developer.android.com/reference/android/os/Bundle` in result from `https://developer.android.com/reference/android/accounts/AccountManager#startAddAccountSession(java.lang.String,%20java.lang.String,%20java.lang.String[],%20android.os.Bundle,%20android.app.Activity,%20android.accounts.AccountManagerCallback,%20android.os.Handler)` and friends which returns session data for installing an account later. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/accounts/AccountManager#KEY_ACCOUNT_STATUS_TOKEN` Bundle key used for the `https://developer.android.com/reference/java/lang/String` account status token in result from `https://developer.android.com/reference/android/accounts/AccountManager#startAddAccountSession(java.lang.String,%20java.lang.String,%20java.lang.String[],%20android.os.Bundle,%20android.app.Activity,%20android.accounts.AccountManagerCallback,%20android.os.Handler)` and friends which returns information about a particular account. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/accounts/AccountManager#KEY_ACCOUNT_TYPE` Bundle key used for the `https://developer.android.com/reference/java/lang/String` account type in results from methods which return information about a particular account. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/accounts/AccountManager#KEY_ANDROID_PACKAGE_NAME` The Android package of the caller will be set in the options bundle by the `https://developer.android.com/reference/android/accounts/AccountManager` and will be passed to the AccountManagerService and to the AccountAuthenticators. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/accounts/AccountManager#KEY_AUTHENTICATOR_TYPES`
|
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/accounts/AccountManager#KEY_AUTHTOKEN` Bundle key used for the auth token value in results from `https://developer.android.com/reference/android/accounts/AccountManager#getAuthToken(android.accounts.Account,%20java.lang.String,%20android.os.Bundle,%20android.app.Activity,%20android.accounts.AccountManagerCallback,%20android.os.Handler)` and friends. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/accounts/AccountManager#KEY_AUTH_FAILED_MESSAGE`
|
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/accounts/AccountManager#KEY_AUTH_TOKEN_LABEL`
|
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/accounts/AccountManager#KEY_BOOLEAN_RESULT`
|
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/accounts/AccountManager#KEY_CALLER_PID` The process id of caller app. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/accounts/AccountManager#KEY_CALLER_UID` The UID of caller app. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/accounts/AccountManager#KEY_ERROR_CODE`
|
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/accounts/AccountManager#KEY_ERROR_MESSAGE`
|
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/accounts/AccountManager#KEY_INTENT` Bundle key used for an `https://developer.android.com/reference/android/content/Intent` in results from methods that may require the caller to interact with the user. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/accounts/AccountManager#KEY_LAST_AUTHENTICATED_TIME` Bundle key used to supply the last time the credentials of the account were authenticated successfully. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/accounts/AccountManager#KEY_PASSWORD` Bundle key used to supply the password directly in options to `https://developer.android.com/reference/android/accounts/AccountManager#confirmCredentials(android.accounts.Account,%20android.os.Bundle,%20android.app.Activity,%20android.accounts.AccountManagerCallback,%20android.os.Handler)`, rather than prompting the user with the standard password prompt. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/accounts/AccountManager#KEY_USERDATA`
|
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/accounts/AccountManager#LOGIN_ACCOUNTS_CHANGED_ACTION` *This constant was deprecated in API level 26. use `https://developer.android.com/reference/android/accounts/AccountManager#addOnAccountsUpdatedListener(android.accounts.OnAccountsUpdateListener,%20android.os.Handler,%20boolean)` to get account updates in runtime.* |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/accounts/AccountManager#PACKAGE_NAME_KEY_LEGACY_NOT_VISIBLE` Key to set default visibility for applications which don't satisfy conditions in `https://developer.android.com/reference/android/accounts/AccountManager#PACKAGE_NAME_KEY_LEGACY_VISIBLE`. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/accounts/AccountManager#PACKAGE_NAME_KEY_LEGACY_VISIBLE` Key to set visibility for applications which satisfy one of the following conditions: - Target API level below `https://developer.android.com/reference/android/os/Build.VERSION_CODES#O` and have deprecated `https://developer.android.com/reference/android/Manifest.permission#GET_ACCOUNTS` permission.
|
| `int` | `https://developer.android.com/reference/android/accounts/AccountManager#VISIBILITY_NOT_VISIBLE` Account is not visible to given application and only authenticator can grant visibility. |
| `int` | `https://developer.android.com/reference/android/accounts/AccountManager#VISIBILITY_UNDEFINED` Account visibility was not set. |
| `int` | `https://developer.android.com/reference/android/accounts/AccountManager#VISIBILITY_USER_MANAGED_NOT_VISIBLE` Account is not visible to given application, but user can reveal it, for example, using `https://developer.android.com/reference/android/accounts/AccountManager#newChooseAccountIntent(android.accounts.Account,%20java.util.List,%20java.lang.String[],%20java.lang.String,%20java.lang.String,%20java.lang.String[],%20android.os.Bundle)` |
| `int` | `https://developer.android.com/reference/android/accounts/AccountManager#VISIBILITY_USER_MANAGED_VISIBLE` Account is visible to given application, but user can revoke visibility. |
| `int` | `https://developer.android.com/reference/android/accounts/AccountManager#VISIBILITY_VISIBLE` Account is always visible to given application and only authenticator can revoke visibility. |
| ### Public methods ||
|---|---|
| ` https://developer.android.com/reference/android/accounts/AccountManagerFuture` | ` https://developer.android.com/reference/android/accounts/AccountManager#addAccount(java.lang.String,%20java.lang.String,%20java.lang.String[],%20android.os.Bundle,%20android.app.Activity,%20android.accounts.AccountManagerCallback,%20android.os.Handler)(https://developer.android.com/reference/java/lang/String accountType, https://developer.android.com/reference/java/lang/String authTokenType, https://developer.android.com/reference/java/lang/String requiredFeatures, https://developer.android.com/reference/android/os/Bundle addAccountOptions, https://developer.android.com/reference/android/app/Activity activity, https://developer.android.com/reference/android/accounts/AccountManagerCallback callback, https://developer.android.com/reference/android/os/Handler handler) ` Asks the user to add an account of a specified type. |
| ` boolean` | ` https://developer.android.com/reference/android/accounts/AccountManager#addAccountExplicitly(android.accounts.Account,%20java.lang.String,%20android.os.Bundle)(https://developer.android.com/reference/android/accounts/Account account, https://developer.android.com/reference/java/lang/String password, https://developer.android.com/reference/android/os/Bundle userdata) ` Adds an account directly to the AccountManager. |
| ` boolean` | ` https://developer.android.com/reference/android/accounts/AccountManager#addAccountExplicitly(android.accounts.Account,%20java.lang.String,%20android.os.Bundle,%20java.util.Map)(https://developer.android.com/reference/android/accounts/Account account, https://developer.android.com/reference/java/lang/String password, https://developer.android.com/reference/android/os/Bundle extras, https://developer.android.com/reference/java/util/Map visibility) ` Adds an account directly to the AccountManager. |
| ` void` | ` https://developer.android.com/reference/android/accounts/AccountManager#addOnAccountsUpdatedListener(android.accounts.OnAccountsUpdateListener,%20android.os.Handler,%20boolean,%20java.lang.String[])(https://developer.android.com/reference/android/accounts/OnAccountsUpdateListener listener, https://developer.android.com/reference/android/os/Handler handler, boolean updateImmediately, https://developer.android.com/reference/java/lang/String accountTypes) ` Adds an `https://developer.android.com/reference/android/accounts/OnAccountsUpdateListener` to this instance of the `https://developer.android.com/reference/android/accounts/AccountManager`. |
| ` void` | ` https://developer.android.com/reference/android/accounts/AccountManager#addOnAccountsUpdatedListener(android.accounts.OnAccountsUpdateListener,%20android.os.Handler,%20boolean)(https://developer.android.com/reference/android/accounts/OnAccountsUpdateListener listener, https://developer.android.com/reference/android/os/Handler handler, boolean updateImmediately) ` Adds an `https://developer.android.com/reference/android/accounts/OnAccountsUpdateListener` to this instance of the `https://developer.android.com/reference/android/accounts/AccountManager`. |
| ` https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/android/accounts/AccountManager#blockingGetAuthToken(android.accounts.Account,%20java.lang.String,%20boolean)(https://developer.android.com/reference/android/accounts/Account account, https://developer.android.com/reference/java/lang/String authTokenType, boolean notifyAuthFailure) ` This convenience helper synchronously gets an auth token with `https://developer.android.com/reference/android/accounts/AccountManager#getAuthToken(android.accounts.Account,%20java.lang.String,%20boolean,%20android.accounts.AccountManagerCallback,%20android.os.Handler)`. |
| ` void` | ` https://developer.android.com/reference/android/accounts/AccountManager#clearPassword(android.accounts.Account)(https://developer.android.com/reference/android/accounts/Account account) ` Forgets a saved password. |
| ` https://developer.android.com/reference/android/accounts/AccountManagerFuture` | ` https://developer.android.com/reference/android/accounts/AccountManager#confirmCredentials(android.accounts.Account,%20android.os.Bundle,%20android.app.Activity,%20android.accounts.AccountManagerCallback,%20android.os.Handler)(https://developer.android.com/reference/android/accounts/Account account, https://developer.android.com/reference/android/os/Bundle options, https://developer.android.com/reference/android/app/Activity activity, https://developer.android.com/reference/android/accounts/AccountManagerCallback callback, https://developer.android.com/reference/android/os/Handler handler) ` Confirms that the user knows the password for an account to make extra sure they are the owner of the account. |
| ` https://developer.android.com/reference/android/accounts/AccountManagerFuture` | ` https://developer.android.com/reference/android/accounts/AccountManager#editProperties(java.lang.String,%20android.app.Activity,%20android.accounts.AccountManagerCallback,%20android.os.Handler)(https://developer.android.com/reference/java/lang/String accountType, https://developer.android.com/reference/android/app/Activity activity, https://developer.android.com/reference/android/accounts/AccountManagerCallback callback, https://developer.android.com/reference/android/os/Handler handler) ` Offers the user an opportunity to change an authenticator's settings. |
| ` https://developer.android.com/reference/android/accounts/AccountManagerFuture` | ` https://developer.android.com/reference/android/accounts/AccountManager#finishSession(android.os.Bundle,%20android.app.Activity,%20android.accounts.AccountManagerCallback,%20android.os.Handler)(https://developer.android.com/reference/android/os/Bundle sessionBundle, https://developer.android.com/reference/android/app/Activity activity, https://developer.android.com/reference/android/accounts/AccountManagerCallback callback, https://developer.android.com/reference/android/os/Handler handler) ` Finishes the session started by `https://developer.android.com/reference/android/accounts/AccountManager#startAddAccountSession(java.lang.String,%20java.lang.String,%20java.lang.String[],%20android.os.Bundle,%20android.app.Activity,%20android.accounts.AccountManagerCallback,%20android.os.Handler)` or `https://developer.android.com/reference/android/accounts/AccountManager#startUpdateCredentialsSession(android.accounts.Account,%20java.lang.String,%20android.os.Bundle,%20android.app.Activity,%20android.accounts.AccountManagerCallback,%20android.os.Handler)`. |
| ` static https://developer.android.com/reference/android/accounts/AccountManager` | ` https://developer.android.com/reference/android/accounts/AccountManager#get(android.content.Context)(https://developer.android.com/reference/android/content/Context context) ` Gets an AccountManager instance associated with a Context. |
| ` int` | ` https://developer.android.com/reference/android/accounts/AccountManager#getAccountVisibility(android.accounts.Account,%20java.lang.String)(https://developer.android.com/reference/android/accounts/Account account, https://developer.android.com/reference/java/lang/String packageName) ` Get visibility of certain account for given application. |
| ` https://developer.android.com/reference/android/accounts/Account` | ` https://developer.android.com/reference/android/accounts/AccountManager#getAccounts()() ` Lists all accounts visible to the caller regardless of type. |
| ` https://developer.android.com/reference/java/util/Map` | ` https://developer.android.com/reference/android/accounts/AccountManager#getAccountsAndVisibilityForPackage(java.lang.String,%20java.lang.String)(https://developer.android.com/reference/java/lang/String packageName, https://developer.android.com/reference/java/lang/String accountType) ` Gets all accounts of given type and their visibility for specific package. |
| ` https://developer.android.com/reference/android/accounts/Account` | ` https://developer.android.com/reference/android/accounts/AccountManager#getAccountsByType(java.lang.String)(https://developer.android.com/reference/java/lang/String type) ` Lists all accounts of particular type visible to the caller. |
| ` https://developer.android.com/reference/android/accounts/AccountManagerFuture` | ` https://developer.android.com/reference/android/accounts/AccountManager#getAccountsByTypeAndFeatures(java.lang.String,%20java.lang.String[],%20android.accounts.AccountManagerCallback,%20android.os.Handler)(https://developer.android.com/reference/java/lang/String type, https://developer.android.com/reference/java/lang/String features, https://developer.android.com/reference/android/accounts/AccountManagerCallback callback, https://developer.android.com/reference/android/os/Handler handler) ` Lists all accounts of a type which have certain features. |
| ` https://developer.android.com/reference/android/accounts/Account` | ` https://developer.android.com/reference/android/accounts/AccountManager#getAccountsByTypeForPackage(java.lang.String,%20java.lang.String)(https://developer.android.com/reference/java/lang/String type, https://developer.android.com/reference/java/lang/String packageName) ` Returns the accounts visible to the specified package in an environment where some apps are not authorized to view all accounts. |
| ` https://developer.android.com/reference/android/accounts/AccountManagerFuture` | ` https://developer.android.com/reference/android/accounts/AccountManager#getAuthToken(android.accounts.Account,%20java.lang.String,%20android.os.Bundle,%20boolean,%20android.accounts.AccountManagerCallback,%20android.os.Handler)(https://developer.android.com/reference/android/accounts/Account account, https://developer.android.com/reference/java/lang/String authTokenType, https://developer.android.com/reference/android/os/Bundle options, boolean notifyAuthFailure, https://developer.android.com/reference/android/accounts/AccountManagerCallback callback, https://developer.android.com/reference/android/os/Handler handler) ` Gets an auth token of the specified type for a particular account, optionally raising a notification if the user must enter credentials. |
| ` https://developer.android.com/reference/android/accounts/AccountManagerFuture` | ` https://developer.android.com/reference/android/accounts/AccountManager#getAuthToken(android.accounts.Account,%20java.lang.String,%20android.os.Bundle,%20android.app.Activity,%20android.accounts.AccountManagerCallback,%20android.os.Handler)(https://developer.android.com/reference/android/accounts/Account account, https://developer.android.com/reference/java/lang/String authTokenType, https://developer.android.com/reference/android/os/Bundle options, https://developer.android.com/reference/android/app/Activity activity, https://developer.android.com/reference/android/accounts/AccountManagerCallback callback, https://developer.android.com/reference/android/os/Handler handler) ` Gets an auth token of the specified type for a particular account, prompting the user for credentials if necessary. |
| ` https://developer.android.com/reference/android/accounts/AccountManagerFuture` | ` https://developer.android.com/reference/android/accounts/AccountManager#getAuthToken(android.accounts.Account,%20java.lang.String,%20boolean,%20android.accounts.AccountManagerCallback,%20android.os.Handler)(https://developer.android.com/reference/android/accounts/Account account, https://developer.android.com/reference/java/lang/String authTokenType, boolean notifyAuthFailure, https://developer.android.com/reference/android/accounts/AccountManagerCallback callback, https://developer.android.com/reference/android/os/Handler handler) ` *This method was deprecated in API level 15. use `https://developer.android.com/reference/android/accounts/AccountManager#getAuthToken(android.accounts.Account,%20java.lang.String,%20android.os.Bundle,%20boolean,%20android.accounts.AccountManagerCallback,%20android.os.Handler)` instead* |
| ` https://developer.android.com/reference/android/accounts/AccountManagerFuture` | ` https://developer.android.com/reference/android/accounts/AccountManager#getAuthTokenByFeatures(java.lang.String,%20java.lang.String,%20java.lang.String[],%20android.app.Activity,%20android.os.Bundle,%20android.os.Bundle,%20android.accounts.AccountManagerCallback,%20android.os.Handler)(https://developer.android.com/reference/java/lang/String accountType, https://developer.android.com/reference/java/lang/String authTokenType, https://developer.android.com/reference/java/lang/String features, https://developer.android.com/reference/android/app/Activity activity, https://developer.android.com/reference/android/os/Bundle addAccountOptions, https://developer.android.com/reference/android/os/Bundle getAuthTokenOptions, https://developer.android.com/reference/android/accounts/AccountManagerCallback callback, https://developer.android.com/reference/android/os/Handler handler) ` This convenience helper combines the functionality of `https://developer.android.com/reference/android/accounts/AccountManager#getAccountsByTypeAndFeatures(java.lang.String,%20java.lang.String[],%20android.accounts.AccountManagerCallback,%20android.os.Handler)`, `https://developer.android.com/reference/android/accounts/AccountManager#getAuthToken(android.accounts.Account,%20java.lang.String,%20android.os.Bundle,%20android.app.Activity,%20android.accounts.AccountManagerCallback,%20android.os.Handler)`, and `https://developer.android.com/reference/android/accounts/AccountManager#addAccount(java.lang.String,%20java.lang.String,%20java.lang.String[],%20android.os.Bundle,%20android.app.Activity,%20android.accounts.AccountManagerCallback,%20android.os.Handler)`. |
| ` https://developer.android.com/reference/android/accounts/AuthenticatorDescription` | ` https://developer.android.com/reference/android/accounts/AccountManager#getAuthenticatorTypes()() ` Lists the currently registered authenticators. |
| ` https://developer.android.com/reference/java/util/Map` | ` https://developer.android.com/reference/android/accounts/AccountManager#getPackagesAndVisibilityForAccount(android.accounts.Account)(https://developer.android.com/reference/android/accounts/Account account) ` Returns package names and visibility which were explicitly set for given account. |
| ` https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/android/accounts/AccountManager#getPassword(android.accounts.Account)(https://developer.android.com/reference/android/accounts/Account account) ` Gets the saved password associated with the account. |
| ` https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/android/accounts/AccountManager#getPreviousName(android.accounts.Account)(https://developer.android.com/reference/android/accounts/Account account) ` Gets the previous name associated with the account or `null`, if none. |
| ` https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/android/accounts/AccountManager#getUserData(android.accounts.Account,%20java.lang.String)(https://developer.android.com/reference/android/accounts/Account account, https://developer.android.com/reference/java/lang/String key) ` Gets the user data named by "key" associated with the account. |
| ` https://developer.android.com/reference/android/accounts/AccountManagerFuture` | ` https://developer.android.com/reference/android/accounts/AccountManager#hasFeatures(android.accounts.Account,%20java.lang.String[],%20android.accounts.AccountManagerCallback,%20android.os.Handler)(https://developer.android.com/reference/android/accounts/Account account, https://developer.android.com/reference/java/lang/String features, https://developer.android.com/reference/android/accounts/AccountManagerCallback callback, https://developer.android.com/reference/android/os/Handler handler) ` Finds out whether a particular account has all the specified features. |
| ` void` | ` https://developer.android.com/reference/android/accounts/AccountManager#invalidateAuthToken(java.lang.String,%20java.lang.String)(https://developer.android.com/reference/java/lang/String accountType, https://developer.android.com/reference/java/lang/String authToken) ` Removes an auth token from the AccountManager's cache. |
| ` https://developer.android.com/reference/android/accounts/AccountManagerFuture` | ` https://developer.android.com/reference/android/accounts/AccountManager#isCredentialsUpdateSuggested(android.accounts.Account,%20java.lang.String,%20android.accounts.AccountManagerCallback,%20android.os.Handler)(https://developer.android.com/reference/android/accounts/Account account, https://developer.android.com/reference/java/lang/String statusToken, https://developer.android.com/reference/android/accounts/AccountManagerCallback callback, https://developer.android.com/reference/android/os/Handler handler) ` Checks whether `https://developer.android.com/reference/android/accounts/AccountManager#updateCredentials(android.accounts.Account,%20java.lang.String,%20android.os.Bundle,%20android.app.Activity,%20android.accounts.AccountManagerCallback,%20android.os.Handler)` or `https://developer.android.com/reference/android/accounts/AccountManager#startUpdateCredentialsSession(android.accounts.Account,%20java.lang.String,%20android.os.Bundle,%20android.app.Activity,%20android.accounts.AccountManagerCallback,%20android.os.Handler)` should be called with respect to the specified account. |
| ` static https://developer.android.com/reference/android/content/Intent` | ` https://developer.android.com/reference/android/accounts/AccountManager#newChooseAccountIntent(android.accounts.Account,%20java.util.List,%20java.lang.String[],%20java.lang.String,%20java.lang.String,%20java.lang.String[],%20android.os.Bundle)(https://developer.android.com/reference/android/accounts/Account selectedAccount, https://developer.android.com/reference/java/util/List allowableAccounts, https://developer.android.com/reference/java/lang/String allowableAccountTypes, https://developer.android.com/reference/java/lang/String descriptionOverrideText, https://developer.android.com/reference/java/lang/String addAccountAuthTokenType, https://developer.android.com/reference/java/lang/String addAccountRequiredFeatures, https://developer.android.com/reference/android/os/Bundle addAccountOptions) ` Returns an intent to an `https://developer.android.com/reference/android/app/Activity` that prompts the user to choose from a list of accounts. |
| ` static https://developer.android.com/reference/android/content/Intent` | ` https://developer.android.com/reference/android/accounts/AccountManager#newChooseAccountIntent(android.accounts.Account,%20java.util.ArrayList,%20java.lang.String[],%20boolean,%20java.lang.String,%20java.lang.String,%20java.lang.String[],%20android.os.Bundle)(https://developer.android.com/reference/android/accounts/Account selectedAccount, https://developer.android.com/reference/java/util/ArrayList allowableAccounts, https://developer.android.com/reference/java/lang/String allowableAccountTypes, boolean alwaysPromptForAccount, https://developer.android.com/reference/java/lang/String descriptionOverrideText, https://developer.android.com/reference/java/lang/String addAccountAuthTokenType, https://developer.android.com/reference/java/lang/String addAccountRequiredFeatures, https://developer.android.com/reference/android/os/Bundle addAccountOptions) ` Deprecated in favor of `https://developer.android.com/reference/android/accounts/AccountManager#newChooseAccountIntent(android.accounts.Account,%20java.util.List,%20java.lang.String[],%20java.lang.String,%20java.lang.String,%20java.lang.String[],%20android.os.Bundle)`. |
| ` boolean` | ` https://developer.android.com/reference/android/accounts/AccountManager#notifyAccountAuthenticated(android.accounts.Account)(https://developer.android.com/reference/android/accounts/Account account) ` Notifies the system that the account has just been authenticated. |
| ` https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/android/accounts/AccountManager#peekAuthToken(android.accounts.Account,%20java.lang.String)(https://developer.android.com/reference/android/accounts/Account account, https://developer.android.com/reference/java/lang/String authTokenType) ` Gets an auth token from the AccountManager's cache. |
| ` https://developer.android.com/reference/android/accounts/AccountManagerFuture` | ` https://developer.android.com/reference/android/accounts/AccountManager#removeAccount(android.accounts.Account,%20android.app.Activity,%20android.accounts.AccountManagerCallback,%20android.os.Handler)(https://developer.android.com/reference/android/accounts/Account account, https://developer.android.com/reference/android/app/Activity activity, https://developer.android.com/reference/android/accounts/AccountManagerCallback callback, https://developer.android.com/reference/android/os/Handler handler) ` Removes an account from the AccountManager. |
| ` https://developer.android.com/reference/android/accounts/AccountManagerFuture` | ` https://developer.android.com/reference/android/accounts/AccountManager#removeAccount(android.accounts.Account,%20android.accounts.AccountManagerCallback,%20android.os.Handler)(https://developer.android.com/reference/android/accounts/Account account, https://developer.android.com/reference/android/accounts/AccountManagerCallback callback, https://developer.android.com/reference/android/os/Handler handler) ` *This method was deprecated in API level 22. use `https://developer.android.com/reference/android/accounts/AccountManager#removeAccount(android.accounts.Account,%20android.app.Activity,%20android.accounts.AccountManagerCallback,%20android.os.Handler)` instead* |
| ` boolean` | ` https://developer.android.com/reference/android/accounts/AccountManager#removeAccountExplicitly(android.accounts.Account)(https://developer.android.com/reference/android/accounts/Account account) ` Removes an account directly. |
| ` void` | ` https://developer.android.com/reference/android/accounts/AccountManager#removeOnAccountsUpdatedListener(android.accounts.OnAccountsUpdateListener)(https://developer.android.com/reference/android/accounts/OnAccountsUpdateListener listener) ` Removes an `https://developer.android.com/reference/android/accounts/OnAccountsUpdateListener` previously registered with `https://developer.android.com/reference/android/accounts/AccountManager#addOnAccountsUpdatedListener(android.accounts.OnAccountsUpdateListener,%20android.os.Handler,%20boolean)`. |
| ` https://developer.android.com/reference/android/accounts/AccountManagerFuture` | ` https://developer.android.com/reference/android/accounts/AccountManager#renameAccount(android.accounts.Account,%20java.lang.String,%20android.accounts.AccountManagerCallback,%20android.os.Handler)(https://developer.android.com/reference/android/accounts/Account account, https://developer.android.com/reference/java/lang/String newName, https://developer.android.com/reference/android/accounts/AccountManagerCallback callback, https://developer.android.com/reference/android/os/Handler handler) ` Rename the specified `https://developer.android.com/reference/android/accounts/Account`. |
| ` boolean` | ` https://developer.android.com/reference/android/accounts/AccountManager#setAccountVisibility(android.accounts.Account,%20java.lang.String,%20int)(https://developer.android.com/reference/android/accounts/Account account, https://developer.android.com/reference/java/lang/String packageName, int visibility) ` Set visibility value of given account to certain package. |
| ` void` | ` https://developer.android.com/reference/android/accounts/AccountManager#setAuthToken(android.accounts.Account,%20java.lang.String,%20java.lang.String)(https://developer.android.com/reference/android/accounts/Account account, https://developer.android.com/reference/java/lang/String authTokenType, https://developer.android.com/reference/java/lang/String authToken) ` Adds an auth token to the AccountManager cache for an account. |
| ` void` | ` https://developer.android.com/reference/android/accounts/AccountManager#setPassword(android.accounts.Account,%20java.lang.String)(https://developer.android.com/reference/android/accounts/Account account, https://developer.android.com/reference/java/lang/String password) ` Sets or forgets a saved password. |
| ` void` | ` https://developer.android.com/reference/android/accounts/AccountManager#setUserData(android.accounts.Account,%20java.lang.String,%20java.lang.String)(https://developer.android.com/reference/android/accounts/Account account, https://developer.android.com/reference/java/lang/String key, https://developer.android.com/reference/java/lang/String value) ` Sets one userdata key for an account. |
| ` https://developer.android.com/reference/android/accounts/AccountManagerFuture` | ` https://developer.android.com/reference/android/accounts/AccountManager#startAddAccountSession(java.lang.String,%20java.lang.String,%20java.lang.String[],%20android.os.Bundle,%20android.app.Activity,%20android.accounts.AccountManagerCallback,%20android.os.Handler)(https://developer.android.com/reference/java/lang/String accountType, https://developer.android.com/reference/java/lang/String authTokenType, https://developer.android.com/reference/java/lang/String requiredFeatures, https://developer.android.com/reference/android/os/Bundle options, https://developer.android.com/reference/android/app/Activity activity, https://developer.android.com/reference/android/accounts/AccountManagerCallback callback, https://developer.android.com/reference/android/os/Handler handler) ` Asks the user to authenticate with an account of a specified type. |
| ` https://developer.android.com/reference/android/accounts/AccountManagerFuture` | ` https://developer.android.com/reference/android/accounts/AccountManager#startUpdateCredentialsSession(android.accounts.Account,%20java.lang.String,%20android.os.Bundle,%20android.app.Activity,%20android.accounts.AccountManagerCallback,%20android.os.Handler)(https://developer.android.com/reference/android/accounts/Account account, https://developer.android.com/reference/java/lang/String authTokenType, https://developer.android.com/reference/android/os/Bundle options, https://developer.android.com/reference/android/app/Activity activity, https://developer.android.com/reference/android/accounts/AccountManagerCallback callback, https://developer.android.com/reference/android/os/Handler handler) ` Asks the user to enter a new password for the account but not updating the saved credentials for the account until `https://developer.android.com/reference/android/accounts/AccountManager#finishSession(android.os.Bundle,%20android.app.Activity,%20android.accounts.AccountManagerCallback,%20android.os.Handler)` is called. |
| ` https://developer.android.com/reference/android/accounts/AccountManagerFuture` | ` https://developer.android.com/reference/android/accounts/AccountManager#updateCredentials(android.accounts.Account,%20java.lang.String,%20android.os.Bundle,%20android.app.Activity,%20android.accounts.AccountManagerCallback,%20android.os.Handler)(https://developer.android.com/reference/android/accounts/Account account, https://developer.android.com/reference/java/lang/String authTokenType, https://developer.android.com/reference/android/os/Bundle options, https://developer.android.com/reference/android/app/Activity activity, https://developer.android.com/reference/android/accounts/AccountManagerCallback callback, https://developer.android.com/reference/android/os/Handler handler) ` Asks the user to enter a new password for an account, updating the saved credentials for the account. |
### Inherited methods
From class ` https://developer.android.com/reference/java/lang/Object ` ` https://developer.android.com/reference/java/lang/Object` ` https://developer.android.com/reference/java/lang/Object#clone()() `
Creates and returns a copy of this object.
` boolean` ` https://developer.android.com/reference/java/lang/Object#equals(java.lang.Object)(https://developer.android.com/reference/java/lang/Object obj) `
Indicates whether some other object is "equal to" this one.
` void` ` https://developer.android.com/reference/java/lang/Object#finalize()() `
Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
` final https://developer.android.com/reference/java/lang/Class` ` https://developer.android.com/reference/java/lang/Object#getClass()() `
Returns the runtime class of this `Object`.
` int` ` https://developer.android.com/reference/java/lang/Object#hashCode()() `
Returns a hash code value for the object.
` final void` ` https://developer.android.com/reference/java/lang/Object#notify()() `
Wakes up a single thread that is waiting on this object's monitor.
` final void` ` https://developer.android.com/reference/java/lang/Object#notifyAll()() `
Wakes up all threads that are waiting on this object's monitor.
` https://developer.android.com/reference/java/lang/String` ` https://developer.android.com/reference/java/lang/Object#toString()() `
Returns a string representation of the object.
` final void` ` https://developer.android.com/reference/java/lang/Object#wait(long,%20int)(long timeoutMillis, int nanos) `
Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*, or until a certain amount of real time has elapsed.
` final void` ` https://developer.android.com/reference/java/lang/Object#wait(long)(long timeoutMillis) `
Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*, or until a certain amount of real time has elapsed.
` final void` ` https://developer.android.com/reference/java/lang/Object#wait()() `
Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*.
## Constants
### ACTION_ACCOUNT_REMOVED
Added in [API level 26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String ACTION_ACCOUNT_REMOVED
```
Action sent as a broadcast Intent by the AccountsService when any account is removed or renamed. Only applications which were able to see the account will receive the intent. Intent extra will include the following fields:
- `https://developer.android.com/reference/android/accounts/AccountManager#KEY_ACCOUNT_NAME` - the name of the removed account
- `https://developer.android.com/reference/android/accounts/AccountManager#KEY_ACCOUNT_TYPE` - the type of the account
Constant Value: "android.accounts.action.ACCOUNT_REMOVED"
### ACTION_AUTHENTICATOR_INTENT
Added in [API level 5](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String ACTION_AUTHENTICATOR_INTENT
```
Constant Value: "android.accounts.AccountAuthenticator"
### AUTHENTICATOR_ATTRIBUTES_NAME
Added in [API level 5](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String AUTHENTICATOR_ATTRIBUTES_NAME
```
Constant Value: "account-authenticator"
### AUTHENTICATOR_META_DATA_NAME
Added in [API level 5](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String AUTHENTICATOR_META_DATA_NAME
```
Constant Value: "android.accounts.AccountAuthenticator"
### ERROR_CODE_BAD_ARGUMENTS
Added in [API level 5](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int ERROR_CODE_BAD_ARGUMENTS
```
Constant Value: 7 (0x00000007)
### ERROR_CODE_BAD_AUTHENTICATION
Added in [API level 18](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int ERROR_CODE_BAD_AUTHENTICATION
```
Constant Value: 9 (0x00000009)
### ERROR_CODE_BAD_REQUEST
Added in [API level 5](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int ERROR_CODE_BAD_REQUEST
```
Constant Value: 8 (0x00000008)
### ERROR_CODE_CANCELED
Added in [API level 5](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int ERROR_CODE_CANCELED
```
Constant Value: 4 (0x00000004)
### ERROR_CODE_INVALID_RESPONSE
Added in [API level 5](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int ERROR_CODE_INVALID_RESPONSE
```
Constant Value: 5 (0x00000005)
### ERROR_CODE_NETWORK_ERROR
Added in [API level 5](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int ERROR_CODE_NETWORK_ERROR
```
Constant Value: 3 (0x00000003)
### ERROR_CODE_REMOTE_EXCEPTION
Added in [API level 5](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int ERROR_CODE_REMOTE_EXCEPTION
```
Constant Value: 1 (0x00000001)
### ERROR_CODE_UNSUPPORTED_OPERATION
Added in [API level 5](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int ERROR_CODE_UNSUPPORTED_OPERATION
```
Constant Value: 6 (0x00000006)
### KEY_ACCOUNTS
Added in [API level 5](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String KEY_ACCOUNTS
```
Constant Value: "accounts"
### KEY_ACCOUNT_AUTHENTICATOR_RESPONSE
Added in [API level 5](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String KEY_ACCOUNT_AUTHENTICATOR_RESPONSE
```
Constant Value: "accountAuthenticatorResponse"
### KEY_ACCOUNT_MANAGER_RESPONSE
Added in [API level 5](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String KEY_ACCOUNT_MANAGER_RESPONSE
```
Constant Value: "accountManagerResponse"
### KEY_ACCOUNT_NAME
Added in [API level 5](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String KEY_ACCOUNT_NAME
```
Bundle key used for the `https://developer.android.com/reference/java/lang/String` account name in results from methods which return information about a particular account.
Constant Value: "authAccount"
### KEY_ACCOUNT_SESSION_BUNDLE
Added in [API level 26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String KEY_ACCOUNT_SESSION_BUNDLE
```
Bundle key used for a `https://developer.android.com/reference/android/os/Bundle` in result from `https://developer.android.com/reference/android/accounts/AccountManager#startAddAccountSession(java.lang.String,%20java.lang.String,%20java.lang.String[],%20android.os.Bundle,%20android.app.Activity,%20android.accounts.AccountManagerCallback,%20android.os.Handler)` and friends which returns session data for installing an account later.
Constant Value: "accountSessionBundle"
### KEY_ACCOUNT_STATUS_TOKEN
Added in [API level 26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String KEY_ACCOUNT_STATUS_TOKEN
```
Bundle key used for the `https://developer.android.com/reference/java/lang/String` account status token in result from `https://developer.android.com/reference/android/accounts/AccountManager#startAddAccountSession(java.lang.String,%20java.lang.String,%20java.lang.String[],%20android.os.Bundle,%20android.app.Activity,%20android.accounts.AccountManagerCallback,%20android.os.Handler)` and friends which returns information about a particular account.
Constant Value: "accountStatusToken"
### KEY_ACCOUNT_TYPE
Added in [API level 5](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String KEY_ACCOUNT_TYPE
```
Bundle key used for the `https://developer.android.com/reference/java/lang/String` account type in results from methods which return information about a particular account.
Constant Value: "accountType"
### KEY_ANDROID_PACKAGE_NAME
Added in [API level 14](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String KEY_ANDROID_PACKAGE_NAME
```
The Android package of the caller will be set in the options bundle by the `https://developer.android.com/reference/android/accounts/AccountManager` and will be passed to the AccountManagerService and to the AccountAuthenticators. The uid of the caller will be known by the AccountManagerService as well as the AccountAuthenticators so they will be able to verify that the package is consistent with the uid (a uid might be shared by many packages).
Constant Value: "androidPackageName"
### KEY_AUTHENTICATOR_TYPES
Added in [API level 5](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String KEY_AUTHENTICATOR_TYPES
```
Constant Value: "authenticator_types"
### KEY_AUTHTOKEN
Added in [API level 5](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String KEY_AUTHTOKEN
```
Bundle key used for the auth token value in results from `https://developer.android.com/reference/android/accounts/AccountManager#getAuthToken(android.accounts.Account,%20java.lang.String,%20android.os.Bundle,%20android.app.Activity,%20android.accounts.AccountManagerCallback,%20android.os.Handler)` and friends.
Constant Value: "authtoken"
### KEY_AUTH_FAILED_MESSAGE
Added in [API level 5](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String KEY_AUTH_FAILED_MESSAGE
```
Constant Value: "authFailedMessage"
### KEY_AUTH_TOKEN_LABEL
Added in [API level 5](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String KEY_AUTH_TOKEN_LABEL
```
Constant Value: "authTokenLabelKey"
### KEY_BOOLEAN_RESULT
Added in [API level 5](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String KEY_BOOLEAN_RESULT
```
Constant Value: "booleanResult"
### KEY_CALLER_PID
Added in [API level 11](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String KEY_CALLER_PID
```
The process id of caller app.
Constant Value: "callerPid"
### KEY_CALLER_UID
Added in [API level 11](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String KEY_CALLER_UID
```
The UID of caller app.
Constant Value: "callerUid"
### KEY_ERROR_CODE
Added in [API level 5](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String KEY_ERROR_CODE
```
Constant Value: "errorCode"
### KEY_ERROR_MESSAGE
Added in [API level 5](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String KEY_ERROR_MESSAGE
```
Constant Value: "errorMessage"
### KEY_INTENT
Added in [API level 5](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String KEY_INTENT
```
Bundle key used for an `https://developer.android.com/reference/android/content/Intent` in results from methods that may require the caller to interact with the user. The Intent can be used to start the corresponding user interface activity.
Constant Value: "intent"
### KEY_LAST_AUTHENTICATED_TIME
Added in [API level 23](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String KEY_LAST_AUTHENTICATED_TIME
```
Bundle key used to supply the last time the credentials of the account were authenticated successfully. Time is specified in milliseconds since epoch. Associated time is updated on successful authentication of account on adding account, confirming credentials, or updating credentials.
Constant Value: "lastAuthenticatedTime"
### KEY_PASSWORD
Added in [API level 5](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String KEY_PASSWORD
```
Bundle key used to supply the password directly in options to `https://developer.android.com/reference/android/accounts/AccountManager#confirmCredentials(android.accounts.Account,%20android.os.Bundle,%20android.app.Activity,%20android.accounts.AccountManagerCallback,%20android.os.Handler)`, rather than prompting the user with the standard password prompt.
Constant Value: "password"
### KEY_USERDATA
Added in [API level 5](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String KEY_USERDATA
```
Constant Value: "userdata"
### LOGIN_ACCOUNTS_CHANGED_ACTION
Added in [API level 5](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
Deprecated in [API level 26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String LOGIN_ACCOUNTS_CHANGED_ACTION
```
**This constant was deprecated in API level 26.**
use `https://developer.android.com/reference/android/accounts/AccountManager#addOnAccountsUpdatedListener(android.accounts.OnAccountsUpdateListener,%20android.os.Handler,%20boolean)` to get account updates in runtime.
Action sent as a broadcast Intent by the AccountsService when accounts are added, accounts are removed, or an account's credentials (saved password, etc) are changed.
**See also:**
- `https://developer.android.com/reference/android/accounts/AccountManager#addOnAccountsUpdatedListener(android.accounts.OnAccountsUpdateListener,%20android.os.Handler,%20boolean)`
- `https://developer.android.com/reference/android/accounts/AccountManager#ACTION_ACCOUNT_REMOVED`
Constant Value: "android.accounts.LOGIN_ACCOUNTS_CHANGED"
### PACKAGE_NAME_KEY_LEGACY_NOT_VISIBLE
Added in [API level 26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String PACKAGE_NAME_KEY_LEGACY_NOT_VISIBLE
```
Key to set default visibility for applications which don't satisfy conditions in `https://developer.android.com/reference/android/accounts/AccountManager#PACKAGE_NAME_KEY_LEGACY_VISIBLE`. If the value was not set by authenticator `https://developer.android.com/reference/android/accounts/AccountManager#VISIBILITY_USER_MANAGED_NOT_VISIBLE` is used.
Constant Value: "android:accounts:key_legacy_not_visible"
### PACKAGE_NAME_KEY_LEGACY_VISIBLE
Added in [API level 26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String PACKAGE_NAME_KEY_LEGACY_VISIBLE
```
Key to set visibility for applications which satisfy one of the following conditions:
- Target API level below `https://developer.android.com/reference/android/os/Build.VERSION_CODES#O` and have deprecated `https://developer.android.com/reference/android/Manifest.permission#GET_ACCOUNTS` permission.
- Have `https://developer.android.com/reference/android/Manifest.permission#GET_ACCOUNTS_PRIVILEGED` permission.
- Have the same signature as authenticator.
- Have `https://developer.android.com/reference/android/Manifest.permission#READ_CONTACTS` permission and account type may be associated with contacts data - (verified by `https://developer.android.com/reference/android/Manifest.permission#WRITE_CONTACTS` permission check for the authenticator).
See `https://developer.android.com/reference/android/accounts/AccountManager#getAccountVisibility(android.accounts.Account,%20java.lang.String)`. If the value was not set by authenticator `https://developer.android.com/reference/android/accounts/AccountManager#VISIBILITY_USER_MANAGED_VISIBLE` is used.
Constant Value: "android:accounts:key_legacy_visible"
### VISIBILITY_NOT_VISIBLE
Added in [API level 26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int VISIBILITY_NOT_VISIBLE
```
Account is not visible to given application and only authenticator can grant visibility.
Constant Value: 3 (0x00000003)
### VISIBILITY_UNDEFINED
Added in [API level 26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int VISIBILITY_UNDEFINED
```
Account visibility was not set. Default visibility value will be used. See `https://developer.android.com/reference/android/accounts/AccountManager#PACKAGE_NAME_KEY_LEGACY_VISIBLE`, `https://developer.android.com/reference/android/accounts/AccountManager#PACKAGE_NAME_KEY_LEGACY_NOT_VISIBLE`
Constant Value: 0 (0x00000000)
### VISIBILITY_USER_MANAGED_NOT_VISIBLE
Added in [API level 26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int VISIBILITY_USER_MANAGED_NOT_VISIBLE
```
Account is not visible to given application, but user can reveal it, for example, using `https://developer.android.com/reference/android/accounts/AccountManager#newChooseAccountIntent(android.accounts.Account,%20java.util.List,%20java.lang.String[],%20java.lang.String,%20java.lang.String,%20java.lang.String[],%20android.os.Bundle)`
Constant Value: 4 (0x00000004)
### VISIBILITY_USER_MANAGED_VISIBLE
Added in [API level 26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int VISIBILITY_USER_MANAGED_VISIBLE
```
Account is visible to given application, but user can revoke visibility.
Constant Value: 2 (0x00000002)
### VISIBILITY_VISIBLE
Added in [API level 26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int VISIBILITY_VISIBLE
```
Account is always visible to given application and only authenticator can revoke visibility.
Constant Value: 1 (0x00000001)
## Public methods
### addAccount
Added in [API level 5](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public AccountManagerFuture addAccount (String accountType,
String authTokenType,
String[] requiredFeatures,
Bundle addAccountOptions,
Activity activity,
AccountManagerCallback callback,
Handler handler)
```
Asks the user to add an account of a specified type. The authenticator for this account type processes this request with the appropriate user interface. If the user does elect to create a new account, the account name is returned.
This method may be called from any thread, but the returned `https://developer.android.com/reference/android/accounts/AccountManagerFuture` must not be used on the main thread.
**NOTE:** If targeting your app to work on API level 22 and before, MANAGE_ACCOUNTS permission is needed for those platforms. See docs for this function in API level 22.
Requires android.Manifest.permission.MANAGE_ACCOUNTS
| Parameters ||
|---|---|
| `accountType` | `String`: The type of account to add; must not be null
|
| `authTokenType` | `String`: The type of auth token (see `https://developer.android.com/reference/android/accounts/AccountManager#getAuthToken(android.accounts.Account,%20java.lang.String,%20android.os.Bundle,%20android.app.Activity,%20android.accounts.AccountManagerCallback,%20android.os.Handler)`) this account will need to be able to generate, null for none
|
| `requiredFeatures` | `String`: The features (see `https://developer.android.com/reference/android/accounts/AccountManager#hasFeatures(android.accounts.Account,%20java.lang.String[],%20android.accounts.AccountManagerCallback,%20android.os.Handler)`) this account must have, null for none
|
| `addAccountOptions` | `Bundle`: Authenticator-specific options for the request, may be null or empty
|
| `activity` | `Activity`: The `https://developer.android.com/reference/android/app/Activity` context to use for launching a new authenticator-defined sub-Activity to prompt the user to create an account; used only to call startActivity(); if null, the prompt will not be launched directly, but the necessary `https://developer.android.com/reference/android/content/Intent` will be returned to the caller instead
|
| `callback` | `AccountManagerCallback`: Callback to invoke when the request completes, null for no callback
|
| `handler` | `Handler`: `https://developer.android.com/reference/android/os/Handler` identifying the callback thread, null for the main thread
|
| Returns ||
|---|---|
| `https://developer.android.com/reference/android/accounts/AccountManagerFuture` | An `https://developer.android.com/reference/android/accounts/AccountManagerFuture` which resolves to a Bundle with these fields if activity was specified and an account was created: - `https://developer.android.com/reference/android/accounts/AccountManager#KEY_ACCOUNT_NAME` - the name of the account created - `https://developer.android.com/reference/android/accounts/AccountManager#KEY_ACCOUNT_TYPE` - the type of the account If no activity was specified, the returned Bundle contains only `https://developer.android.com/reference/android/accounts/AccountManager#KEY_INTENT` with the `https://developer.android.com/reference/android/content/Intent` needed to launch the actual account creation process. If an error occurred, `https://developer.android.com/reference/android/accounts/AccountManagerFuture#getResult()` throws: - `https://developer.android.com/reference/android/accounts/AuthenticatorException` if no authenticator was registered for this account type or the authenticator failed to respond - `https://developer.android.com/reference/android/accounts/OperationCanceledException` if the operation was canceled for any reason, including the user canceling the creation process or adding accounts (of this type) has been disabled by policy - `https://developer.android.com/reference/java/io/IOException` if the authenticator experienced an I/O problem creating a new account, usually because of network trouble
|
### addAccountExplicitly
Added in [API level 5](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public boolean addAccountExplicitly (Account account,
String password,
Bundle userdata)
```
Adds an account directly to the AccountManager. Normally used by sign-up wizards associated with authenticators, not directly by applications.
Calling this method does not update the last authenticated timestamp, referred by `https://developer.android.com/reference/android/accounts/AccountManager#KEY_LAST_AUTHENTICATED_TIME`. To update it, call `https://developer.android.com/reference/android/accounts/AccountManager#notifyAccountAuthenticated(android.accounts.Account)` after getting success. However, if this method is called when it is triggered by addAccount() or addAccountAsUser() or similar functions, then there is no need to update timestamp manually as it is updated automatically by framework on successful completion of the mentioned functions.
It is safe to call this method from the main thread.
This method requires the caller to have a signature match with the authenticator that owns the specified account.
**NOTE:** If targeting your app to work on API level 22 and before, AUTHENTICATE_ACCOUNTS permission is needed for those platforms. See docs for this function in API level 22.
Requires android.Manifest.permission.AUTHENTICATE_ACCOUNTS
| Parameters ||
|---|---|
| `account` | `Account`: The `https://developer.android.com/reference/android/accounts/Account` to add
|
| `password` | `String`: The password to associate with the account, null for none
|
| `userdata` | `Bundle`: String values to use for the account's userdata, null for none
|
| Returns ||
|---|---|
| `boolean` | True if the account was successfully added, false if the account already exists, the account is null, the user is locked, or another error occurs.
|
### addAccountExplicitly
Added in [API level 26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public boolean addAccountExplicitly (Account account,
String password,
Bundle extras,
Map visibility)
```
Adds an account directly to the AccountManager. Additionally it specifies Account visibility for given list of packages.
Normally used by sign-up wizards associated with authenticators, not directly by applications.
Calling this method does not update the last authenticated timestamp, referred by `https://developer.android.com/reference/android/accounts/AccountManager#KEY_LAST_AUTHENTICATED_TIME`. To update it, call `https://developer.android.com/reference/android/accounts/AccountManager#notifyAccountAuthenticated(android.accounts.Account)` after getting success.
It is safe to call this method from the main thread.
This method requires the caller to have a signature match with the authenticator that owns the specified account.
| Parameters ||
|---|---|
| `account` | `Account`: The `https://developer.android.com/reference/android/accounts/Account` to add
|
| `password` | `String`: The password to associate with the account, null for none
|
| `extras` | `Bundle`: String values to use for the account's userdata, null for none
|
| `visibility` | `Map`: Map from packageName to visibility values which will be set before account is added. See `https://developer.android.com/reference/android/accounts/AccountManager#getAccountVisibility(android.accounts.Account,%20java.lang.String)` for possible values. Declaring [package visibility](https://developer.android.com/training/basics/intents/package-visibility) needs for package names in the map is needed, if the caller is targeting API level 34 and above.
|
| Returns ||
|---|---|
| `boolean` | True if the account was successfully added, false if the account already exists, the account is null, or another error occurs.
|
### addOnAccountsUpdatedListener
Added in [API level 26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void addOnAccountsUpdatedListener (OnAccountsUpdateListener listener,
Handler handler,
boolean updateImmediately,
String[] accountTypes)
```
Adds an `https://developer.android.com/reference/android/accounts/OnAccountsUpdateListener` to this instance of the `https://developer.android.com/reference/android/accounts/AccountManager`. This listener will be notified whenever user or AbstractAccountAuthenticator made changes to accounts of given types related to the caller - either list of accounts returned by `https://developer.android.com/reference/android/accounts/AccountManager#getAccounts()` was changed, or new account was added for which user can grant access to the caller.
As long as this listener is present, the AccountManager instance will not be garbage-collected, and neither will the `https://developer.android.com/reference/android/content/Context` used to retrieve it, which may be a large Activity instance. To avoid memory leaks, you must remove this listener before then. Normally listeners are added in an Activity or Service's `https://developer.android.com/reference/android/app/Activity#onCreate(android.os.Bundle)` and removed in `https://developer.android.com/reference/android/app/Activity#onDestroy()`.
It is safe to call this method from the main thread.
| Parameters ||
|---|---|
| `listener` | `OnAccountsUpdateListener`: The listener to send notifications to
|
| `handler` | `Handler`: `https://developer.android.com/reference/android/os/Handler` identifying the thread to use for notifications, null for the main thread
|
| `updateImmediately` | `boolean`: If true, the listener will be invoked (on the handler thread) right away with the current account list
|
| `accountTypes` | `String`: If set, only changes to accounts of given types will be reported.
|
| Throws ||
|---|---|
| `https://developer.android.com/reference/java/lang/IllegalArgumentException` | if listener is null |
| `https://developer.android.com/reference/java/lang/IllegalStateException` | if listener was already added |
### addOnAccountsUpdatedListener
Added in [API level 5](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void addOnAccountsUpdatedListener (OnAccountsUpdateListener listener,
Handler handler,
boolean updateImmediately)
```
Adds an `https://developer.android.com/reference/android/accounts/OnAccountsUpdateListener` to this instance of the `https://developer.android.com/reference/android/accounts/AccountManager`. This listener will be notified whenever user or AbstractAccountAuthenticator made changes to accounts of any type related to the caller. This method is equivalent to addOnAccountsUpdatedListener(listener, handler, updateImmediately, null).
Requires `https://developer.android.com/reference/android/Manifest.permission#GET_ACCOUNTS`
| Parameters ||
|---|---|
| `listener` | `OnAccountsUpdateListener`
|
| `handler` | `Handler`
|
| `updateImmediately` | `boolean`
|
**See also:**
- `https://developer.android.com/reference/android/accounts/AccountManager#addOnAccountsUpdatedListener(android.accounts.OnAccountsUpdateListener,%20android.os.Handler,%20boolean,%20java.lang.String[])`
### blockingGetAuthToken
Added in [API level 5](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public String blockingGetAuthToken (Account account,
String authTokenType,
boolean notifyAuthFailure)
```
This convenience helper synchronously gets an auth token with `https://developer.android.com/reference/android/accounts/AccountManager#getAuthToken(android.accounts.Account,%20java.lang.String,%20boolean,%20android.accounts.AccountManagerCallback,%20android.os.Handler)`.
This method may block while a network request completes, and must never be made from the main thread.
**NOTE:** If targeting your app to work on API level 22 and before, USE_CREDENTIALS permission is needed for those platforms. See docs for this function in API level 22.
Requires android.Manifest.permission.USE_CREDENTIALS
| Parameters ||
|---|---|
| `account` | `Account`: The account to fetch an auth token for
|
| `authTokenType` | `String`: The auth token type, see `https://developer.android.com/reference/android/accounts/AccountManager#getAuthToken(android.accounts.Account,%20java.lang.String,%20android.os.Bundle,%20android.app.Activity,%20android.accounts.AccountManagerCallback,%20android.os.Handler)`
|
| `notifyAuthFailure` | `boolean`: If true, display a notification and return null if authentication fails; if false, prompt and wait for the user to re-enter correct credentials before returning
|
| Returns ||
|---|---|
| `https://developer.android.com/reference/java/lang/String` | An auth token of the specified type for this account, or null if authentication fails or none can be fetched.
|
| Throws ||
|---|---|
| `https://developer.android.com/reference/android/accounts/AuthenticatorException` | if the authenticator failed to respond |
| `https://developer.android.com/reference/android/accounts/OperationCanceledException` | if the request was canceled for any reason, including the user canceling a credential request |
| `https://developer.android.com/reference/java/io/IOException` | if the authenticator experienced an I/O problem creating a new auth token, usually because of network trouble |
### clearPassword
Added in [API level 5](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void clearPassword (Account account)
```
Forgets a saved password. This erases the local copy of the password; it does not change the user's account password on the server. Has the same effect as setPassword(account, null) but requires fewer permissions, and may be used by applications or management interfaces to "sign out" from an account.
This method only successfully clear the account's password when the caller has the same signature as the authenticator that owns the specified account. Otherwise, this method will silently fail.
It is safe to call this method from the main thread.
**NOTE:** If targeting your app to work on API level 22 and before, MANAGE_ACCOUNTS permission is needed for those platforms. See docs for this function in API level 22.
Requires android.Manifest.permission.MANAGE_ACCOUNTS
| Parameters ||
|---|---|
| `account` | `Account`: The account whose password to clear
|
### confirmCredentials
Added in [API level 5](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public AccountManagerFuture confirmCredentials (Account account,
Bundle options,
Activity activity,
AccountManagerCallback callback,
Handler handler)
```
Confirms that the user knows the password for an account to make extra sure they are the owner of the account. The user-entered password can be supplied directly, otherwise the authenticator for this account type prompts the user with the appropriate interface. This method is intended for applications which want extra assurance; for example, the phone lock screen uses this to let the user unlock the phone with an account password if they forget the lock pattern.
If the user-entered password matches a saved password for this account, the request is considered valid; otherwise the authenticator verifies the password (usually by contacting the server).
This method may be called from any thread, but the returned `https://developer.android.com/reference/android/accounts/AccountManagerFuture` must not be used on the main thread.
**NOTE:** If targeting your app to work on API level 22 and before, MANAGE_ACCOUNTS permission is needed for those platforms. See docs for this function in API level 22.
Requires android.Manifest.permission.MANAGE_ACCOUNTS
| Parameters ||
|---|---|
| `account` | `Account`: The account to confirm password knowledge for
|
| `options` | `Bundle`: Authenticator-specific options for the request; if the `https://developer.android.com/reference/android/accounts/AccountManager#KEY_PASSWORD` string field is present, the authenticator may use it directly rather than prompting the user; may be null or empty
|
| `activity` | `Activity`: The `https://developer.android.com/reference/android/app/Activity` context to use for launching a new authenticator-defined sub-Activity to prompt the user to enter a password; used only to call startActivity(); if null, the prompt will not be launched directly, but the necessary `https://developer.android.com/reference/android/content/Intent` will be returned to the caller instead
|
| `callback` | `AccountManagerCallback`: Callback to invoke when the request completes, null for no callback
|
| `handler` | `Handler`: `https://developer.android.com/reference/android/os/Handler` identifying the callback thread, null for the main thread
|
| Returns ||
|---|---|
| `https://developer.android.com/reference/android/accounts/AccountManagerFuture` | An `https://developer.android.com/reference/android/accounts/AccountManagerFuture` which resolves to a Bundle with these fields if activity or password was supplied and the account was successfully verified: - `https://developer.android.com/reference/android/accounts/AccountManager#KEY_ACCOUNT_NAME` - the name of the account verified - `https://developer.android.com/reference/android/accounts/AccountManager#KEY_ACCOUNT_TYPE` - the type of the account - `https://developer.android.com/reference/android/accounts/AccountManager#KEY_BOOLEAN_RESULT` - true to indicate success If no activity or password was specified, the returned Bundle contains `https://developer.android.com/reference/android/accounts/AccountManager#KEY_INTENT` with the `https://developer.android.com/reference/android/content/Intent` needed to launch the password prompt. Also the returning Bundle may contain `https://developer.android.com/reference/android/accounts/AccountManager#KEY_LAST_AUTHENTICATED_TIME` indicating the last time the credential was validated/created. If an error occurred,`https://developer.android.com/reference/android/accounts/AccountManagerFuture#getResult()` throws: - `https://developer.android.com/reference/android/accounts/AuthenticatorException` if the authenticator failed to respond - `https://developer.android.com/reference/android/accounts/OperationCanceledException` if the operation was canceled for any reason, including the user canceling the password prompt - `https://developer.android.com/reference/java/io/IOException` if the authenticator experienced an I/O problem verifying the password, usually because of network trouble
|
### editProperties
Added in [API level 5](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public AccountManagerFuture editProperties (String accountType,
Activity activity,
AccountManagerCallback callback,
Handler handler)
```
Offers the user an opportunity to change an authenticator's settings. These properties are for the authenticator in general, not a particular account. Not all authenticators support this method.
This method may be called from any thread, but the returned `https://developer.android.com/reference/android/accounts/AccountManagerFuture` must not be used on the main thread.
This method requires the caller to have the same signature as the authenticator associated with the specified account type.
**NOTE:** If targeting your app to work on API level 22 and before, MANAGE_ACCOUNTS permission is needed for those platforms. See docs for this function in API level 22.
Requires android.Manifest.permission.MANAGE_ACCOUNTS
| Parameters ||
|---|---|
| `accountType` | `String`: The account type associated with the authenticator to adjust
|
| `activity` | `Activity`: The `https://developer.android.com/reference/android/app/Activity` context to use for launching a new authenticator-defined sub-Activity to adjust authenticator settings; used only to call startActivity(); if null, the settings dialog will not be launched directly, but the necessary `https://developer.android.com/reference/android/content/Intent` will be returned to the caller instead
|
| `callback` | `AccountManagerCallback`: Callback to invoke when the request completes, null for no callback
|
| `handler` | `Handler`: `https://developer.android.com/reference/android/os/Handler` identifying the callback thread, null for the main thread
|
| Returns ||
|---|---|
| `https://developer.android.com/reference/android/accounts/AccountManagerFuture` | An `https://developer.android.com/reference/android/accounts/AccountManagerFuture` which resolves to a Bundle which is empty if properties were edited successfully, or if no activity was specified, contains only `https://developer.android.com/reference/android/accounts/AccountManager#KEY_INTENT` needed to launch the authenticator's settings dialog. If an error occurred, `https://developer.android.com/reference/android/accounts/AccountManagerFuture#getResult()` throws: - `https://developer.android.com/reference/android/accounts/AuthenticatorException` if no authenticator was registered for this account type or the authenticator failed to respond - `https://developer.android.com/reference/android/accounts/OperationCanceledException` if the operation was canceled for any reason, including the user canceling the settings dialog - `https://developer.android.com/reference/java/io/IOException` if the authenticator experienced an I/O problem updating settings, usually because of network trouble
|
### finishSession
Added in [API level 26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public AccountManagerFuture finishSession (Bundle sessionBundle,
Activity activity,
AccountManagerCallback callback,
Handler handler)
```
Finishes the session started by `https://developer.android.com/reference/android/accounts/AccountManager#startAddAccountSession(java.lang.String,%20java.lang.String,%20java.lang.String[],%20android.os.Bundle,%20android.app.Activity,%20android.accounts.AccountManagerCallback,%20android.os.Handler)` or `https://developer.android.com/reference/android/accounts/AccountManager#startUpdateCredentialsSession(android.accounts.Account,%20java.lang.String,%20android.os.Bundle,%20android.app.Activity,%20android.accounts.AccountManagerCallback,%20android.os.Handler)`. This will either add the account to AccountManager or update the local credentials stored.
This method may be called from any thread, but the returned `https://developer.android.com/reference/android/accounts/AccountManagerFuture` must not be used on the main thread.
| Parameters ||
|---|---|
| `sessionBundle` | `Bundle`: a `https://developer.android.com/reference/android/os/Bundle` created by `https://developer.android.com/reference/android/accounts/AccountManager#startAddAccountSession(java.lang.String,%20java.lang.String,%20java.lang.String[],%20android.os.Bundle,%20android.app.Activity,%20android.accounts.AccountManagerCallback,%20android.os.Handler)` or `https://developer.android.com/reference/android/accounts/AccountManager#startUpdateCredentialsSession(android.accounts.Account,%20java.lang.String,%20android.os.Bundle,%20android.app.Activity,%20android.accounts.AccountManagerCallback,%20android.os.Handler)`
|
| `activity` | `Activity`: The `https://developer.android.com/reference/android/app/Activity` context to use for launching a new authenticator-defined sub-Activity to prompt the user to create an account or reauthenticate existing account; used only to call startActivity(); if null, the prompt will not be launched directly, but the necessary `https://developer.android.com/reference/android/content/Intent` will be returned to the caller instead
|
| `callback` | `AccountManagerCallback`: Callback to invoke when the request completes, null for no callback
|
| `handler` | `Handler`: `https://developer.android.com/reference/android/os/Handler` identifying the callback thread, null for the main thread
|
| Returns ||
|---|---|
| `https://developer.android.com/reference/android/accounts/AccountManagerFuture` | An `https://developer.android.com/reference/android/accounts/AccountManagerFuture` which resolves to a Bundle with these fields if an activity was supplied and an account was added to device or local credentials were updated:: - `https://developer.android.com/reference/android/accounts/AccountManager#KEY_ACCOUNT_NAME` - the name of the account created - `https://developer.android.com/reference/android/accounts/AccountManager#KEY_ACCOUNT_TYPE` - the type of the account - `https://developer.android.com/reference/android/accounts/AccountManager#KEY_ACCOUNT_STATUS_TOKEN` - optional, token to check status of the account If no activity was specified and additional information is needed from user, the returned Bundle may only contain `https://developer.android.com/reference/android/accounts/AccountManager#KEY_INTENT` with the `https://developer.android.com/reference/android/content/Intent` needed to launch the actual account creation process. If an error occurred, `https://developer.android.com/reference/android/accounts/AccountManagerFuture#getResult()` throws: - `https://developer.android.com/reference/android/accounts/AuthenticatorException` if no authenticator was registered for this account type or the authenticator failed to respond - `https://developer.android.com/reference/android/accounts/OperationCanceledException` if the operation was canceled for any reason, including the user canceling the creation process or adding accounts (of this type) has been disabled by policy - `https://developer.android.com/reference/java/io/IOException` if the authenticator experienced an I/O problem creating a new account, usually because of network trouble
|
**See also:**
- `https://developer.android.com/reference/android/accounts/AccountManager#startAddAccountSession(java.lang.String,%20java.lang.String,%20java.lang.String[],%20android.os.Bundle,%20android.app.Activity,%20android.accounts.AccountManagerCallback,%20android.os.Handler)`
### get
Added in [API level 5](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static AccountManager get (Context context)
```
Gets an AccountManager instance associated with a Context. The `https://developer.android.com/reference/android/content/Context` will be used as long as the AccountManager is active, so make sure to use a `https://developer.android.com/reference/android/content/Context` whose lifetime is commensurate with any listeners registered to `https://developer.android.com/reference/android/accounts/AccountManager#addOnAccountsUpdatedListener(android.accounts.OnAccountsUpdateListener,%20android.os.Handler,%20boolean)` or similar methods.
It is safe to call this method from the main thread.
No permission is required to call this method.
| Parameters ||
|---|---|
| `context` | `Context`: The `https://developer.android.com/reference/android/content/Context` to use when necessary
|
| Returns ||
|---|---|
| `https://developer.android.com/reference/android/accounts/AccountManager` | An `https://developer.android.com/reference/android/accounts/AccountManager` instance
|
### getAccountVisibility
Added in [API level 26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public int getAccountVisibility (Account account,
String packageName)
```
Get visibility of certain account for given application. Possible returned values are:
- `https://developer.android.com/reference/android/accounts/AccountManager#VISIBILITY_VISIBLE`
- `https://developer.android.com/reference/android/accounts/AccountManager#VISIBILITY_USER_MANAGED_VISIBLE`
- `https://developer.android.com/reference/android/accounts/AccountManager#VISIBILITY_NOT_VISIBLE`
- `https://developer.android.com/reference/android/accounts/AccountManager#VISIBILITY_USER_MANAGED_NOT_VISIBLE`
This method requires the caller to have a signature match with the authenticator that owns the specified account.
| Parameters ||
|---|---|
| `account` | `Account`: `https://developer.android.com/reference/android/accounts/Account` to get visibility
|
| `packageName` | `String`: Package name of the application to get account visibility
|
| Returns ||
|---|---|
| `int` | int Visibility of given account. For the caller targeting API level 34 and above, `https://developer.android.com/reference/android/accounts/AccountManager#VISIBILITY_NOT_VISIBLE` is returned if the given package is filtered by the rules of [package visibility](https://developer.android.com/training/basics/intents/package-visibility). Value is one of the following: - `https://developer.android.com/reference/android/accounts/AccountManager#VISIBILITY_UNDEFINED` - `https://developer.android.com/reference/android/accounts/AccountManager#VISIBILITY_VISIBLE` - `https://developer.android.com/reference/android/accounts/AccountManager#VISIBILITY_USER_MANAGED_VISIBLE` - `https://developer.android.com/reference/android/accounts/AccountManager#VISIBILITY_NOT_VISIBLE` - `https://developer.android.com/reference/android/accounts/AccountManager#VISIBILITY_USER_MANAGED_NOT_VISIBLE` |
### getAccounts
Added in [API level 5](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public Account[] getAccounts ()
```
Lists all accounts visible to the caller regardless of type. Equivalent to getAccountsByType(null). These accounts may be visible because the user granted access to the account, or the AbstractAccountAuthenticator managing the account did so or because the client shares a signature with the managing AbstractAccountAuthenticator.
**Caution:**This method returns personal and sensitive user data. If your app accesses, collects, uses, or shares personal and sensitive data, you must clearly disclose that fact to users. For apps published on Google Play, policies protecting user data require that you do the following:
- Disclose to the user how your app accesses, collects, uses, or shares personal and sensitive data. Learn more about [acceptable disclosure and consent](https://play.google.com/about/privacy-security-deception/user-data/#!#personal-sensitive).
- Provide a privacy policy that describes your use of this data on- and off-device.
To learn more, visit the [Google Play Policy regarding user data](https://play.google.com/about/privacy-security-deception/user-data).
It is safe to call this method from the main thread.
Requires `https://developer.android.com/reference/android/Manifest.permission#GET_ACCOUNTS`
| Returns ||
|---|---|
| `https://developer.android.com/reference/android/accounts/Account` | An array of `https://developer.android.com/reference/android/accounts/Account`, one for each account. Empty (never null) if no accounts have been added.
|
### getAccountsAndVisibilityForPackage
Added in [API level 26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public Map getAccountsAndVisibilityForPackage (String packageName,
String accountType)
```
Gets all accounts of given type and their visibility for specific package. This method requires the caller to have a signature match with the authenticator that manages accountType. It is a helper method which combines calls to `https://developer.android.com/reference/android/accounts/AccountManager#getAccountsByType(java.lang.String)` by authenticator and `https://developer.android.com/reference/android/accounts/AccountManager#getAccountVisibility(android.accounts.Account,%20java.lang.String)` for every returned account.
| Parameters ||
|---|---|
| `packageName` | `String`: Package name
|
| `accountType` | `String`: `https://developer.android.com/reference/android/accounts/Account` type
|
| Returns ||
|---|---|
| `https://developer.android.com/reference/java/util/Map` | Map with visibility for all accounts of given type See `https://developer.android.com/reference/android/accounts/AccountManager#getAccountVisibility(android.accounts.Account,%20java.lang.String)` for possible values
|
### getAccountsByType
Added in [API level 5](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public Account[] getAccountsByType (String type)
```
Lists all accounts of particular type visible to the caller. These accounts may be visible because the user granted access to the account, or the AbstractAccountAuthenticator managing the account did so or because the client shares a signature with the managing AbstractAccountAuthenticator.
The account type is a string token corresponding to the authenticator and useful domain of the account. For example, there are types corresponding to Google and Facebook. The exact string token to use will be published somewhere associated with the authenticator in question.
**Caution:**This method returns personal and sensitive user data. If your app accesses, collects, uses, or shares personal and sensitive data, you must clearly disclose that fact to users. For apps published on Google Play, policies protecting user data require that you do the following:
- Disclose to the user how your app accesses, collects, uses, or shares personal and sensitive data. Learn more about [acceptable disclosure and consent](https://play.google.com/about/privacy-security-deception/user-data/#!#personal-sensitive).
- Provide a privacy policy that describes your use of this data on- and off-device.
To learn more, visit the [Google Play Policy regarding user data](https://play.google.com/about/privacy-security-deception/user-data).
It is safe to call this method from the main thread.
Caller targeting API level `https://developer.android.com/reference/android/os/Build.VERSION_CODES#O` and above, will get list of accounts made visible to it by user (see `https://developer.android.com/reference/android/accounts/AccountManager#newChooseAccountIntent(android.accounts.Account,%20java.util.List,%20java.lang.String[],%20java.lang.String,%20java.lang.String,%20java.lang.String[],%20android.os.Bundle)`) or AbstractAccountAuthenticator using `https://developer.android.com/reference/android/accounts/AccountManager#setAccountVisibility(android.accounts.Account,%20java.lang.String,%20int)`. `https://developer.android.com/reference/android/Manifest.permission#GET_ACCOUNTS` permission is not used.
Caller targeting API level below `https://developer.android.com/reference/android/os/Build.VERSION_CODES#O` that have not been granted the `https://developer.android.com/reference/android/Manifest.permission#GET_ACCOUNTS` permission, will only see those accounts managed by AbstractAccountAuthenticators whose signature matches the client.
**NOTE:** If targeting your app to work on API level `https://developer.android.com/reference/android/os/Build.VERSION_CODES#LOLLIPOP_MR1` and before, `https://developer.android.com/reference/android/Manifest.permission#GET_ACCOUNTS` permission is needed for those platforms, irrespective of uid or signature match. See docs for this function in API level `https://developer.android.com/reference/android/os/Build.VERSION_CODES#LOLLIPOP_MR1`.
Requires `https://developer.android.com/reference/android/Manifest.permission#GET_ACCOUNTS`
| Parameters ||
|---|---|
| `type` | `String`: The type of accounts to return, null to retrieve all accounts
|
| Returns ||
|---|---|
| `https://developer.android.com/reference/android/accounts/Account` | An array of `https://developer.android.com/reference/android/accounts/Account`, one per matching account. Empty (never null) if no accounts of the specified type have been added.
|
### getAccountsByTypeAndFeatures
Added in [API level 5](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public AccountManagerFuture getAccountsByTypeAndFeatures (String type,
String[] features,
AccountManagerCallback callback,
Handler handler)
```
Lists all accounts of a type which have certain features. The account type identifies the authenticator (see `https://developer.android.com/reference/android/accounts/AccountManager#getAccountsByType(java.lang.String)`). Account features are authenticator-specific string tokens identifying boolean account properties (see `https://developer.android.com/reference/android/accounts/AccountManager#hasFeatures(android.accounts.Account,%20java.lang.String[],%20android.accounts.AccountManagerCallback,%20android.os.Handler)`).
Unlike `https://developer.android.com/reference/android/accounts/AccountManager#getAccountsByType(java.lang.String)`, this method calls the authenticator, which may contact the server or do other work to check account features, so the method returns an `https://developer.android.com/reference/android/accounts/AccountManagerFuture`.
This method may be called from any thread, but the returned `https://developer.android.com/reference/android/accounts/AccountManagerFuture` must not be used on the main thread.
Caller targeting API level `https://developer.android.com/reference/android/os/Build.VERSION_CODES#O` and above, will get list of accounts made visible to it by user (see `https://developer.android.com/reference/android/accounts/AccountManager#newChooseAccountIntent(android.accounts.Account,%20java.util.List,%20java.lang.String[],%20java.lang.String,%20java.lang.String,%20java.lang.String[],%20android.os.Bundle)`) or AbstractAccountAuthenticator using `https://developer.android.com/reference/android/accounts/AccountManager#setAccountVisibility(android.accounts.Account,%20java.lang.String,%20int)`. `https://developer.android.com/reference/android/Manifest.permission#GET_ACCOUNTS` permission is not used.
Caller targeting API level below `https://developer.android.com/reference/android/os/Build.VERSION_CODES#O` that have not been granted the `https://developer.android.com/reference/android/Manifest.permission#GET_ACCOUNTS` permission, will only see those accounts managed by AbstractAccountAuthenticators whose signature matches the client.
**NOTE:** If targeting your app to work on API level `https://developer.android.com/reference/android/os/Build.VERSION_CODES#LOLLIPOP_MR1` and before, `https://developer.android.com/reference/android/Manifest.permission#GET_ACCOUNTS` permission is needed for those platforms, irrespective of uid or signature match. See docs for this function in API level `https://developer.android.com/reference/android/os/Build.VERSION_CODES#LOLLIPOP_MR1`.
| Parameters ||
|---|---|
| `type` | `String`: The type of accounts to return, must not be null
|
| `features` | `String`: An array of the account features to require, may be null or empty \*
|
| `callback` | `AccountManagerCallback`: Callback to invoke when the request completes, null for no callback
|
| `handler` | `Handler`: `https://developer.android.com/reference/android/os/Handler` identifying the callback thread, null for the main thread
|
| Returns ||
|---|---|
| `https://developer.android.com/reference/android/accounts/AccountManagerFuture` | An `https://developer.android.com/reference/android/accounts/AccountManagerFuture` which resolves to an array of `https://developer.android.com/reference/android/accounts/Account`, one per account of the specified type which matches the requested features.
|
### getAccountsByTypeForPackage
Added in [API level 18](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public Account[] getAccountsByTypeForPackage (String type,
String packageName)
```
Returns the accounts visible to the specified package in an environment where some apps are not authorized to view all accounts. This method can only be called by system apps and authenticators managing the type. Beginning API level `https://developer.android.com/reference/android/os/Build.VERSION_CODES#O` it also return accounts which user can make visible to the application (see `https://developer.android.com/reference/android/accounts/AccountManager#VISIBILITY_USER_MANAGED_VISIBLE`).
| Parameters ||
|---|---|
| `type` | `String`: The type of accounts to return, null to retrieve all accounts
|
| `packageName` | `String`: The package name of the app for which the accounts are to be returned
|
| Returns ||
|---|---|
| `https://developer.android.com/reference/android/accounts/Account` | An array of `https://developer.android.com/reference/android/accounts/Account`, one per matching account. Empty (never null) if no accounts of the specified type can be accessed by the package.
|
### getAuthToken
Added in [API level 14](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public AccountManagerFuture getAuthToken (Account account,
String authTokenType,
Bundle options,
boolean notifyAuthFailure,
AccountManagerCallback callback,
Handler handler)
```
Gets an auth token of the specified type for a particular account, optionally raising a notification if the user must enter credentials. This method is intended for background tasks and services where the user should not be immediately interrupted with a password prompt.
If a previously generated auth token is cached for this account and type, then it is returned. Otherwise, if a saved password is available, it is sent to the server to generate a new auth token. Otherwise, an `https://developer.android.com/reference/android/content/Intent` is returned which, when started, will prompt the user for a password. If the notifyAuthFailure parameter is set, a status bar notification is also created with the same Intent, alerting the user that they need to enter a password at some point.
In that case, you may need to wait until the user responds, which could take hours or days or forever. When the user does respond and supply a new password, the account manager will broadcast the `https://developer.android.com/reference/android/accounts/AccountManager#LOGIN_ACCOUNTS_CHANGED_ACTION` Intent and notify `https://developer.android.com/reference/android/accounts/OnAccountsUpdateListener` which applications can use to try again.
If notifyAuthFailure is not set, it is the application's responsibility to launch the returned Intent at some point. Either way, the result from this call will not wait for user action.
Some authenticators have auth token *types*, whose value is authenticator-dependent. Some services use different token types to access different functionality -- for example, Google uses different auth tokens to access Gmail and Google Calendar for the same account.
This method may be called from any thread, but the returned `https://developer.android.com/reference/android/accounts/AccountManagerFuture` must not be used on the main thread.
**NOTE:** If targeting your app to work on API level 22 and before, USE_CREDENTIALS permission is needed for those platforms. See docs for this function in API level 22.
Requires android.Manifest.permission.USE_CREDENTIALS
| Parameters ||
|---|---|
| `account` | `Account`: The account to fetch an auth token for
|
| `authTokenType` | `String`: The auth token type, an authenticator-dependent string token, must not be null
|
| `options` | `Bundle`: Authenticator-specific options for the request, may be null or empty
|
| `notifyAuthFailure` | `boolean`: True to add a notification to prompt the user for a password if necessary, false to leave that to the caller
|
| `callback` | `AccountManagerCallback`: Callback to invoke when the request completes, null for no callback
|
| `handler` | `Handler`: `https://developer.android.com/reference/android/os/Handler` identifying the callback thread, null for the main thread
|
| Returns ||
|---|---|
| `https://developer.android.com/reference/android/accounts/AccountManagerFuture` | An `https://developer.android.com/reference/android/accounts/AccountManagerFuture` which resolves to a Bundle with at least the following fields on success: - `https://developer.android.com/reference/android/accounts/AccountManager#KEY_ACCOUNT_NAME` - the name of the account you supplied - `https://developer.android.com/reference/android/accounts/AccountManager#KEY_ACCOUNT_TYPE` - the type of the account - `https://developer.android.com/reference/android/accounts/AccountManager#KEY_AUTHTOKEN` - the auth token you wanted (Other authenticator-specific values may be returned.) If the user must enter credentials, the returned Bundle contains only `https://developer.android.com/reference/android/accounts/AccountManager#KEY_INTENT` with the `https://developer.android.com/reference/android/content/Intent` needed to launch a prompt. If an error occurred, `https://developer.android.com/reference/android/accounts/AccountManagerFuture#getResult()` throws: - `https://developer.android.com/reference/android/accounts/AuthenticatorException` if the authenticator failed to respond - `https://developer.android.com/reference/android/accounts/OperationCanceledException` if the operation is canceled for any reason, incluidng the user canceling a credential request - `https://developer.android.com/reference/java/io/IOException` if the authenticator experienced an I/O problem creating a new auth token, usually because of network trouble 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.
|
### getAuthToken
Added in [API level 5](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public AccountManagerFuture getAuthToken (Account account,
String authTokenType,
Bundle options,
Activity activity,
AccountManagerCallback callback,
Handler handler)
```
Gets an auth token of the specified type for a particular account, prompting the user for credentials if necessary. This method is intended for applications running in the foreground where it makes sense to ask the user directly for a password.
If a previously generated auth token is cached for this account and type, then it is returned. Otherwise, if a saved password is available, it is sent to the server to generate a new auth token. Otherwise, the user is prompted to enter a password.
Some authenticators have auth token *types*, whose value is authenticator-dependent. Some services use different token types to access different functionality -- for example, Google uses different auth tokens to access Gmail and Google Calendar for the same account.
**NOTE:** If targeting your app to work on API level 22 and before, USE_CREDENTIALS permission is needed for those platforms. See docs for this function in API level 22.
This method may be called from any thread, but the returned `https://developer.android.com/reference/android/accounts/AccountManagerFuture` must not be used on the main thread.
Requires android.Manifest.permission.USE_CREDENTIALS
| Parameters ||
|---|---|
| `account` | `Account`: The account to fetch an auth token for
|
| `authTokenType` | `String`: The auth token type, an authenticator-dependent string token, must not be null
|
| `options` | `Bundle`: Authenticator-specific options for the request, may be null or empty
|
| `activity` | `Activity`: The `https://developer.android.com/reference/android/app/Activity` context to use for launching a new authenticator-defined sub-Activity to prompt the user for a password if necessary; used only to call startActivity(); must not be null.
|
| `callback` | `AccountManagerCallback`: Callback to invoke when the request completes, null for no callback
|
| `handler` | `Handler`: `https://developer.android.com/reference/android/os/Handler` identifying the callback thread, null for the main thread
|
| Returns ||
|---|---|
| `https://developer.android.com/reference/android/accounts/AccountManagerFuture` | An `https://developer.android.com/reference/android/accounts/AccountManagerFuture` which resolves to a Bundle with at least the following fields: - `https://developer.android.com/reference/android/accounts/AccountManager#KEY_ACCOUNT_NAME` - the name of the account you supplied - `https://developer.android.com/reference/android/accounts/AccountManager#KEY_ACCOUNT_TYPE` - the type of the account - `https://developer.android.com/reference/android/accounts/AccountManager#KEY_AUTHTOKEN` - the auth token you wanted (Other authenticator-specific values may be returned.) If an auth token could not be fetched, `https://developer.android.com/reference/android/accounts/AccountManagerFuture#getResult()` throws: - `https://developer.android.com/reference/android/accounts/AuthenticatorException` if the authenticator failed to respond - `https://developer.android.com/reference/android/accounts/OperationCanceledException` if the operation is canceled for any reason, incluidng the user canceling a credential request - `https://developer.android.com/reference/java/io/IOException` if the authenticator experienced an I/O problem creating a new auth token, usually because of network trouble 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.
|
### getAuthToken
Added in [API level 5](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
Deprecated in [API level 15](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public AccountManagerFuture getAuthToken (Account account,
String authTokenType,
boolean notifyAuthFailure,
AccountManagerCallback callback,
Handler handler)
```
**This method was deprecated in API level 15.**
use `https://developer.android.com/reference/android/accounts/AccountManager#getAuthToken(android.accounts.Account,%20java.lang.String,%20android.os.Bundle,%20boolean,%20android.accounts.AccountManagerCallback,%20android.os.Handler)` instead
Gets an auth token of the specified type for a particular account, optionally raising a notification if the user must enter credentials. This method is intended for background tasks and services where the user should not be immediately interrupted with a password prompt.
If a previously generated auth token is cached for this account and type, then it is returned. Otherwise, if a saved password is available, it is sent to the server to generate a new auth token. Otherwise, an `https://developer.android.com/reference/android/content/Intent` is returned which, when started, will prompt the user for a password. If the notifyAuthFailure parameter is set, a status bar notification is also created with the same Intent, alerting the user that they need to enter a password at some point.
In that case, you may need to wait until the user responds, which could take hours or days or forever. When the user does respond and supply a new password, the account manager will broadcast the `https://developer.android.com/reference/android/accounts/AccountManager#LOGIN_ACCOUNTS_CHANGED_ACTION` Intent and notify `https://developer.android.com/reference/android/accounts/OnAccountsUpdateListener` which applications can use to try again.
If notifyAuthFailure is not set, it is the application's responsibility to launch the returned Intent at some point. Either way, the result from this call will not wait for user action.
Some authenticators have auth token *types*, whose value is authenticator-dependent. Some services use different token types to access different functionality -- for example, Google uses different auth tokens to access Gmail and Google Calendar for the same account.
This method may be called from any thread, but the returned `https://developer.android.com/reference/android/accounts/AccountManagerFuture` must not be used on the main thread.
Requires android.Manifest.permission.USE_CREDENTIALS
| Parameters ||
|---|---|
| `account` | `Account`: The account to fetch an auth token for
|
| `authTokenType` | `String`: The auth token type, an authenticator-dependent string token, must not be null
|
| `notifyAuthFailure` | `boolean`: True to add a notification to prompt the user for a password if necessary, false to leave that to the caller
|
| `callback` | `AccountManagerCallback`: Callback to invoke when the request completes, null for no callback
|
| `handler` | `Handler`: `https://developer.android.com/reference/android/os/Handler` identifying the callback thread, null for the main thread
|
| Returns ||
|---|---|
| `https://developer.android.com/reference/android/accounts/AccountManagerFuture` | An `https://developer.android.com/reference/android/accounts/AccountManagerFuture` which resolves to a Bundle with at least the following fields on success: - `https://developer.android.com/reference/android/accounts/AccountManager#KEY_ACCOUNT_NAME` - the name of the account you supplied - `https://developer.android.com/reference/android/accounts/AccountManager#KEY_ACCOUNT_TYPE` - the type of the account - `https://developer.android.com/reference/android/accounts/AccountManager#KEY_AUTHTOKEN` - the auth token you wanted (Other authenticator-specific values may be returned.) If the user must enter credentials, the returned Bundle contains only `https://developer.android.com/reference/android/accounts/AccountManager#KEY_INTENT` with the `https://developer.android.com/reference/android/content/Intent` needed to launch a prompt. If an error occurred, `https://developer.android.com/reference/android/accounts/AccountManagerFuture#getResult()` throws: - `https://developer.android.com/reference/android/accounts/AuthenticatorException` if the authenticator failed to respond - `https://developer.android.com/reference/android/accounts/OperationCanceledException` if the operation is canceled for any reason, incluidng the user canceling a credential request - `https://developer.android.com/reference/java/io/IOException` if the authenticator experienced an I/O problem creating a new auth token, usually because of network trouble 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.
|
### getAuthTokenByFeatures
Added in [API level 5](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public AccountManagerFuture getAuthTokenByFeatures (String accountType,
String authTokenType,
String[] features,
Activity activity,
Bundle addAccountOptions,
Bundle getAuthTokenOptions,
AccountManagerCallback callback,
Handler handler)
```
This convenience helper combines the functionality of `https://developer.android.com/reference/android/accounts/AccountManager#getAccountsByTypeAndFeatures(java.lang.String,%20java.lang.String[],%20android.accounts.AccountManagerCallback,%20android.os.Handler)`, `https://developer.android.com/reference/android/accounts/AccountManager#getAuthToken(android.accounts.Account,%20java.lang.String,%20android.os.Bundle,%20android.app.Activity,%20android.accounts.AccountManagerCallback,%20android.os.Handler)`, and `https://developer.android.com/reference/android/accounts/AccountManager#addAccount(java.lang.String,%20java.lang.String,%20java.lang.String[],%20android.os.Bundle,%20android.app.Activity,%20android.accounts.AccountManagerCallback,%20android.os.Handler)`.
This method gets a list of the accounts matching specific type and feature set which are visible to the caller (see `https://developer.android.com/reference/android/accounts/AccountManager#getAccountsByType(java.lang.String)` for details); if there is exactly one already visible account, it is used; if there are some accounts for which user grant visibility, the user is prompted to pick one; if there are none, the user is prompted to add one. Finally, an auth token is acquired for the chosen account.
This method may be called from any thread, but the returned `https://developer.android.com/reference/android/accounts/AccountManagerFuture` must not be used on the main thread.
**NOTE:** If targeting your app to work on API level 22 and before, MANAGE_ACCOUNTS permission is needed for those platforms. See docs for this function in API level 22.
Requires android.Manifest.permission.MANAGE_ACCOUNTS
| Parameters ||
|---|---|
| `accountType` | `String`: The account type required (see `https://developer.android.com/reference/android/accounts/AccountManager#getAccountsByType(java.lang.String)`), must not be null
|
| `authTokenType` | `String`: The desired auth token type (see `https://developer.android.com/reference/android/accounts/AccountManager#getAuthToken(android.accounts.Account,%20java.lang.String,%20android.os.Bundle,%20android.app.Activity,%20android.accounts.AccountManagerCallback,%20android.os.Handler)`), must not be null
|
| `features` | `String`: Required features for the account (see `https://developer.android.com/reference/android/accounts/AccountManager#getAccountsByTypeAndFeatures(java.lang.String,%20java.lang.String[],%20android.accounts.AccountManagerCallback,%20android.os.Handler)`), may be null or empty
|
| `activity` | `Activity`: The `https://developer.android.com/reference/android/app/Activity` context to use for launching new sub-Activities to prompt to add an account, select an account, and/or enter a password, as necessary; used only to call startActivity(); should not be null
|
| `addAccountOptions` | `Bundle`: Authenticator-specific options to use for adding new accounts; may be null or empty
|
| `getAuthTokenOptions` | `Bundle`: Authenticator-specific options to use for getting auth tokens; may be null or empty
|
| `callback` | `AccountManagerCallback`: Callback to invoke when the request completes, null for no callback
|
| `handler` | `Handler`: `https://developer.android.com/reference/android/os/Handler` identifying the callback thread, null for the main thread
|
| Returns ||
|---|---|
| `https://developer.android.com/reference/android/accounts/AccountManagerFuture` | An `https://developer.android.com/reference/android/accounts/AccountManagerFuture` which resolves to a Bundle with at least the following fields: - `https://developer.android.com/reference/android/accounts/AccountManager#KEY_ACCOUNT_NAME` - the name of the account - `https://developer.android.com/reference/android/accounts/AccountManager#KEY_ACCOUNT_TYPE` - the type of the account - `https://developer.android.com/reference/android/accounts/AccountManager#KEY_AUTHTOKEN` - the auth token you wanted If an error occurred, `https://developer.android.com/reference/android/accounts/AccountManagerFuture#getResult()` throws: - `https://developer.android.com/reference/android/accounts/AuthenticatorException` if no authenticator was registered for this account type or the authenticator failed to respond - `https://developer.android.com/reference/android/accounts/OperationCanceledException` if the operation was canceled for any reason, including the user canceling any operation - `https://developer.android.com/reference/java/io/IOException` if the authenticator experienced an I/O problem updating settings, usually because of network trouble
|
### getAuthenticatorTypes
Added in [API level 5](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public AuthenticatorDescription[] getAuthenticatorTypes ()
```
Lists the currently registered authenticators.
It is safe to call this method from the main thread.
No permission is required to call this method.
Caller targeting API level 34 and above, the results are filtered by the rules of [package visibility](https://developer.android.com/training/basics/intents/package-visibility).
| Returns ||
|---|---|
| `https://developer.android.com/reference/android/accounts/AuthenticatorDescription` | An array of `https://developer.android.com/reference/android/accounts/AuthenticatorDescription` for every authenticator known to the AccountManager service. Empty (never null) if no authenticators are known.
|
### getPackagesAndVisibilityForAccount
Added in [API level 26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public Map getPackagesAndVisibilityForAccount (Account account)
```
Returns package names and visibility which were explicitly set for given account.
This method requires the caller to have a signature match with the authenticator that owns the specified account.
| Parameters ||
|---|---|
| `account` | `Account`: The account for which visibility data should be returned
|
| Returns ||
|---|---|
| `https://developer.android.com/reference/java/util/Map` | Map from package names to visibility for given account
|
### getPassword
Added in [API level 5](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public String getPassword (Account account)
```
Gets the saved password associated with the account. This is intended for authenticators and related code; applications should get an auth token instead.
It is safe to call this method from the main thread.
This method requires the caller to have a signature match with the authenticator that owns the specified account.
**NOTE:** If targeting your app to work on API level `https://developer.android.com/reference/android/os/Build.VERSION_CODES#LOLLIPOP_MR1` and before, AUTHENTICATE_ACCOUNTS permission is needed for those platforms. See docs for this function in API level `https://developer.android.com/reference/android/os/Build.VERSION_CODES#LOLLIPOP_MR1`.
Requires android.Manifest.permission.AUTHENTICATE_ACCOUNTS
| Parameters ||
|---|---|
| `account` | `Account`: The account to query for a password. Must not be `null`.
|
| Returns ||
|---|---|
| `https://developer.android.com/reference/java/lang/String` | The account's password, null if none or if the account doesn't exist
|
### getPreviousName
Added in [API level 21](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public String getPreviousName (Account account)
```
Gets the previous name associated with the account or `null`, if none. This is intended so that clients of `https://developer.android.com/reference/android/accounts/OnAccountsUpdateListener` can determine if an authenticator has renamed an account.
It is safe to call this method from the main thread.
| Parameters ||
|---|---|
| `account` | `Account`: The account to query for a previous name.
|
| Returns ||
|---|---|
| `https://developer.android.com/reference/java/lang/String` | The account's previous name, null if the account has never been renamed.
|
### getUserData
Added in [API level 5](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public String getUserData (Account account,
String key)
```
Gets the user data named by "key" associated with the account. This is intended for authenticators and related code to store arbitrary metadata along with accounts. The meaning of the keys and values is up to the authenticator for the account.
It is safe to call this method from the main thread.
This method requires the caller to have a signature match with the authenticator that owns the specified account.
**NOTE:** If targeting your app to work on API level `https://developer.android.com/reference/android/os/Build.VERSION_CODES#LOLLIPOP_MR1` and before, AUTHENTICATE_ACCOUNTS permission is needed for those platforms. See docs for this function in API level `https://developer.android.com/reference/android/os/Build.VERSION_CODES#LOLLIPOP_MR1`.
Requires android.Manifest.permission.AUTHENTICATE_ACCOUNTS
| Parameters ||
|---|---|
| `account` | `Account`: The account to query for user data
|
| `key` | `String`
|
| Returns ||
|---|---|
| `https://developer.android.com/reference/java/lang/String` | The user data, null if the account, key doesn't exist, or the user is locked
|
### hasFeatures
Added in [API level 8](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public AccountManagerFuture hasFeatures (Account account,
String[] features,
AccountManagerCallback callback,
Handler handler)
```
Finds out whether a particular account has all the specified features. Account features are authenticator-specific string tokens identifying boolean account properties. For example, features are used to tell whether Google accounts have a particular service (such as Google Calendar or Google Talk) enabled. The feature names and their meanings are published somewhere associated with the authenticator in question.
This method may be called from any thread, but the returned `https://developer.android.com/reference/android/accounts/AccountManagerFuture` must not be used on the main thread.
If caller target API level is below `https://developer.android.com/reference/android/os/Build.VERSION_CODES#O`, it is required to hold the permission `https://developer.android.com/reference/android/Manifest.permission#GET_ACCOUNTS` or have a signature match with the AbstractAccountAuthenticator that manages the account.
| Parameters ||
|---|---|
| `account` | `Account`: The `https://developer.android.com/reference/android/accounts/Account` to test
|
| `features` | `String`: An array of the account features to check
|
| `callback` | `AccountManagerCallback`: Callback to invoke when the request completes, null for no callback
|
| `handler` | `Handler`: `https://developer.android.com/reference/android/os/Handler` identifying the callback thread, null for the main thread
|
| Returns ||
|---|---|
| `https://developer.android.com/reference/android/accounts/AccountManagerFuture` | An `https://developer.android.com/reference/android/accounts/AccountManagerFuture` which resolves to a Boolean, true if the account exists and has all of the specified features.
|
### invalidateAuthToken
Added in [API level 5](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void invalidateAuthToken (String accountType,
String authToken)
```
Removes an auth token from the AccountManager's cache. Does nothing if the auth token is not currently in the cache. Applications must call this method when the auth token is found to have expired or otherwise become invalid for authenticating requests. The AccountManager does not validate or expire cached auth tokens otherwise.
It is safe to call this method from the main thread.
**NOTE:** If targeting your app to work on API level 22 and before, MANAGE_ACCOUNTS or USE_CREDENTIALS permission is needed for those platforms. See docs for this function in API level 22.
Requires android.Manifest.permission.MANAGE_ACCOUNTS or android.Manifest.permission.USE_CREDENTIALS
| Parameters ||
|---|---|
| `accountType` | `String`: The account type of the auth token to invalidate, must not be null
|
| `authToken` | `String`: The auth token to invalidate, may be null
|
### isCredentialsUpdateSuggested
Added in [API level 26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public AccountManagerFuture isCredentialsUpdateSuggested (Account account,
String statusToken,
AccountManagerCallback callback,
Handler handler)
```
Checks whether `https://developer.android.com/reference/android/accounts/AccountManager#updateCredentials(android.accounts.Account,%20java.lang.String,%20android.os.Bundle,%20android.app.Activity,%20android.accounts.AccountManagerCallback,%20android.os.Handler)` or `https://developer.android.com/reference/android/accounts/AccountManager#startUpdateCredentialsSession(android.accounts.Account,%20java.lang.String,%20android.os.Bundle,%20android.app.Activity,%20android.accounts.AccountManagerCallback,%20android.os.Handler)` should be called with respect to the specified account.
This method may be called from any thread, but the returned `https://developer.android.com/reference/android/accounts/AccountManagerFuture` must not be used on the main thread.
| Parameters ||
|---|---|
| `account` | `Account`: The `https://developer.android.com/reference/android/accounts/Account` to be checked whether `https://developer.android.com/reference/android/accounts/AccountManager#updateCredentials(android.accounts.Account,%20java.lang.String,%20android.os.Bundle,%20android.app.Activity,%20android.accounts.AccountManagerCallback,%20android.os.Handler)` or `https://developer.android.com/reference/android/accounts/AccountManager#startUpdateCredentialsSession(android.accounts.Account,%20java.lang.String,%20android.os.Bundle,%20android.app.Activity,%20android.accounts.AccountManagerCallback,%20android.os.Handler)` should be called
|
| `statusToken` | `String`: a String of token to check account staus
|
| `callback` | `AccountManagerCallback`: Callback to invoke when the request completes, null for no callback
|
| `handler` | `Handler`: `https://developer.android.com/reference/android/os/Handler` identifying the callback thread, null for the main thread
|
| Returns ||
|---|---|
| `https://developer.android.com/reference/android/accounts/AccountManagerFuture` | An `https://developer.android.com/reference/android/accounts/AccountManagerFuture` which resolves to a Boolean, true if the credentials of the account should be updated.
|
### newChooseAccountIntent
Added in [API level 23](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static Intent newChooseAccountIntent (Account selectedAccount,
List allowableAccounts,
String[] allowableAccountTypes,
String descriptionOverrideText,
String addAccountAuthTokenType,
String[] addAccountRequiredFeatures,
Bundle addAccountOptions)
```
Returns an intent to an `https://developer.android.com/reference/android/app/Activity` that prompts the user to choose from a list of accounts. The caller will then typically start the activity by calling `startActivityForResult(intent, ...);`.
On success the activity returns a Bundle with the account name and type specified using keys `https://developer.android.com/reference/android/accounts/AccountManager#KEY_ACCOUNT_NAME` and `https://developer.android.com/reference/android/accounts/AccountManager#KEY_ACCOUNT_TYPE`. Chosen account is marked as `https://developer.android.com/reference/android/accounts/AccountManager#VISIBILITY_USER_MANAGED_VISIBLE` to the caller (see `https://developer.android.com/reference/android/accounts/AccountManager#setAccountVisibility(android.accounts.Account,%20java.lang.String,%20int)`) and will be returned to it in consequent `https://developer.android.com/reference/android/accounts/AccountManager#getAccountsByType(java.lang.String)`) calls.
The most common case is to call this with one account type, e.g.:
```
newChooseAccountIntent(null, null, new String[]{"com.google"}, null, null, null,
null);
```
| Parameters ||
|---|---|
| `selectedAccount` | `Account`: if specified, indicates that the `https://developer.android.com/reference/android/accounts/Account` is the currently selected one, according to the caller's definition of selected.
|
| `allowableAccounts` | `List`: an optional `https://developer.android.com/reference/java/util/List` of accounts that are allowed to be shown. If not specified then this field will not limit the displayed accounts.
|
| `allowableAccountTypes` | `String`: an optional string array of account types. These are used both to filter the shown accounts and to filter the list of account types that are shown when adding an account. If not specified then this field will not limit the displayed account types when adding an account.
|
| `descriptionOverrideText` | `String`: if non-null this string is used as the description in the accounts chooser screen rather than the default
|
| `addAccountAuthTokenType` | `String`: this string is passed as the `https://developer.android.com/reference/android/accounts/AccountManager#addAccount(java.lang.String,%20java.lang.String,%20java.lang.String[],%20android.os.Bundle,%20android.app.Activity,%20android.accounts.AccountManagerCallback,%20android.os.Handler)` authTokenType parameter
|
| `addAccountRequiredFeatures` | `String`: this string array is passed as the `https://developer.android.com/reference/android/accounts/AccountManager#addAccount(java.lang.String,%20java.lang.String,%20java.lang.String[],%20android.os.Bundle,%20android.app.Activity,%20android.accounts.AccountManagerCallback,%20android.os.Handler)` requiredFeatures parameter
|
| `addAccountOptions` | `Bundle`: This `https://developer.android.com/reference/android/os/Bundle` is passed as the `https://developer.android.com/reference/android/accounts/AccountManager#addAccount(java.lang.String,%20java.lang.String,%20java.lang.String[],%20android.os.Bundle,%20android.app.Activity,%20android.accounts.AccountManagerCallback,%20android.os.Handler)` options parameter
|
| Returns ||
|---|---|
| `https://developer.android.com/reference/android/content/Intent` | an `https://developer.android.com/reference/android/content/Intent` that can be used to launch the ChooseAccount activity flow.
|
### newChooseAccountIntent
Added in [API level 14](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
Deprecated in [API level 23](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static Intent newChooseAccountIntent (Account selectedAccount,
ArrayList allowableAccounts,
String[] allowableAccountTypes,
boolean alwaysPromptForAccount,
String descriptionOverrideText,
String addAccountAuthTokenType,
String[] addAccountRequiredFeatures,
Bundle addAccountOptions)
```
Deprecated in favor of `https://developer.android.com/reference/android/accounts/AccountManager#newChooseAccountIntent(android.accounts.Account,%20java.util.List,%20java.lang.String[],%20java.lang.String,%20java.lang.String,%20java.lang.String[],%20android.os.Bundle)`. Returns an intent to an `https://developer.android.com/reference/android/app/Activity` that prompts the user to choose from a list of accounts. The caller will then typically start the activity by calling `startActivityForResult(intent, ...);`.
On success the activity returns a Bundle with the account name and type specified using keys `https://developer.android.com/reference/android/accounts/AccountManager#KEY_ACCOUNT_NAME` and `https://developer.android.com/reference/android/accounts/AccountManager#KEY_ACCOUNT_TYPE`. Chosen account is marked as `https://developer.android.com/reference/android/accounts/AccountManager#VISIBILITY_USER_MANAGED_VISIBLE` to the caller (see `https://developer.android.com/reference/android/accounts/AccountManager#setAccountVisibility(android.accounts.Account,%20java.lang.String,%20int)`) and will be returned to it in consequent `https://developer.android.com/reference/android/accounts/AccountManager#getAccountsByType(java.lang.String)`) calls.
The most common case is to call this with one account type, e.g.:
```
newChooseAccountIntent(null, null, new String[]{"com.google"}, false, null,
null, null, null);
```
| Parameters ||
|---|---|
| `selectedAccount` | `Account`: if specified, indicates that the `https://developer.android.com/reference/android/accounts/Account` is the currently selected one, according to the caller's definition of selected.
|
| `allowableAccounts` | `ArrayList`: an optional `https://developer.android.com/reference/java/util/List` of accounts that are allowed to be shown. If not specified then this field will not limit the displayed accounts.
|
| `allowableAccountTypes` | `String`: an optional string array of account types. These are used both to filter the shown accounts and to filter the list of account types that are shown when adding an account. If not specified then this field will not limit the displayed account types when adding an account.
|
| `alwaysPromptForAccount` | `boolean`: boolean that is ignored.
|
| `descriptionOverrideText` | `String`: if non-null this string is used as the description in the accounts chooser screen rather than the default
|
| `addAccountAuthTokenType` | `String`: this string is passed as the `https://developer.android.com/reference/android/accounts/AccountManager#addAccount(java.lang.String,%20java.lang.String,%20java.lang.String[],%20android.os.Bundle,%20android.app.Activity,%20android.accounts.AccountManagerCallback,%20android.os.Handler)` authTokenType parameter
|
| `addAccountRequiredFeatures` | `String`: this string array is passed as the `https://developer.android.com/reference/android/accounts/AccountManager#addAccount(java.lang.String,%20java.lang.String,%20java.lang.String[],%20android.os.Bundle,%20android.app.Activity,%20android.accounts.AccountManagerCallback,%20android.os.Handler)` requiredFeatures parameter
|
| `addAccountOptions` | `Bundle`: This `https://developer.android.com/reference/android/os/Bundle` is passed as the `https://developer.android.com/reference/android/accounts/AccountManager#addAccount(java.lang.String,%20java.lang.String,%20java.lang.String[],%20android.os.Bundle,%20android.app.Activity,%20android.accounts.AccountManagerCallback,%20android.os.Handler)` options parameter
|
| Returns ||
|---|---|
| `https://developer.android.com/reference/android/content/Intent` | an `https://developer.android.com/reference/android/content/Intent` that can be used to launch the ChooseAccount activity flow.
|
### notifyAccountAuthenticated
Added in [API level 23](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public boolean notifyAccountAuthenticated (Account account)
```
Notifies the system that the account has just been authenticated. This information may be used by other applications to verify the account. This should be called only when the user has entered correct credentials for the account.
It is not safe to call this method from the main thread. As such, call it from another thread.
This method requires the caller to have a signature match with the authenticator that owns the specified account.
Requires android.Manifest.permission.AUTHENTICATE_ACCOUNTS
| Parameters ||
|---|---|
| `account` | `Account`: The `https://developer.android.com/reference/android/accounts/Account` to be updated.
|
| Returns ||
|---|---|
| `boolean` | boolean `true` if the authentication of the account has been successfully acknowledged. Otherwise `false`.
|
### peekAuthToken
Added in [API level 5](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public String peekAuthToken (Account account,
String authTokenType)
```
Gets an auth token from the AccountManager's cache. If no auth token is cached for this account, null will be returned -- a new auth token will not be generated, and the server will not be contacted. Intended for use by the authenticator, not directly by applications.
It is safe to call this method from the main thread.
This method requires the caller to have a signature match with the authenticator that manages the specified account.
**NOTE:** If targeting your app to work on API level 22 and before, AUTHENTICATE_ACCOUNTS permission and same UID as account's authenticator is needed for those platforms. See docs for this function in API level 22.
Requires android.Manifest.permission.AUTHENTICATE_ACCOUNTS
| Parameters ||
|---|---|
| `account` | `Account`: The account for which an auth token is to be fetched. Cannot be `null`.
|
| `authTokenType` | `String`: The type of auth token to fetch. Cannot be `null`.
|
| Returns ||
|---|---|
| `https://developer.android.com/reference/java/lang/String` | The cached auth token for this account and type, or null if no auth token is cached, the account does not exist, or the user is locked
|
**See also:**
- `https://developer.android.com/reference/android/accounts/AccountManager#getAuthToken(android.accounts.Account,%20java.lang.String,%20android.os.Bundle,%20android.app.Activity,%20android.accounts.AccountManagerCallback,%20android.os.Handler)`
### removeAccount
Added in [API level 22](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public AccountManagerFuture removeAccount (Account account,
Activity activity,
AccountManagerCallback callback,
Handler handler)
```
Removes an account from the AccountManager. Does nothing if the account does not exist. Does not delete the account from the server. The authenticator may have its own policies preventing account deletion, in which case the account will not be deleted.
This method may be called from any thread, but the returned `https://developer.android.com/reference/android/accounts/AccountManagerFuture` must not be used on the main thread.
This method requires the caller to have a signature match with the authenticator that manages the specified account, be a profile owner or have the `https://developer.android.com/` permission.
**NOTE:** If targeting your app to work on API level 22 and before, MANAGE_ACCOUNTS permission is needed for those platforms. See docs for this function in API level 22.
| Parameters ||
|---|---|
| `account` | `Account`: The `https://developer.android.com/reference/android/accounts/Account` to remove
|
| `activity` | `Activity`: The `https://developer.android.com/reference/android/app/Activity` context to use for launching a new authenticator-defined sub-Activity to prompt the user to delete an account; used only to call startActivity(); if null, the prompt will not be launched directly, but the `https://developer.android.com/reference/android/content/Intent` may be returned to the caller instead
|
| `callback` | `AccountManagerCallback`: Callback to invoke when the request completes, null for no callback
|
| `handler` | `Handler`: `https://developer.android.com/reference/android/os/Handler` identifying the callback thread, null for the main thread
|
| Returns ||
|---|---|
| `https://developer.android.com/reference/android/accounts/AccountManagerFuture` | An `https://developer.android.com/reference/android/accounts/AccountManagerFuture` which resolves to a Bundle with `https://developer.android.com/reference/android/accounts/AccountManager#KEY_BOOLEAN_RESULT` if activity was specified and an account was removed or if active. If no activity was specified, the returned Bundle contains only `https://developer.android.com/reference/android/accounts/AccountManager#KEY_INTENT` with the `https://developer.android.com/reference/android/content/Intent` needed to launch the actual account removal process, if authenticator needs the activity launch. If an error occurred, `https://developer.android.com/reference/android/accounts/AccountManagerFuture#getResult()` throws: - `https://developer.android.com/reference/android/accounts/AuthenticatorException` if no authenticator was registered for this account type or the authenticator failed to respond - `https://developer.android.com/reference/android/accounts/OperationCanceledException` if the operation was canceled for any reason, including the user canceling the creation process or adding accounts (of this type) has been disabled by policy
|
### removeAccount
Added in [API level 5](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
Deprecated in [API level 22](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public AccountManagerFuture removeAccount (Account account,
AccountManagerCallback callback,
Handler handler)
```
**This method was deprecated in API level 22.**
use `https://developer.android.com/reference/android/accounts/AccountManager#removeAccount(android.accounts.Account,%20android.app.Activity,%20android.accounts.AccountManagerCallback,%20android.os.Handler)` instead
Removes an account from the AccountManager. Does nothing if the account does not exist. Does not delete the account from the server. The authenticator may have its own policies preventing account deletion, in which case the account will not be deleted.
This method requires the caller to have a signature match with the authenticator that manages the specified account.
**NOTE:** If targeting your app to work on API level 22 and before, MANAGE_ACCOUNTS permission is needed for those platforms. See docs for this function in API level 22.
Requires android.Manifest.permission.MANAGE_ACCOUNTS
| Parameters ||
|---|---|
| `account` | `Account`: The `https://developer.android.com/reference/android/accounts/Account` to remove
|
| `callback` | `AccountManagerCallback`: Callback to invoke when the request completes, null for no callback
|
| `handler` | `Handler`: `https://developer.android.com/reference/android/os/Handler` identifying the callback thread, null for the main thread
|
| Returns ||
|---|---|
| `https://developer.android.com/reference/android/accounts/AccountManagerFuture` | An `https://developer.android.com/reference/android/accounts/AccountManagerFuture` which resolves to a Boolean, true if the account has been successfully removed
|
### removeAccountExplicitly
Added in [API level 22](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public boolean removeAccountExplicitly (Account account)
```
Removes an account directly. Normally used by authenticators, not directly by applications. Does not delete the account from the server. The authenticator may have its own policies preventing account deletion, in which case the account will not be deleted.
It is safe to call this method from the main thread.
This method requires the caller to have a signature match with the authenticator that manages the specified account.
**NOTE:** If targeting your app to work on API level 22 and before, AUTHENTICATE_ACCOUNTS permission and same UID as account's authenticator is needed for those platforms. See docs for this function in API level 22.
Requires android.Manifest.permission.AUTHENTICATE_ACCOUNTS
| Parameters ||
|---|---|
| `account` | `Account`: The `https://developer.android.com/reference/android/accounts/Account` to delete.
|
| Returns ||
|---|---|
| `boolean` | True if the account was successfully deleted, false if the account did not exist, the account is null, or another error occurs.
|
### removeOnAccountsUpdatedListener
Added in [API level 5](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void removeOnAccountsUpdatedListener (OnAccountsUpdateListener listener)
```
Removes an `https://developer.android.com/reference/android/accounts/OnAccountsUpdateListener` previously registered with `https://developer.android.com/reference/android/accounts/AccountManager#addOnAccountsUpdatedListener(android.accounts.OnAccountsUpdateListener,%20android.os.Handler,%20boolean)`. The listener will no longer receive notifications of account changes.
It is safe to call this method from the main thread.
No permission is required to call this method.
| Parameters ||
|---|---|
| `listener` | `OnAccountsUpdateListener`: The previously added listener to remove
|
| Throws ||
|---|---|
| `https://developer.android.com/reference/java/lang/IllegalArgumentException` | if listener is null |
| `https://developer.android.com/reference/java/lang/IllegalStateException` | if listener was not already added |
### renameAccount
Added in [API level 21](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public AccountManagerFuture renameAccount (Account account,
String newName,
AccountManagerCallback callback,
Handler handler)
```
Rename the specified `https://developer.android.com/reference/android/accounts/Account`. This is equivalent to removing the existing account and adding a new renamed account with the old account's user data.
It is safe to call this method from the main thread.
This method requires the caller to have a signature match with the authenticator that manages the specified account.
**NOTE:** If targeting your app to work on API level 22 and before, AUTHENTICATE_ACCOUNTS permission and same UID as account's authenticator is needed for those platforms. See docs for this function in API level 22.
Requires android.Manifest.permission.AUTHENTICATE_ACCOUNTS
| Parameters ||
|---|---|
| `account` | `Account`: The `https://developer.android.com/reference/android/accounts/Account` to rename
|
| `newName` | `String`: String name to be associated with the account.
|
| `callback` | `AccountManagerCallback`: Callback to invoke when the request completes, null for no callback
|
| `handler` | `Handler`: `https://developer.android.com/reference/android/os/Handler` identifying the callback thread, null for the main thread
|
| Returns ||
|---|---|
| `https://developer.android.com/reference/android/accounts/AccountManagerFuture` | An `https://developer.android.com/reference/android/accounts/AccountManagerFuture` which resolves to the Account after the name change. If successful the account's name will be the specified new name.
|
### setAccountVisibility
Added in [API level 26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public boolean setAccountVisibility (Account account,
String packageName,
int visibility)
```
Set visibility value of given account to certain package. Package name must match installed application, or be equal to `https://developer.android.com/reference/android/accounts/AccountManager#PACKAGE_NAME_KEY_LEGACY_VISIBLE` or `https://developer.android.com/reference/android/accounts/AccountManager#PACKAGE_NAME_KEY_LEGACY_NOT_VISIBLE`.
Possible visibility values:
- `https://developer.android.com/reference/android/accounts/AccountManager#VISIBILITY_UNDEFINED`
- `https://developer.android.com/reference/android/accounts/AccountManager#VISIBILITY_VISIBLE`
- `https://developer.android.com/reference/android/accounts/AccountManager#VISIBILITY_USER_MANAGED_VISIBLE`
- `https://developer.android.com/reference/android/accounts/AccountManager#VISIBILITY_NOT_VISIBLE`
- `https://developer.android.com/reference/android/accounts/AccountManager#VISIBILITY_USER_MANAGED_NOT_VISIBLE`
This method requires the caller to have a signature match with the authenticator that owns the specified account.
| Parameters ||
|---|---|
| `account` | `Account`: `https://developer.android.com/reference/android/accounts/Account` to update visibility
|
| `packageName` | `String`: Package name of the application to modify account visibility. Declaring [package visibility](https://developer.android.com/training/basics/intents/package-visibility) needs for it is needed, if the caller is targeting API level 34 and above.
|
| `visibility` | `int`: New visibility value. Value is one of the following: - `https://developer.android.com/reference/android/accounts/AccountManager#VISIBILITY_UNDEFINED` - `https://developer.android.com/reference/android/accounts/AccountManager#VISIBILITY_VISIBLE` - `https://developer.android.com/reference/android/accounts/AccountManager#VISIBILITY_USER_MANAGED_VISIBLE` - `https://developer.android.com/reference/android/accounts/AccountManager#VISIBILITY_NOT_VISIBLE` - `https://developer.android.com/reference/android/accounts/AccountManager#VISIBILITY_USER_MANAGED_NOT_VISIBLE` |
| Returns ||
|---|---|
| `boolean` | True, if visibility value was successfully updated.
|
### setAuthToken
Added in [API level 5](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void setAuthToken (Account account,
String authTokenType,
String authToken)
```
Adds an auth token to the AccountManager cache for an account. If the account does not exist then this call has no effect. Replaces any previous auth token for this account and auth token type. Intended for use by the authenticator, not directly by applications.
It is safe to call this method from the main thread.
This method requires the caller to have a signature match with the authenticator that manages the specified account.
**NOTE:** If targeting your app to work on API level 22 and before, AUTHENTICATE_ACCOUNTS permission and same UID as account's authenticator is needed for those platforms. See docs for this function in API level 22.
Requires android.Manifest.permission.AUTHENTICATE_ACCOUNTS
| Parameters ||
|---|---|
| `account` | `Account`: The account to set an auth token for
|
| `authTokenType` | `String`: The type of the auth token, see {#getAuthToken}
|
| `authToken` | `String`: The auth token to add to the cache
|
### setPassword
Added in [API level 5](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void setPassword (Account account,
String password)
```
Sets or forgets a saved password. This modifies the local copy of the password used to automatically authenticate the user; it does not change the user's account password on the server. Intended for use by the authenticator, not directly by applications.
Calling this method does not update the last authenticated timestamp, referred by `https://developer.android.com/reference/android/accounts/AccountManager#KEY_LAST_AUTHENTICATED_TIME`. To update it, call `https://developer.android.com/reference/android/accounts/AccountManager#notifyAccountAuthenticated(android.accounts.Account)` after getting success.
It is safe to call this method from the main thread.
This method requires the caller to have a signature match with the authenticator that manages the specified account.
**NOTE:** If targeting your app to work on API level 22 and before, AUTHENTICATE_ACCOUNTS permission and same UID as account's authenticator is needed for those platforms. See docs for this function in API level 22.
Requires android.Manifest.permission.AUTHENTICATE_ACCOUNTS
| Parameters ||
|---|---|
| `account` | `Account`: The account whose password is to be set. Cannot be `null`.
|
| `password` | `String`: The password to set, null to clear the password
|
### setUserData
Added in [API level 5](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void setUserData (Account account,
String key,
String value)
```
Sets one userdata key for an account. Intended by use for the authenticator to stash state for itself, not directly by applications. The meaning of the keys and values is up to the authenticator.
It is safe to call this method from the main thread.
This method requires the caller to have a signature match with the authenticator that manages the specified account.
**NOTE:** If targeting your app to work on API level 22 and before, AUTHENTICATE_ACCOUNTS permission and same UID as account's authenticator is needed for those platforms. See docs for this function in API level 22.
Requires android.Manifest.permission.AUTHENTICATE_ACCOUNTS
| Parameters ||
|---|---|
| `account` | `Account`: Account whose user data is to be set. Must not be `null`.
|
| `key` | `String`: String user data key to set. Must not be null
|
| `value` | `String`: String value to set, `null` to clear this user data key
|
### startAddAccountSession
Added in [API level 26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public AccountManagerFuture startAddAccountSession (String accountType,
String authTokenType,
String[] requiredFeatures,
Bundle options,
Activity activity,
AccountManagerCallback callback,
Handler handler)
```
Asks the user to authenticate with an account of a specified type. The authenticator for this account type processes this request with the appropriate user interface. If the user does elect to authenticate with a new account, a bundle of session data for installing the account later is returned with optional account password and account status token.
This method may be called from any thread, but the returned `https://developer.android.com/reference/android/accounts/AccountManagerFuture` must not be used on the main thread.
**NOTE:** The account will not be installed to the device by calling this api alone. #finishSession should be called after this to install the account on device.
| Parameters ||
|---|---|
| `accountType` | `String`: The type of account to add; must not be null
|
| `authTokenType` | `String`: The type of auth token (see `https://developer.android.com/reference/android/accounts/AccountManager#getAuthToken(android.accounts.Account,%20java.lang.String,%20android.os.Bundle,%20android.app.Activity,%20android.accounts.AccountManagerCallback,%20android.os.Handler)`) this account will need to be able to generate, null for none
|
| `requiredFeatures` | `String`: The features (see `https://developer.android.com/reference/android/accounts/AccountManager#hasFeatures(android.accounts.Account,%20java.lang.String[],%20android.accounts.AccountManagerCallback,%20android.os.Handler)`) this account must have, null for none
|
| `options` | `Bundle`: Authenticator-specific options for the request, may be null or empty
|
| `activity` | `Activity`: The `https://developer.android.com/reference/android/app/Activity` context to use for launching a new authenticator-defined sub-Activity to prompt the user to create an account; used only to call startActivity(); if null, the prompt will not be launched directly, but the necessary `https://developer.android.com/reference/android/content/Intent` will be returned to the caller instead
|
| `callback` | `AccountManagerCallback`: Callback to invoke when the request completes, null for no callback
|
| `handler` | `Handler`: `https://developer.android.com/reference/android/os/Handler` identifying the callback thread, null for the main thread
|
| Returns ||
|---|---|
| `https://developer.android.com/reference/android/accounts/AccountManagerFuture` | An `https://developer.android.com/reference/android/accounts/AccountManagerFuture` which resolves to a Bundle with these fields if activity was specified and user was authenticated with an account: - `https://developer.android.com/reference/android/accounts/AccountManager#KEY_ACCOUNT_SESSION_BUNDLE` - encrypted Bundle for adding the the to the device later. - `https://developer.android.com/reference/android/accounts/AccountManager#KEY_ACCOUNT_STATUS_TOKEN` - optional, token to check status of the account If no activity was specified, the returned Bundle contains only `https://developer.android.com/reference/android/accounts/AccountManager#KEY_INTENT` with the `https://developer.android.com/reference/android/content/Intent` needed to launch the actual account creation process. If authenticator doesn't support this method, the returned Bundle contains only `https://developer.android.com/reference/android/accounts/AccountManager#KEY_ACCOUNT_SESSION_BUNDLE` with encrypted `options` needed to add account later. If an error occurred, `https://developer.android.com/reference/android/accounts/AccountManagerFuture#getResult()` throws: - `https://developer.android.com/reference/android/accounts/AuthenticatorException` if no authenticator was registered for this account type or the authenticator failed to respond - `https://developer.android.com/reference/android/accounts/OperationCanceledException` if the operation was canceled for any reason, including the user canceling the creation process or adding accounts (of this type) has been disabled by policy - `https://developer.android.com/reference/java/io/IOException` if the authenticator experienced an I/O problem creating a new account, usually because of network trouble
|
**See also:**
- `https://developer.android.com/reference/android/accounts/AccountManager#finishSession(android.os.Bundle,%20android.app.Activity,%20android.accounts.AccountManagerCallback,%20android.os.Handler)`
### startUpdateCredentialsSession
Added in [API level 26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public AccountManagerFuture startUpdateCredentialsSession (Account account,
String authTokenType,
Bundle options,
Activity activity,
AccountManagerCallback callback,
Handler handler)
```
Asks the user to enter a new password for the account but not updating the saved credentials for the account until `https://developer.android.com/reference/android/accounts/AccountManager#finishSession(android.os.Bundle,%20android.app.Activity,%20android.accounts.AccountManagerCallback,%20android.os.Handler)` is called.
This method may be called from any thread, but the returned `https://developer.android.com/reference/android/accounts/AccountManagerFuture` must not be used on the main thread.
**NOTE:** The saved credentials for the account alone will not be updated by calling this API alone. #finishSession should be called after this to update local credentials
| Parameters ||
|---|---|
| `account` | `Account`: The account to update credentials for
|
| `authTokenType` | `String`: The credentials entered must allow an auth token of this type to be created (but no actual auth token is returned); may be null
|
| `options` | `Bundle`: Authenticator-specific options for the request; may be null or empty
|
| `activity` | `Activity`: The `https://developer.android.com/reference/android/app/Activity` context to use for launching a new authenticator-defined sub-Activity to prompt the user to enter a password; used only to call startActivity(); if null, the prompt will not be launched directly, but the necessary `https://developer.android.com/reference/android/content/Intent` will be returned to the caller instead
|
| `callback` | `AccountManagerCallback`: Callback to invoke when the request completes, null for no callback
|
| `handler` | `Handler`: `https://developer.android.com/reference/android/os/Handler` identifying the callback thread, null for the main thread
|
| Returns ||
|---|---|
| `https://developer.android.com/reference/android/accounts/AccountManagerFuture` | An `https://developer.android.com/reference/android/accounts/AccountManagerFuture` which resolves to a Bundle with these fields if an activity was supplied and user was successfully re-authenticated to the account: - `https://developer.android.com/reference/android/accounts/AccountManager#KEY_ACCOUNT_SESSION_BUNDLE` - encrypted Bundle for updating the local credentials on device later. - `https://developer.android.com/reference/android/accounts/AccountManager#KEY_ACCOUNT_STATUS_TOKEN` - optional, token to check status of the account If no activity was specified, the returned Bundle contains `https://developer.android.com/reference/android/accounts/AccountManager#KEY_INTENT` with the `https://developer.android.com/reference/android/content/Intent` needed to launch the password prompt. If an error occurred, `https://developer.android.com/reference/android/accounts/AccountManagerFuture#getResult()` throws: - `https://developer.android.com/reference/android/accounts/AuthenticatorException` if the authenticator failed to respond - `https://developer.android.com/reference/android/accounts/OperationCanceledException` if the operation was canceled for any reason, including the user canceling the password prompt - `https://developer.android.com/reference/java/io/IOException` if the authenticator experienced an I/O problem verifying the password, usually because of network trouble
|
**See also:**
- `https://developer.android.com/reference/android/accounts/AccountManager#finishSession(android.os.Bundle,%20android.app.Activity,%20android.accounts.AccountManagerCallback,%20android.os.Handler)`
### updateCredentials
Added in [API level 5](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public AccountManagerFuture updateCredentials (Account account,
String authTokenType,
Bundle options,
Activity activity,
AccountManagerCallback callback,
Handler handler)
```
Asks the user to enter a new password for an account, updating the saved credentials for the account. Normally this happens automatically when the server rejects credentials during an auth token fetch, but this can be invoked directly to ensure we have the correct credentials stored.
This method may be called from any thread, but the returned `https://developer.android.com/reference/android/accounts/AccountManagerFuture` must not be used on the main thread.
**NOTE:** If targeting your app to work on API level 22 and before, MANAGE_ACCOUNTS permission is needed for those platforms. See docs for this function in API level 22.
Requires android.Manifest.permission.MANAGE_ACCOUNTS
| Parameters ||
|---|---|
| `account` | `Account`: The account to update credentials for
|
| `authTokenType` | `String`: The credentials entered must allow an auth token of this type to be created (but no actual auth token is returned); may be null
|
| `options` | `Bundle`: Authenticator-specific options for the request; may be null or empty
|
| `activity` | `Activity`: The `https://developer.android.com/reference/android/app/Activity` context to use for launching a new authenticator-defined sub-Activity to prompt the user to enter a password; used only to call startActivity(); if null, the prompt will not be launched directly, but the necessary `https://developer.android.com/reference/android/content/Intent` will be returned to the caller instead
|
| `callback` | `AccountManagerCallback`: Callback to invoke when the request completes, null for no callback
|
| `handler` | `Handler`: `https://developer.android.com/reference/android/os/Handler` identifying the callback thread, null for the main thread
|
| Returns ||
|---|---|
| `https://developer.android.com/reference/android/accounts/AccountManagerFuture` | An `https://developer.android.com/reference/android/accounts/AccountManagerFuture` which resolves to a Bundle with these fields if an activity was supplied and the account credentials were successfully updated: - `https://developer.android.com/reference/android/accounts/AccountManager#KEY_ACCOUNT_NAME` - the name of the account - `https://developer.android.com/reference/android/accounts/AccountManager#KEY_ACCOUNT_TYPE` - the type of the account If no activity was specified, the returned Bundle contains `https://developer.android.com/reference/android/accounts/AccountManager#KEY_INTENT` with the `https://developer.android.com/reference/android/content/Intent` needed to launch the password prompt. If an error occurred, `https://developer.android.com/reference/android/accounts/AccountManagerFuture#getResult()` throws: - `https://developer.android.com/reference/android/accounts/AuthenticatorException` if the authenticator failed to respond - `https://developer.android.com/reference/android/accounts/OperationCanceledException` if the operation was canceled for any reason, including the user canceling the password prompt - `https://developer.android.com/reference/java/io/IOException` if the authenticator experienced an I/O problem verifying the password, usually because of network trouble
|