AccountManager

ACTION_AUTHENTICATOR_INTENT

String ACTION_AUTHENTICATOR_INTENT

Constant Value: "android.accounts.AccountAuthenticator"

AUTHENTICATOR_ATTRIBUTES_NAME

String AUTHENTICATOR_ATTRIBUTES_NAME

Constant Value: "account-authenticator"

AUTHENTICATOR_META_DATA_NAME

String AUTHENTICATOR_META_DATA_NAME

Constant Value: "android.accounts.AccountAuthenticator"

ERROR_CODE_BAD_ARGUMENTS

int ERROR_CODE_BAD_ARGUMENTS

Constant Value: 7 (0x00000007)

ERROR_CODE_BAD_AUTHENTICATION

int ERROR_CODE_BAD_AUTHENTICATION

Constant Value: 9 (0x00000009)

ERROR_CODE_BAD_REQUEST

int ERROR_CODE_BAD_REQUEST

Constant Value: 8 (0x00000008)

ERROR_CODE_CANCELED

int ERROR_CODE_CANCELED

Constant Value: 4 (0x00000004)

ERROR_CODE_INVALID_RESPONSE

int ERROR_CODE_INVALID_RESPONSE

Constant Value: 5 (0x00000005)

ERROR_CODE_NETWORK_ERROR

int ERROR_CODE_NETWORK_ERROR

Constant Value: 3 (0x00000003)

ERROR_CODE_REMOTE_EXCEPTION

int ERROR_CODE_REMOTE_EXCEPTION

Constant Value: 1 (0x00000001)

ERROR_CODE_UNSUPPORTED_OPERATION

int ERROR_CODE_UNSUPPORTED_OPERATION

Constant Value: 6 (0x00000006)

KEY_ACCOUNTS

String KEY_ACCOUNTS

Constant Value: "accounts"

KEY_ACCOUNT_AUTHENTICATOR_RESPONSE

String KEY_ACCOUNT_AUTHENTICATOR_RESPONSE

Constant Value: "accountAuthenticatorResponse"

KEY_ACCOUNT_MANAGER_RESPONSE

String KEY_ACCOUNT_MANAGER_RESPONSE

Constant Value: "accountManagerResponse"

KEY_ACCOUNT_NAME

String KEY_ACCOUNT_NAME

Bundle key used for the String account name in results from methods which return information about a particular account.

Constant Value: "authAccount"

KEY_ACCOUNT_TYPE

String KEY_ACCOUNT_TYPE

Bundle key used for the String account type in results from methods which return information about a particular account.

Constant Value: "accountType"

KEY_ANDROID_PACKAGE_NAME

String KEY_ANDROID_PACKAGE_NAME

The Android package of the caller will be set in the options bundle by the 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

String KEY_AUTHENTICATOR_TYPES

Constant Value: "authenticator_types"

KEY_AUTHTOKEN

String KEY_AUTHTOKEN

Bundle key used for the auth token value in results from getAuthToken(Account, String, Bundle, Activity, AccountManagerCallback, Handler) and friends.

Constant Value: "authtoken"

KEY_AUTH_FAILED_MESSAGE

String KEY_AUTH_FAILED_MESSAGE

Constant Value: "authFailedMessage"

KEY_AUTH_TOKEN_LABEL

String KEY_AUTH_TOKEN_LABEL

Constant Value: "authTokenLabelKey"

KEY_BOOLEAN_RESULT

String KEY_BOOLEAN_RESULT

Constant Value: "booleanResult"

KEY_CALLER_PID

String KEY_CALLER_PID

Constant Value: "callerPid"

KEY_CALLER_UID

String KEY_CALLER_UID

Authenticators using 'customTokens' option will also get the UID of the caller

Constant Value: "callerUid"

KEY_ERROR_CODE

String KEY_ERROR_CODE

Constant Value: "errorCode"

KEY_ERROR_MESSAGE

String KEY_ERROR_MESSAGE

Constant Value: "errorMessage"

KEY_INTENT

String KEY_INTENT

Bundle key used for an 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

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

String KEY_PASSWORD

Bundle key used to supply the password directly in options to confirmCredentials(Account, Bundle, Activity, AccountManagerCallback, Handler), rather than prompting the user with the standard password prompt.

Constant Value: "password"

KEY_USERDATA

String KEY_USERDATA

Constant Value: "userdata"

LOGIN_ACCOUNTS_CHANGED_ACTION

String LOGIN_ACCOUNTS_CHANGED_ACTION

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.

Constant Value: "android.accounts.LOGIN_ACCOUNTS_CHANGED"

addAccount

AccountManagerFuture<Bundle> addAccount (String accountType, 
                String authTokenType, 
                String[] requiredFeatures, 
                Bundle addAccountOptions, 
                Activity activity, 
                AccountManagerCallback<Bundle> 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 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.

addAccountExplicitly

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 KEY_LAST_AUTHENTICATED_TIME. To update it, call notifyAccountAuthenticated(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.

addOnAccountsUpdatedListener

void addOnAccountsUpdatedListener (OnAccountsUpdateListener listener, 
                Handler handler, 
                boolean updateImmediately)

Adds an OnAccountsUpdateListener to this instance of the AccountManager. This listener will be notified whenever the list of accounts on the device changes.

As long as this listener is present, the AccountManager instance will not be garbage-collected, and neither will the 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 onCreate(Bundle) and removed in onDestroy().

The listener will only be informed of accounts that would be returned to the caller via getAccounts(). Typically this means that to get any accounts, the caller will need to be grated the GET_ACCOUNTS permission.

It is safe to call this method from the main thread.

blockingGetAuthToken

String blockingGetAuthToken (Account account, 
                String authTokenType, 
                boolean notifyAuthFailure)

This convenience helper synchronously gets an auth token with getAuthToken(Account, String, boolean, AccountManagerCallback, 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.

clearPassword

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.

confirmCredentials

AccountManagerFuture<Bundle> confirmCredentials (Account account, 
                Bundle options, 
                Activity activity, 
                AccountManagerCallback<Bundle> 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 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.

editProperties

AccountManagerFuture<Bundle> editProperties (String accountType, 
                Activity activity, 
                AccountManagerCallback<Bundle> 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 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.

get

AccountManager get (Context context)

Gets an AccountManager instance associated with a Context. The Context will be used as long as the AccountManager is active, so make sure to use a Context whose lifetime is commensurate with any listeners registered to addOnAccountsUpdatedListener(OnAccountsUpdateListener, Handler, boolean) or similar methods.

It is safe to call this method from the main thread.

No permission is required to call this method.

getAccounts

Account[] getAccounts ()

Lists all accounts of any type registered on the device. Equivalent to getAccountsByType(null).

It is safe to call this method from the main thread.

Clients of this method that have not been granted the GET_ACCOUNTS permission, will only see those accounts managed by AbstractAccountAuthenticators whose signature matches the client.

getAccountsByType

Account[] getAccountsByType (String type)

Lists all accounts of a particular type. 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.

It is safe to call this method from the main thread.

Clients of this method that have not been granted the 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 22 and before, GET_ACCOUNTS permission is needed for those platforms, irrespective of uid or signature match. See docs for this function in API level 22.

getAccountsByTypeAndFeatures

AccountManagerFuture<Account[]> getAccountsByTypeAndFeatures (String type, 
                String[] features, 
                AccountManagerCallback<Account[]> callback, 
                Handler handler)

Lists all accounts of a type which have certain features. The account type identifies the authenticator (see getAccountsByType(String)). Account features are authenticator-specific string tokens identifying boolean account properties (see hasFeatures(Account, String[], AccountManagerCallback, Handler)).

Unlike getAccountsByType(String), this method calls the authenticator, which may contact the server or do other work to check account features, so the method returns an AccountManagerFuture.

This method may be called from any thread, but the returned AccountManagerFuture must not be used on the main thread.

Clients of this method that have not been granted the GET_ACCOUNTS permission, will only see those accounts managed by AbstractAccountAuthenticators whose signature matches the client.

getAccountsByTypeForPackage

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.

getAuthToken

AccountManagerFuture<Bundle> getAuthToken (Account account, 
                String authTokenType, 
                Bundle options, 
                boolean notifyAuthFailure, 
                AccountManagerCallback<Bundle> 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 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 LOGIN_ACCOUNTS_CHANGED_ACTION Intent, 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 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.

getAuthToken

AccountManagerFuture<Bundle> getAuthToken (Account account, 
                String authTokenType, 
                Bundle options, 
                Activity activity, 
                AccountManagerCallback<Bundle> 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 AccountManagerFuture must not be used on the main thread.

getAuthToken

AccountManagerFuture<Bundle> getAuthToken (Account account, 
                String authTokenType, 
                boolean notifyAuthFailure, 
                AccountManagerCallback<Bundle> callback, 
                Handler handler)

This method was deprecated in API level 14.
use getAuthToken(Account, String, android.os.Bundle, boolean, AccountManagerCallback, android.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 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 LOGIN_ACCOUNTS_CHANGED_ACTION Intent, 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 AccountManagerFuture must not be used on the main thread.

getAuthTokenByFeatures

AccountManagerFuture<Bundle> getAuthTokenByFeatures (String accountType, 
                String authTokenType, 
                String[] features, 
                Activity activity, 
                Bundle addAccountOptions, 
                Bundle getAuthTokenOptions, 
                AccountManagerCallback<Bundle> callback, 
                Handler handler)

This convenience helper combines the functionality of getAccountsByTypeAndFeatures(String, String[], AccountManagerCallback, Handler), getAuthToken(Account, String, Bundle, Activity, AccountManagerCallback, Handler), and addAccount(String, String, String[], Bundle, Activity, AccountManagerCallback, Handler).

This method gets a list of the accounts matching the specified type and feature set; if there is exactly one, it is used; if there are more than one, 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 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.

getAuthenticatorTypes

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.

getPassword

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 22 and before, AUTHENTICATE_ACCOUNTS permission is needed for those platforms. See docs for this function in API level 22.

getPreviousName

String getPreviousName (Account account)

Gets the previous name associated with the account or null, if none. This is intended so that clients of LOGIN_ACCOUNTS_CHANGED_ACTION broadcasts can determine if an authenticator has renamed an account.

It is safe to call this method from the main thread.

getUserData

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 22 and before, AUTHENTICATE_ACCOUNTS permission is needed for those platforms. See docs for this function in API level 22.

hasFeatures

AccountManagerFuture<Boolean> hasFeatures (Account account, 
                String[] features, 
                AccountManagerCallback<Boolean> 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 AccountManagerFuture must not be used on the main thread.

This method requires the caller to hold the permission GET_ACCOUNTS or be a signature match with the AbstractAccountAuthenticator that manages the account.

invalidateAuthToken

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.

newChooseAccountIntent

Intent newChooseAccountIntent (Account selectedAccount, 
                List<Account> allowableAccounts, 
                String[] allowableAccountTypes, 
                String descriptionOverrideText, 
                String addAccountAuthTokenType, 
                String[] addAccountRequiredFeatures, 
                Bundle addAccountOptions)

Returns an intent to an 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 KEY_ACCOUNT_NAME and KEY_ACCOUNT_TYPE.

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);

newChooseAccountIntent

Intent newChooseAccountIntent (Account selectedAccount, 
                ArrayList<Account> allowableAccounts, 
                String[] allowableAccountTypes, 
                boolean alwaysPromptForAccount, 
                String descriptionOverrideText, 
                String addAccountAuthTokenType, 
                String[] addAccountRequiredFeatures, 
                Bundle addAccountOptions)

Deprecated in favor of newChooseAccountIntent(Account, List, String[], String, String, String[], Bundle). Returns an intent to an 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 KEY_ACCOUNT_NAME and KEY_ACCOUNT_TYPE.

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);

notifyAccountAuthenticated

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.

peekAuthToken

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.

removeAccount

AccountManagerFuture<Bundle> removeAccount (Account account, 
                Activity activity, 
                AccountManagerCallback<Bundle> 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 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.

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.

removeAccount

AccountManagerFuture<Boolean> removeAccount (Account account, 
                AccountManagerCallback<Boolean> callback, 
                Handler handler)

This method was deprecated in API level 22.
use removeAccount(Account, Activity, AccountManagerCallback, 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.

removeAccountExplicitly

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.

removeOnAccountsUpdatedListener

void removeOnAccountsUpdatedListener (OnAccountsUpdateListener listener)

Removes an OnAccountsUpdateListener previously registered with addOnAccountsUpdatedListener(OnAccountsUpdateListener, Handler, boolean). 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.

renameAccount

AccountManagerFuture<Account> renameAccount (Account account, 
                String newName, 
                AccountManagerCallback<Account> callback, 
                Handler handler)

Rename the specified 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.

setAuthToken

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.

setPassword

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 KEY_LAST_AUTHENTICATED_TIME. To update it, call notifyAccountAuthenticated(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.

setUserData

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.

updateCredentials

AccountManagerFuture<Bundle> updateCredentials (Account account, 
                String authTokenType, 
                Bundle options, 
                Activity activity, 
                AccountManagerCallback<Bundle> 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 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.