總覽

借助基于 OAuth 的应用快速关联 (App Flip)，您的用户可以轻松快速地将其在您的身份验证系统中的账号与其 Google 账号相关联。如果用户在发起账号关联流程时您的应用已安装在其手机上，系统会将用户顺畅地转到您的应用以获取用户授权。

这种方法可简化关联流程，因为用户无需重新输入用户名和密码即可进行身份验证；相反，App Flip 会利用用户在您应用中的账号凭据。用户将其 Google 账号与您的应用相关联后，便可使用您开发的任何集成。

您可以为 iOS 和 Android 应用设置应用快速关联。

此图展示了用户将其 Google 账号与您的身份验证系统相关联的步骤。第一个屏幕截图显示了如果用户的 Google 账号已与您的应用相关联，他们可以如何选择您的应用。第二个屏幕截图显示了确认将 Google 账号与您的应用相关联的操作。第三个屏幕截图显示了 Google 应用中已成功关联的用户账号。
图 1. 在用户手机上使用 App Flip 进行账号关联。

要求

如需实现应用翻转，您必须满足以下要求：

  • 您必须拥有 Android 或 iOS 应用。
  • 您必须拥有、管理和维护一个支持 OAuth 2.0 授权代码流程的 OAuth 2.0 服务器。

如要進一步瞭解 OAuth 連結授權碼流程，請參閱「實作 OAuth 伺服器」。

设计准则

本部分介绍了应用翻转账号关联同意屏幕的设计要求和建议。在 Google 调用您的应用后，您的应用会向用户显示同意屏幕。

要求

  1. 您必须告知用户，其账号将与 Google 关联，而非与 Google Home 或 Google 助理等特定 Google 产品关联。

建议

建议您执行以下操作：

  1. 显示 Google 的隐私权政策。在意见征求屏幕上添加指向 Google 隐私权政策的链接。

  2. 要分享的数据。使用简洁明了的语言告知用户 Google 需要哪些用户数据以及原因。

  3. 明确的号召性用语。在同意屏幕上提供清晰的号召性用语，例如“同意并关联”。这是因为用户需要了解他们必须与 Google 分享哪些数据才能关联其账号。

  4. 能够拒绝或取消。如果用户选择不关联，请提供一种供用户返回、拒绝或取消的方式。

  5. 能够解除关联。提供一种可供用户取消关联的机制，例如指向您平台上的账号设置的网址。或者，您也可以添加指向 Google 账号的链接，以便用户管理其关联的账号。

  6. 能够更改用户账号。建议用户切换账号的方法。如果用户倾向于使用多个账号，此功能尤其有用。

    • 如果用户必须关闭同意屏幕才能切换账号，请向 Google 发送可恢复的错误，以便用户可以通过 OAuth 关联和隐式流程登录所需账号。

  7. 添加您的徽标。在权限请求页面上显示公司徽标。 根据样式指南放置徽标。如果您还想显示 Google 的徽标，请参阅徽标和商标。

此图显示了一个同意屏幕示例，其中包含在设计用户同意屏幕时应遵循的各项要求和建议。
图 2. 账号关联意见征求界面设计指南。

設定以 OAuth 為基礎的應用程式切換功能

以下章節說明 OAuth 型應用程式切換的必要條件，以及如何在 Actions 控制台中設定應用程式切換專案。

建立動作並設定 OAuth 2.0 伺服器

設定應用程式切換功能前，請先完成下列事項：

  • 建立動作。如要建立動作，請按照「建立專案」一節的指示操作。
  • 設定 OAuth 2.0 伺服器。如要進一步瞭解如何設定 OAuth 伺服器，請參閱「實作 OAuth 帳戶連結」。

在 Actions 控制台中設定應用程式切換

下一節說明如何在 Actions 控制台中設定應用程式切換功能。

  1. 按一下頂端導覽列中的「開發」。然後按一下左側導覽中的「帳戶連結」。
  2. 將「帳戶連結」旁邊的切換鈕設為開啟。
  3. 在「帳戶建立」下方，選取「否，我只想允許在我的網站上建立帳戶」。
  4. 點選 [下一步]。
  5. 在「連結類型」下方，從下拉式選單中選取「OAuth」和「授權碼」。
  6. 按一下「繼續」。
  7. 填寫「OAuth 用戶端資訊」下方的所有欄位。 (如果系統不支援應用程式切換，會改用一般 OAuth)。
  8. 點選 [下一步]。
  9. 在「使用應用程式連結帳戶 (選用)」下方，勾選「為 iOS 啟用」。
  10. 填寫「通用連結」欄位。如要進一步瞭解通用連結，請參閱「允許應用程式和網站連結至您的內容 」。
  11. 如要視需要設定用戶端，請新增範圍，然後按一下「設定用戶端 (選用)」下方的「新增範圍」。 如果沒有，請按一下「下一步」。
  12. 在「測試說明」下方，輸入 test (或其他任何字串) 做為預留位置。(只有在您實際提交要發布的動作時，才需要填寫這個欄位。)
  13. 按一下 [儲存]。

現在可以繼續前往下一節，在 iOS 或 Android 應用程式中導入 App Flip。

在原生應用程式中導入 App Flip

如要導入應用程式切換功能，您必須修改應用程式中的使用者授權碼，接受來自 Google 的深層連結。

在裝置上測試應用程式切換功能

您已在管理中心和應用程式中建立動作並設定應用程式切換功能，現在可以在行動裝置上測試這項功能。您可以使用 Google 助理應用程式測試應用程式切換功能。

如要透過 Google 助理應用程式測試應用程式切換功能，請按照下列步驟操作：

  1. 前往 Actions 控制台，然後選取專案。
  2. 按一下頂端導覽列中的「測試」。
  3. 從 Google 助理應用程式觸發帳戶連結流程：
    1. 開啟 Google 助理應用程式。
    2. 按一下 [設定]。
    3. 在「Google 助理」分頁中，按一下「居家控制系統」。
    4. 按一下「新增」(+)。
    5. 從供應商清單中選取所需動作。清單中會以「[測試]」為前置字元。從清單中選取 [測試] 動作時，應用程式應會開啟。
    6. 確認應用程式已啟動，並開始測試授權流程。