获得 OAuth 2.0 实现后,您可以根据需要配置 基于身份验证的App Flip,可让用户更快地 将您在身份验证系统中的账号与其 Google 账号相关联。通过 以下各部分介绍了如何设计和实现 针对你的 smart home 操作App Flip。
设计准则
本部分介绍了 App Flip 帐号关联同意屏幕的设计要求和建议。在 Google 调用您的应用后,您的应用会向用户显示权限请求页面。
要求
- 您必须拥有 Google 授权声明,例如“关联后,Google 将有权控制您的设备”。
- 您必须表明用户的帐号会关联到 Google,而非特定 Google 产品,例如 Google Home 或 Google 助理。
- 您必须在同意屏幕上提供明确的号召性用语,并在关联操作中使用“同意并关联”措辞。这是因为用户需要了解需要与 Google 分享哪些数据才能关联帐号。
- 如果用户选择不关联,您必须为他们提供返回或取消的途径。为取消操作使用“取消”字样。
- 您必须实现以下工作流:点击“同意并关联”后,您必须显示已成功关联,并自动将用户重定向回 Google Home 应用。现在,用户应该会在 Google Home 应用上看到包含您的 Action 的已关联设备。点击“取消”后,您应将用户重定向回 Google Home 应用。
建议
建议您执行以下操作:
显示 Google 的隐私权政策。在同意屏幕上添加指向 Google 隐私权政策的链接。
要分享的数据。使用简明扼要的语言告知用户 Google 需要他们的哪些数据以及原因。
能够解除关联。提供一种供用户解除关联的机制,例如指向其在您平台上帐号设置的网址。或者,您也可以添加指向 Google 帐号的链接,以便用户管理其关联的帐号。
能够更改用户帐号。为用户提供切换帐号的方法。如果用户通常有多个帐号,此功能尤为有用。
- 如果用户必须关闭同意屏幕才能切换帐号,请向 Google 发送可恢复的错误,以便用户使用 OAuth 关联和隐式流程登录所需的帐号。
添加徽标。在同意屏幕上显示贵公司的徽标。 根据样式准则放置徽标。如果您还想显示 Google 的徽标,请参阅徽标和商标。
![此图显示了一个同意屏幕示例,其中列出了在设计用户同意屏幕时应遵循的各项要求和建议。](https://developers.home.google.com/static/identity/images/app-flip-guidance.png?hl=zh-cn)
针对基于 OAuth 的 App Flip 进行设置
以下各部分将介绍基于 OAuth App Flip的前提条件,以及如何配置 Actions 控制台中的 App Flip 项目。
创建智能家居 Action 并设置 OAuth 2.0 服务器
您需要先执行以下操作,然后才能配置 App Flip:
- 设置 OAuth 2.0 服务器。详细了解如何设置 OAuth 请参阅实现 OAuth 2.0 服务器。
- 创建 Action。如需创建 Action,请按照 创建 Actions 项目。
在 Actions 控制台中配置 App Flip
以下部分介绍了如何在App Flip Actions 控制台。
- 填写 OAuth Client information 下的所有字段。 (如果 App Flip 不受支持,则使用常规 OAuth 作为后备选项。)
- 在 Use your app for account linking(optional) 下,选中 Enable for iOS。
- 填写 Universal Link 字段。更多信息 通用链接,请参阅 允许应用和网站链接到您的内容。
- 如果你想选择配置客户端,请添加范围,然后点击 Configure your client (optional) 下的 Add scope。
- 点击保存。
现在,您可以继续前往下一部分,在 iOS 中实现 App Flip,或 Android应用。
在原生应用中实现 App Flip
要实现 App Flip,您需要修改 应用接受来自 Google 的深层链接。
在您的设备上测试 App Flip
现在,您已经在控制台和App Flip 则可以在移动设备上测试 App Flip。您可以使用 Google Assistant app 或 Google Home app (GHA),用于测试 App Flip。
如需测试 Google Assistant app 中的 App Flip,请按以下步骤操作:
- 转到 Actions 控制台并选择你的项目。
- 点击顶部导航栏中的 Test。
- 在 Google Assistant 应用中触发账号关联流程:
- 打开 Google Assistant app。
- 点击设置。
- 在 Assistant 标签页上,点击家居控制。
- 点击“添加”(+)。
- 从提供商列表中选择你的 Action。它在列表中以“[test]”为前缀。从列表中选择 [test] Action 后,就应该会打开你的应用。
- 验证你的应用是否已启动并开始测试授权流程。
如需在 Google Home 应用中测试 App Flip,请按以下步骤操作:
- 转到 Actions 控制台并选择你的项目。
- 点击顶部导航栏中的 Test。
- 在 Home 应用中触发账号关联流程:
- 打开 Google Home app (GHA)。
- 点击 + 按钮。
- 点击设置设备。
- 点击有已设置好的设备?
- 从提供商列表中选择你的 smart home 操作。它在列表中以“[test]”为前缀。从列表中选择 [test] Action 后,就应该会打开你的应用。
- 验证你的应用是否已启动并开始测试授权流程。