Связывание учетной записи можно выполнить непосредственно в мобильном приложении, что позволит вашим пользователям связать свою учетную запись в вашем сервисе со своей учетной записью Google. Установленная ссылка предоставляет Google доступ к данным, которыми пользователь соглашается поделиться.
Этот подход повышает производительность привязки учетных записей, привлекая пользователей в знакомом контексте вашего приложения, а не в разговоре с Ассистентом. Его можно интегрировать в регистрацию пользователей, настройки и другие поверхности приложения, создавая возможности для обнаружения и использования вашего действия Google Assistant. Например, после связывания вы можете предложить пользователю сразу перейти к вашему действию.
Преимущества для пользователей включают в себя:
- Пользователи могут начать и завершить процесс связывания учетных записей в вашем приложении, среде, с которой они уже знакомы.
- Пользователям не требуются учетные данные для входа, поскольку они уже прошли аутентификацию на устройстве и в вашем мобильном приложении.
К преимуществам для разработчиков относятся:
- Контролируйте, где рекламировать и инициировать привязку учетной записи в вашем мобильном приложении, например, в настройках пользователя, в межстраничных объявлениях или после того, как пользователь войдет в ваше мобильное приложение. Добавление нескольких точек входа для инициирования связывания учетных записей помогает сделать связывание учетных записей более заметным, что приводит к увеличению вовлеченности и увеличению количества связанных учетных записей.
- Повышение коэффициента конверсии, поскольку пользователи могут завершить процесс связывания за меньшее количество шагов, чем стандартный веб-процесс OAuth .
- Для реализации Link с вашей платформы (Android) требуются небольшие инженерные усилия, поскольку этот процесс использует вашу существующую реализацию OAuth2.0, при условии, что она у вас уже реализована.
- Снижение количества отказов, поскольку пользователям не нужно повторно вводить свои учетные данные для входа, и они могут завершить процесс за меньшее количество шагов. Процент отказов может достигать 80 % в потоках, где пользователям необходимо вспомнить и ввести свои учетные данные для входа.
运作方式
从您的平台关联账号的步骤如下：
- 用户将点击 / 切换移动应用中的关联触发器。
- 用户选择要关联的 Google 账号。
- 用户选择设备上现有的 Google 账号进行关联，或使用新账号登录
- 系统会向用户显示 Google 托管的同意屏幕，用户必须同意才能继续，或取消以停止账号关联过程。
- 系统会向用户显示您的权限请求页面，用户必须同意才能继续，或取消以停止账号关联过程。
- 在用户在您的服务中的账号与其 Google 账号之间建立关联。
图 1. 从您的平台关联账号的流程
要求
如需实现从您的平台关联账号，您需要满足以下条件：
- 一个 Android 应用。
- 拥有、管理和维护支持 OAuth 2.0 授权代码流程的 OAuth 2.0 服务器。
设置
在继续执行以下步骤之前，您必须已完成账号关联注册流程。
设置开发环境
在开发主机上获取最新的 Google Play 服务：
- 打开 Android SDK 管理器。
在 SDK 工具 下，找到 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.6.0' }
添加对从您的平台关联账号的支持
从您的平台关联账号的流程会导致 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. 关联状态图片示例
关联成功后，您应通知用户，例如显示 Toast 消息、触发切换开关状态更改或将用户重定向到单独的关联成功页面。
您应考虑提示应用内用户关联账号，最好是根据强信号（表明关联账号对这些用户有益）来提示。
成功关联后，您应向用户提供有关如何使用关联账号的示例，例如，如果您刚刚关联了音乐在线播放服务，请让 Google 助理播放音乐。
让用户能够管理其关联的账号，包括取消关联的选项。引导用户前往其 Google 关联账号管理页面，即 https://myaccount.google.com/accountlinking。