应用快速关联

拥有 OAuth 2.0 实现后,您可以选择配置基于 Auth 的 App Flip,以便让用户能够更快地将其在您的身份验证系统中的帐号关联到他们的 Google 帐号。下面几部分将介绍如何为 smart home Action 设计和实现 App Flip

设计准则

本部分介绍了 App Flip 帐号关联同意屏幕的设计要求和建议。在 Google 调用您的应用后,您的应用会向用户显示权限请求页面。

要求

  1. 您必须拥有 Google 授权声明,例如“关联后,Google 将有权控制您的设备”。
  2. 您必须表明用户的帐号会关联到 Google,而非特定 Google 产品,例如 Google Home 或 Google 助理。
  3. 您必须在同意屏幕上提供明确的号召性用语,并在关联操作中使用“同意并关联”措辞。这是因为用户需要了解需要与 Google 分享哪些数据才能关联帐号。
  4. 如果用户选择不关联,您必须为他们提供返回或取消的途径。为取消操作使用“取消”字样。
  5. 您必须实现以下工作流:点击“同意并关联”后,您必须显示已成功关联,并自动将用户重定向回 Google Home 应用。现在,用户应该会在 Google Home 应用上看到包含您的 Action 的已关联设备。点击“取消”后,您应将用户重定向回 Google Home 应用。

建议

建议您执行以下操作:

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

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

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

  4. 能够更改用户帐号。为用户提供切换帐号的方法。如果用户通常有多个帐号,此功能尤为有用。

    • 如果用户必须关闭同意屏幕才能切换帐号,请向 Google 发送可恢复的错误,以便用户使用 OAuth 关联隐式流程登录所需的帐号。
  5. 添加徽标。在同意屏幕上显示贵公司的徽标。 根据样式准则放置徽标。如果您还想显示 Google 的徽标,请参阅徽标和商标

此图显示了一个同意屏幕示例,其中列出了在设计用户同意屏幕时应遵循的各项要求和建议。
图 1:帐号关联同意屏幕设计准则。

为基于 OAuth 的App Flip进行设置

以下部分介绍了基于 OAuth 的 App Flip 的前提条件,以及如何在 Actions 控制台中配置 App Flip 项目。

创建智能家居 Action 并设置 OAuth 2.0 服务器

您需要先执行以下操作,然后才能配置 App Flip

在 Actions 控制台中配置 App Flip

以下部分介绍了如何在 Actions 控制台中配置 App Flip

  1. 填写 OAuth Client information 下的所有字段。 (如果 App Flip 不受支持,则会使用常规 OAuth 作为后备选项。)
  2. Use your app for account linking(optional) 下,选中 Enable for iOS
  3. 填写 Universal Link 字段。如需详细了解通用链接,请参阅允许应用和网站链接到您的内容
  4. 如果你想选择配置客户端,请添加范围,然后点击 Configure your client (optional) 下的 Add scope
  5. 点击保存

现在,您可以继续学习下一部分,在您的 iOS 或 Android 应用中实现 App Flip

在原生应用中实现 App Flip

若要实现 App Flip,您需要修改应用中的用户授权代码,以接受来自 Google 的深层链接。

在您的设备上测试 App Flip

现在,您已经在控制台和应用中创建了一个 Action 并配置了 App Flip,接下来可以在移动设备上测试 App Flip 了。您可以使用 Google Assistant appGoogle Home app (GHA) 来测试 App Flip

如需测试 Google Assistant app 中的 App Flip,请按以下步骤操作:

  1. 转到 Actions 控制台并选择你的项目。
  2. 点击顶部导航栏中的 Test
  3. Google Assistant 应用中触发帐号关联流程:
    1. 打开 Google Assistant app
    2. 点击设置
    3. Assistant 标签页上,点击家居控制
    4. 点击“添加”(+)
    5. 从提供商列表中选择你的 Action。它在列表中以“[test]”为前缀。从列表中选择 [test] Action 后,就应该会打开你的应用。
    6. 验证你的应用是否已启动并开始测试授权流程。

如需从 Google Home 应用测试 App Flip,请按以下步骤操作:

  1. 转到 Actions 控制台并选择你的项目。
  2. 点击顶部导航栏中的 Test
  3. Home 应用中触发帐号关联流程:
    1. 打开 Google Home app (GHA)
    2. 点击 + 按钮。
    3. 点击设置设备
    4. 点击有已设置好的设备?
    5. 从提供商列表中选择您的 smart home Action。它在列表中以“[test]”为前缀。从列表中选择 [test] Action 后,就应该会打开你的应用。
    6. 验证你的应用是否已启动并开始测试授权流程。