此页面由 Cloud Translation API 翻译。

直接从您的平台发起 Google 账号关联。

关联帐号可以直接在移动应用中完成，这样您就可以让用户将您服务的帐号与 Google 帐号相关联。建立的关联可向 Google 授予用户同意共享的数据的访问权限。

用户可享有的优势包括：

用户可以在您的应用中开始并完成帐号关联流程，这是他们熟悉的环境。
用户无需登录凭据，因为已在设备和您的移动应用中通过身份验证。

开发者获得的好处包括：

在移动应用中（例如，在用户设置中，在插页式广告上或用户登录移动应用后）宣传和启动帐号关联，以提高互动度和关联的帐号数量。
转化率有所提高，因为用户可以完成的步骤比基于网络的标准 OAuth 流程少。
实现您的平台 (Android) 链接的工程工作量很少，因为此流程已利用您现有的 OAuth2.0 实现（假设您已实现一个）。
提升了用户流失率，因为用户无需重新输入登录凭据，用更少的步骤就能完成此流程。在要求用户召回和输入登录凭据的流程中，流失率可能高达 80%。

工作原理

要从您的平台进行关联，请按照下列步骤完成：

用户将在您的移动应用上点击 / 切换关联触发器。
用户选择要关联的 Google 账号。
1. 用户在设备上选择要关联的现有 Google 账号，或使用新账号登录
系统会向用户显示由 Google 托管的同意屏幕，用户必须同意才能继续或取消，才能停止关联流程。
用户会看到您的同意屏幕，只有在用户同意后才能继续或取消，才能停止关联流程。
用户在您的服务上的账号与其 Google 账号之间建立了关联。

图 1. 在平台流程中关联

要求

如需在您的平台中实现链接，您需要满足以下条件：

Android 应用。
拥有、管理和维护支持 OAuth 2.0 授权代码流程的 OAuth 2.0 服务器。

设置

在继续执行下列步骤之前，您必须已完成账号关联注册流程。

设置开发环境

在开发主机上获取最新的 Google Play 服务：

打开 Android SDK 管理器。

。

在 SDK Tools 下，找到 Google Play 服务。
如果这些软件包的状态均未为“已安装”，请同时选择它们并点击 Install Packages。

配置您的应用

在项目级 build.gradle 文件中，同时在 buildscript 和 allprojects 部分添加 Google 的 Maven 制品库。

buildscript {
    repositories {
        google()
    }
}

allprojects {
    repositories {
        google()
    }
}

将“Link with Google”API 的依赖项添加到模块的应用级 Gradle 文件（通常为 app/build.gradle）：
```
dependencies {
  implementation 'com.google.android.gms:play-services-auth:21.2.0'
}
```

添加对“从平台链接”的支持

执行“通过平台关联”流程后，Google 会保存由您的服务提供的访问令牌。必须先征得用户同意，然后才能为用户返回令牌。

请按照以下步骤征得用户同意，并通过 Google Play 服务 SDK 返回授权代码令牌。

构建一个可启动意见征求 activity 的 PendingIntent - 意见征求由 Play Services 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。

参考

Android 身份验证 API 参考文档