AccountManager.GetAccountsByType(String) 方法

定义

列出对调用方可见的特定类型的所有帐户。

[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数组,每个匹配帐户一个。 如果未添加指定类型的帐户,则为空(从不为 null)。

属性

注解

列出对调用方可见的特定类型的所有帐户。 这些帐户可能可见,因为用户授予了对帐户的访问权限,或者管理帐户的 AbstractAccountAuthenticator 这样做,或者客户端与管理 AbstractAccountAuthenticator 共享签名。

帐户类型是一个字符串令牌,对应于该帐户的验证器和有用的域。 例如,有与 Google 和 Facebook 对应的类型。 要使用的确切字符串令牌将发布到与相关验证器关联的某个位置。

<div class=“warning”>

<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权限的 android.os.Build.VERSION_CODES#O API 级别的调用方将仅看到由其签名与客户端匹配的 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 属性许可证中所述的术语使用。

适用于