AccountManager.GetAccountsByType(String) 方法

定義

命名空間:

Android.Accounts

組件:

Mono.Android.dll

列出呼叫端可看見之特定類型的所有帳戶。

[Android.Runtime.Register("getAccountsByType", "(Ljava/lang/String;)[Landroid/accounts/Account;", "GetGetAccountsByType_Ljava_lang_String_Handler")]
[Android.Runtime.RequiresPermission("android.permission.GET_ACCOUNTS")]
public virtual Android.Accounts.Account[] GetAccountsByType (string? type);

[<Android.Runtime.Register("getAccountsByType", "(Ljava/lang/String;)[Landroid/accounts/Account;", "GetGetAccountsByType_Ljava_lang_String_Handler")>]
[<Android.Runtime.RequiresPermission("android.permission.GET_ACCOUNTS")>]
abstract member GetAccountsByType : string -> Android.Accounts.Account[]
override this.GetAccountsByType : string -> Android.Accounts.Account[]

參數

type

String

要傳回的帳戶類型，要擷取所有帳戶的 Null

傳回

Account[]

的陣列 Account，每個相符帳戶各一個。 如果未加入指定類型的帳戶，則為空白 （永遠為 null）。

屬性

RegisterAttribute RequiresPermissionAttribute

備註

列出呼叫端可看見之特定類型的所有帳戶。 這些帳戶可能會顯示，因為使用者授與帳戶的存取權，或管理帳戶的 AbstractAccountAuthenticator 這樣做，或是因為用戶端與管理 AbstractAccountAuthenticator 共用簽章。

帳戶類型是對應至驗證器和帳戶實用網域的字串令牌。 例如，有對應至Google和Facebook的類型。 要使用的確切字串令牌將會發佈與有問題的驗證器相關聯的某個位置。

<div class=“caution”>

<b>注意： </b>此方法會傳回個人和敏感數據。 如果您的應用程式存取、收集、使用或共用個人和敏感數據，您必須明確地向使用者披露該事實。 針對在Google Play上發佈的應用程式，保護使用者數據的原則會要求您執行下列動作：

<ul><li>向使用者透露您的應用程式如何存取、收集、使用或共用個人和敏感數據。 深入瞭解可接受的披露和同意。</li li><>提供一項隱私策略，說明您在裝置和裝置上使用此數據。</li></ul>

若要深入瞭解，請瀏覽 有關用戶數據的 Google Play 原則。

</div>

從主線程呼叫此方法是安全的。

以 API 層級和更新層級 android.os.Build.VERSION_CODES#O 為目標的呼叫端，將會取得使用者顯示帳戶清單（請參閱 #newChooseAccountIntent(Account, List, String[], String, String, String[], Bundle)） 或 AbstractAccountAuthenticator 使用 #setAccountVisibility。 android.Manifest.permission#GET_ACCOUNTS 未使用許可權。

以未授android.Manifest.permission#GET_ACCOUNTS與許可權的 API 層級為目標android.os.Build.VERSION_CODES#O的呼叫端只會看到簽章符合用戶端的 AbstractAccountAuthenticator 所管理的帳戶。

<b>注意：</b> 如果以您的應用程式為目標來處理 API 層級 android.os.Build.VERSION_CODES#LOLLIPOP_MR1 ，而且在之前， android.Manifest.permission#GET_ACCOUNTS 無論 uid 或簽章相符，都需要這些平台的許可權。 請參閱 API 層級 android.os.Build.VERSION_CODES#LOLLIPOP_MR1中此函式的檔。

的 android.accounts.AccountManager.getAccountsByType(java.lang.String)Java 檔。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。