关联帐号可以直接在移动应用中完成，这样您就可以让用户将您服务的帐号与 Google 帐号相关联。建立的关联可向 Google 授予用户同意共享的数据的访问权限。
用户可享有的优势包括：
- 用户可以在您的应用中开始并完成帐号关联流程，这是他们熟悉的环境。
- 用户无需登录凭据，因为已在设备和您的移动应用中通过身份验证。
开发者获得的好处包括：
- 在移动应用中（例如，在用户设置中，在插页式广告上或用户登录移动应用后）宣传和启动帐号关联，以提高互动度和关联的帐号数量。
- 转化率有所提高，因为用户可以完成的步骤比基于网络的标准 OAuth 流程少。
- 实现您的平台 (Android) 链接的工程工作量很少，因为此流程已利用您现有的 OAuth2.0 实现（假设您已实现一个）。
- 提升了用户流失率，因为用户无需重新输入登录凭据，用更少的步骤就能完成此流程。 在要求用户召回和输入登录凭据的流程中，流失率可能高达 80%。
运作方式
如需通过您的平台建立关联，请按以下步骤操作：
- 用户将在您的移动应用中点击 / 切换关联触发器。
- 用户选择要关联的 Google 账号。
- 用户选择设备上的现有 Google 账号进行关联，或使用新账号登录
- 系统会向用户显示由 Google 托管的意见征求界面，用户必须同意继续或取消才能停止关联流程。
- 系统会向用户显示您的意见征求界面，用户必须同意继续或取消才能停止关联流程。
- 系统会在用户在您服务中的账号与其 Google 账号之间建立关联。
图 1. 通过平台流程建立关联
要求
如需从您的平台实现关联，您需要满足以下条件：
- Android 应用。
- 拥有、管理和维护支持 OAuth 2.0 授权代码流程的 OAuth 2.0 服务器。
设置
在继续执行以下步骤之前，您必须已完成账号关联注册流程。
设置开发环境
在开发主机上获取最新的 Google Play 服务：
- 打开 Android SDK 管理器。
在 SDK Tools 下，找到 Google Play 服务。
如果这些软件包的状态不是“已安装”，请同时选择这两个软件包，然后点击安装软件包。
配置您的应用
在项目级
build.gradle文件中，同时在buildscript和allprojects两个部分中添加 Google 的 Maven 代码库。buildscript { repositories { google() } } allprojects { repositories { google() } }将“与 Google 关联”API 的依赖项添加到模块的应用级 Gradle 文件（通常为
app/build.gradle）中：dependencies { implementation 'com.google.android.gms:play-services-auth:21.3.0' }
在您的平台中添加对 Link 的支持
通过平台流程建立关联会导致 Google 保存您的服务提供的访问令牌。必须先征得用户同意，然后才能返回用户的令牌。
请按照以下步骤获取用户同意，并通过 Google Play 服务 SDK 返回授权代码令牌。
构建一个可启动意见征求 activity 的 PendingIntent - 意见征求由 Play 服务 API 启动。调用 API 时，您需要提供
PendingIntent（为方便起见，以下简称consentPendingIntent）Kotlin
// Build a PendingIntent that can launch the consent activity val consentPendingIntent = buildConsentPendingIntent()Java
// Build a PendingIntent that can launch your consent activity PendingIntent consentPendingIntent = buildConsentPendingIntent();创建相应的 activity 来处理意见征求 intent
Kotlin
class ConsentActivity : AppCompatActivity private fun onConsentAccepted() { // Obtain a token (for simplicity, we’ll ignore the async nature // of the following call) val token = getToken() val intent = Intent() .putExtra(SaveAccountLinkingTokenRequest.EXTRA_TOKEN, token) setResult(Activity.RESULT_OK, intent) finish() } private fun onConsentRejectedOrCanceled() { setResult(Activity.RESULT_CANCELED) finish() }Java
public class ConsentActivity extends AppCompatActivity { ... private void onConsentAccepted() { // Obtain a token (for simplicity, we’ll ignore the async nature of // the following call String token = getToken(); Intent intent = new Intent(); intent.putExtra(SaveAccountLinkingTokenRequest.EXTRA_TOKEN, token); setResult(Activity.RESULT_OK, intent); finish(); } private void onConsentRejectedOrCanceled() { setResult(Activity.RESULT_CANCELED, null); finish(); } }我们假定，如果用户接受或拒绝/取消您的意见征求，系统会分别调用
onConsentAccpeted()和onConsentRejectedOrCanceled()方法。创建用于保存令牌的请求，并在其他配置参数中传递上文第 1 步中创建的
PendingIntent。Kotlin
// Create an ActivityResultLauncher which registers a callback for the // Activity result contract val activityResultLauncher = registerForActivityResult( ActivityResultContracts.StartIntentSenderForResult()) { result -> if (result.resultCode == RESULT_OK) { // Successfully finished the flow and saved the token } else { // Flow failed, for example the user may have canceled the flow } } // Build token save request val request = SaveAccountLinkingTokenRequest.builder() .setTokenType(SaveAccountLinkingTokenRequest.TOKEN_TYPE_AUTH_CODE) .setConsentPendingIntent(consentPendingIntent) .setServiceId("service-id-of-and-defined-by-developer") //Set the scopes that the token is valid for on your platform .setScopes(scopes) .build() // Launch consent activity and retrieve token Identity.getCredentialSavingClient(this) .saveAccountLinkingToken(request) .addOnSuccessListener( saveAccountLinkingTokenResult -> { if (saveAccountLinkingTokenResult.hasResolution()) { val pendingIntent = saveAccountLinkingTokenResult .getPendingIntent() val intentSenderRequest = IntentSenderRequest .Builder(pendingIntent).build() activityResultLauncher.launch(intentSenderRequest) } else { // This should not happen, let’s log this Log.e(TAG, "Failed to save token"); } }) .addOnFailureListener(e -> Log.e(TAG, “Failed to save token”, e))Java
// Create an ActivityResultLauncher which registers a callback for the // Activity result contract ActivityResultLauncher<IntentSenderRequest> activityResultLauncher = registerForActivityResult(new ActivityResultContracts .StartIntentSenderForResult(), result -> { if (result.getResultCode() == RESULT_OK) { // Successfully finished the flow and saved the token } else { // Flow failed, for example the user may have canceled the flow } }); // Build token save request SaveAccountLinkingTokenRequest request = SaveAccountLinkingTokenRequest.builder() .setTokenType( SaveAccountLinkingTokenRequest.TOKEN_TYPE_AUTH_CODE) .setConsentPendingIntent(consentPendingIntent) .setServiceId("service-id-of-and-defined-by-developer") //Set the scopes that the token is valid for on your platform .setScopes(scopes) .build(); // Launch consent activity and retrieve token Identity.getCredentialSavingClient(this) .saveAccountLinkingToken(request) .addOnSuccessListener( saveAccountLinkingTokenResult -> { if (saveAccountLinkingTokenResult.hasResolution()) { // Launch the resolution intent PendingIntent pendingIntent = saveAccountLinkingTokenResult.getPendingIntent(); IntentSenderRequest intentSenderRequest = new IntentSenderRequest.Builder(pendingIntent).build(); activityResultLauncher.launch(intentSenderRequest); } else { // This should not happen, let’s log this Log.e(TAG, "Failed to save token"); } }) .addOnFailureListener(e -> Log.e(TAG, "Failed to save token", e)); ```
上述步骤会提示用户同意，并将授权代码返回给 Google。
最佳做法
您的应用应通过按钮、切换开关或类似的视觉元素向用户指明链接状态。
图 1. 关联状态图片示例
您应在关联成功后通知用户，例如显示一条消息、触发切换开关状态的更改或将用户重定向到单独的关联成功页面。
您应考虑提示应用内用户关联账号，最好能根据关联账号对此类用户有益的明确信号来提示。
成功关联后，您应举例说明如何使用关联的账号，例如，如果您刚刚关联了音乐在线播放服务，请让 Google 助理播放音乐。
允许用户管理其关联的账号，包括解除关联的选项。请将他们引导至 Google 关联账号管理页面，即 https://myaccount.google.com/accountlinking。