IAccountManager.aidl revision 390c9d2d91117c767b27e33e906f7830b4c0a4dc 
1/*
2 * Copyright (C) 2009 The Android Open Source Project
3 *
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
7 *
8 *      http://www.apache.org/licenses/LICENSE-2.0
9 *
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
15 */
16
17package android.accounts;
18
19import android.accounts.IAccountManagerResponse;
20import android.accounts.Account;
21import android.accounts.AuthenticatorDescription;
22import android.os.Bundle;
23
24
25/**
26 * Central application service that provides account management.
27 * @hide
28 */
29interface IAccountManager {
30    String getPassword(in Account account);
31    String getUserData(in Account account, String key);
32    AuthenticatorDescription[] getAuthenticatorTypes(int userId);
33    Account[] getAccounts(String accountType, String opPackageName);
34    Account[] getAccountsForPackage(String packageName, int uid, String opPackageName);
35    Account[] getAccountsByTypeForPackage(String type, String packageName, String opPackageName);
36    Account[] getAccountsAsUser(String accountType, int userId, String opPackageName);
37    void hasFeatures(in IAccountManagerResponse response, in Account account, in String[] features,
38        String opPackageName);
39    void getAccountsByFeatures(in IAccountManagerResponse response, String accountType,
40        in String[] features, String opPackageName);
41    boolean addAccountExplicitly(in Account account, String password, in Bundle extras);
42    void removeAccount(in IAccountManagerResponse response, in Account account,
43        boolean expectActivityLaunch);
44    void removeAccountAsUser(in IAccountManagerResponse response, in Account account,
45        boolean expectActivityLaunch, int userId);
46    boolean removeAccountExplicitly(in Account account);
47    void copyAccountToUser(in IAccountManagerResponse response, in Account account,
48        int userFrom, int userTo);
49    void invalidateAuthToken(String accountType, String authToken);
50    String peekAuthToken(in Account account, String authTokenType);
51    void setAuthToken(in Account account, String authTokenType, String authToken);
52    void setPassword(in Account account, String password);
53    void clearPassword(in Account account);
54    void setUserData(in Account account, String key, String value);
55    void updateAppPermission(in Account account, String authTokenType, int uid, boolean value);
56
57    void getAuthToken(in IAccountManagerResponse response, in Account account,
58        String authTokenType, boolean notifyOnAuthFailure, boolean expectActivityLaunch,
59        in Bundle options);
60    void addAccount(in IAccountManagerResponse response, String accountType,
61        String authTokenType, in String[] requiredFeatures, boolean expectActivityLaunch,
62        in Bundle options);
63    void addAccountAsUser(in IAccountManagerResponse response, String accountType,
64        String authTokenType, in String[] requiredFeatures, boolean expectActivityLaunch,
65        in Bundle options, int userId);
66    void updateCredentials(in IAccountManagerResponse response, in Account account,
67        String authTokenType, boolean expectActivityLaunch, in Bundle options);
68    void editProperties(in IAccountManagerResponse response, String accountType,
69        boolean expectActivityLaunch);
70    void confirmCredentialsAsUser(in IAccountManagerResponse response, in Account account,
71        in Bundle options, boolean expectActivityLaunch, int userId);
72    boolean accountAuthenticated(in Account account);
73    void getAuthTokenLabel(in IAccountManagerResponse response, String accountType,
74        String authTokenType);
75
76    /* Shared accounts */
77    Account[] getSharedAccountsAsUser(int userId);
78    boolean removeSharedAccountAsUser(in Account account, int userId);
79    void addSharedAccountsFromParentUser(int parentUserId, int userId);
80
81    /* Account renaming. */
82    void renameAccount(in IAccountManagerResponse response, in Account accountToRename, String newName);
83    String getPreviousName(in Account account);
84    boolean renameSharedAccountAsUser(in Account accountToRename, String newName, int userId);
85
86    /* Add account in two steps. */
87    void startAddAccountSession(in IAccountManagerResponse response, String accountType,
88        String authTokenType, in String[] requiredFeatures, boolean expectActivityLaunch,
89        in Bundle options);
90
91    /* Update credentials in two steps. */
92    void startUpdateCredentialsSession(in IAccountManagerResponse response, in Account account,
93        String authTokenType, boolean expectActivityLaunch, in Bundle options);
94
95    /* Finish session started by startAddAccountSession(...) or startUpdateCredentialsSession(...) */
96    void finishSession(in IAccountManagerResponse response, in Bundle sessionBundle,
97        boolean expectActivityLaunch, in Bundle appInfo);
98
99    /* Check if an account exists on any user on the device. */
100    boolean someUserHasAccount(in Account account);
101
102    /* Check if credentials update is suggested */
103    void isCredentialsUpdateSuggested(in IAccountManagerResponse response, in Account account,
104        String statusToken);
105}
106