Google Credential Manager getId()方法返回Google ID而非Gmail账户邮箱的问题

问题根源 #

部分Google账号（如工作/教育账号、特殊设置的个人账号）默认不会通过credential.id返回邮箱地址，且直接依赖该字段不符合Credential Manager的设计规范——credential.id是凭证的唯一标识符，并非专门用于获取邮箱的字段。正确的邮箱获取方式应通过GoogleIdTokenCredential的专属方法。

解决步骤 #

1. 显式请求邮箱权限
   在构建GetSignInWithGoogleOption时，添加email和profile权限范围，确保账号授权时返回邮箱信息：

   private val signInWithGoogleOption = GetSignInWithGoogleOption.Builder(serverClientId = SERVER_CLIENT_ID)
       .setScopes(listOf("email", "profile"))
       .build()
   

2. 正确转换凭证类型并获取邮箱
   不要直接使用通用Credential对象的id字段，而是将其转换为GoogleIdTokenCredential，调用email属性获取邮箱：

   private suspend fun googleSignIn(
       activity: Activity,
       onSuccess: (GoogleIdTokenCredential) -> Unit
   ) {
       val request = GetCredentialRequest.Builder()
           .addCredentialOption(signInWithGoogleOption)
           .build()
   
       val result = credentialManager.getCredential(activity, request)
       // 转换为GoogleIdTokenCredential
       val googleCredential = result.credential as GoogleIdTokenCredential
       Timber.d("账户邮箱: ${googleCredential.email}")
       Timber.d("Google ID: ${googleCredential.id}") // 此处id为Google账户ID，如需邮箱请用email字段
       onSuccess(googleCredential)
   }
   

3. 检查OAuth同意屏幕配置
   登录Google Cloud控制台，确保OAuth同意屏幕中已添加email和profile权限范围，且测试账号已被添加到测试用户列表（若应用处于测试状态）。

4. 考虑升级库版本
   当前使用的是Beta版本（1.5.0-beta01），可能存在已知问题。建议尝试升级到最新稳定版（如1.4.0）或最新Beta版，确认是否修复了账号类型兼容问题：

   implementation "androidx.credentials:credentials:1.4.0"
   implementation "androidx.credentials:credentials-play-services-auth:1.4.0"
   

内容的提问来源于stack exchange，提问作者Caner Gulgec