基于 OAuth 的应用快速关联 (App Flip) 关联功能可让用户快速将其在您的身份验证系统中的账号关联到其 Google 账号。 如果用户在发起账户关联过程时手机上已安装您的应用，系统会顺畅地将他们转到您的应用以获取用户授权。
这种方法可提供更快的账户关联过程，因为用户无需重新输入用户名和密码进行身份验证；相反，App Flip 会利用用户在您的应用中的账号凭据。用户将其 Google 账号与您的应用关联后，便可利用您开发的任何集成。
您可以为 iOS 和 Android 应用设置 App Flip。
要求
如需实现 App Flip，您必须满足以下要求：
- 您必须拥有 Android 或 iOS 应用。
- 您必须拥有、管理和维护支持 OAuth 2.0 授权代码流程的 OAuth 2.0 服务器。
基于 OAuth 的 App Flip 流程
以下序列图详细说明了用户、Google 应用、您的应用和您的授权服务器之间针对 App Flip 的交互。
角色和职责
下表定义了 App Flip 流程中执行者的角色和职责。
| 执行者 / 组件 | GAL 角色 | 职责 |
|---|---|---|
| Google 应用 / 服务器 | OAuth 客户端 | 发起账户关联过程，触发到您的移动应用深层链接，将授权代码交换为令牌，并安全地存储这些令牌以访问您服务的 API。 |
| 您的应用 | 授权代理 | 对用户进行身份验证（通常使用现有应用凭据）， 获取意见征求，并从您的服务器检索授权代码。 |
| 您的授权服务器 | 授权服务器 | 验证授权代码和刷新令牌，并向 Google 服务器颁发访问 令牌。 |
Để biết thêm thông tin về quy trình mã uỷ quyền liên kết OAuth, hãy xem phần Triển khai máy chủ OAuth.
设计准则
本部分介绍了应用翻转账号关联同意屏幕的设计要求和建议。在 Google 调用您的应用后，您的应用会向用户显示同意屏幕。
要求
- 您必须告知用户，其账号将与 Google 关联，而非与 Google Home 或 Google 助理等特定 Google 产品关联。
建议
建议您执行以下操作：
显示 Google 的隐私权政策。在意见征求屏幕上添加指向 Google 隐私权政策的链接。
要分享的数据。使用简洁明了的语言告知用户 Google 需要哪些用户数据以及原因。
明确的号召性用语。在同意屏幕上提供清晰的号召性用语，例如“同意并关联”。这是因为用户需要了解他们必须与 Google 分享哪些数据才能关联其账号。
能够拒绝或取消。如果用户选择不关联，请提供一种供用户返回、拒绝或取消的方式。
能够解除关联。提供一种可供用户取消关联的机制，例如指向您平台上的账号设置的网址。或者，您也可以添加指向 Google 账号的链接，以便用户管理其关联的账号。
能够更改用户账号。建议用户切换账号的方法。如果用户倾向于使用多个账号，此功能尤其有用。
- 如果用户必须关闭同意屏幕才能切换账号，请向 Google 发送可恢复的错误，以便用户可以通过 OAuth 关联和隐式流程登录所需账号。
添加您的徽标。在权限请求页面上显示公司徽标。 根据样式指南放置徽标。如果您还想显示 Google 的徽标，请参阅徽标和商标。
Thiết lập tính năng Chuyển đổi ứng dụng dựa trên OAuth
Các phần sau đây mô tả các điều kiện tiên quyết cho tính năng Chuyển đổi ứng dụng dựa trên OAuth và cách định cấu hình dự án Chuyển đổi ứng dụng trong Actions Console.
Tạo một Thao tác và thiết lập một máy chủ OAuth 2.0
Trước khi có thể định cấu hình tính năng Chuyển đổi ứng dụng, bạn cần làm như sau:
- Tạo một Thao tác. Để tạo một Thao tác, hãy làm theo hướng dẫn trong phần Tạo dự án.
- Thiết lập một máy chủ OAuth 2.0. Để biết thêm thông tin về cách thiết lập một máy chủ OAuth, hãy xem phần Triển khai tính năng liên kết tài khoản bằng OAuth.
Định cấu hình tính năng Chuyển đổi ứng dụng trong Actions Console
Phần sau đây mô tả cách định cấu hình tính năng Chuyển đổi ứng dụng trong bảng điều khiển Actions.
- Nhấp vào Phát triển trong trình đơn điều hướng trên cùng. Sau đó, hãy nhấp vào Liên kết tài khoản trong trình đơn điều hướng bên trái.
- Bật nút chuyển bên cạnh mục Liên kết tài khoản.
- Trong mục Tạo tài khoản, hãy chọn Không, tôi chỉ muốn cho phép tạo tài khoản trên trang web của mình.
- Nhấp vào Tiếp theo.
- Trong phần Loại liên kết, hãy chọn OAuth và Mã uỷ quyền trong trình đơn thả xuống.
- Nhấp vào Tiếp theo.
- Điền vào tất cả các trường trong phần Thông tin về ứng dụng OAuth. (Nếu không hỗ trợ App Flip, hệ thống sẽ dùng OAuth thông thường làm phương án dự phòng.)
- Nhấp vào Tiếp theo.
- Trong mục Sử dụng ứng dụng của bạn để liên kết tài khoản (không bắt buộc), hãy đánh dấu vào Bật cho iOS.
- Điền vào trường Đường liên kết phổ quát. Để biết thêm thông tin về liên kết phổ biến, hãy xem bài viết Cho phép ứng dụng và trang web liên kết đến nội dung của bạn .
- Nếu muốn định cấu hình ứng dụng khách, hãy thêm phạm vi rồi nhấp vào Thêm phạm vi trong mục Định cấu hình ứng dụng khách (không bắt buộc). Nếu không, hãy nhấp vào Tiếp theo.
- Trong phần Hướng dẫn kiểm thử, hãy nhập
test(hoặc bất kỳ chuỗi nào khác) làm phần giữ chỗ. (Bạn chỉ cần điền vào trường này bằng tài khoản kiểm thử nếu thực sự đang gửi Thao tác để xuất bản.) - Nhấp vào Lưu.
Bây giờ, bạn có thể chuyển sang phần tiếp theo để triển khai tính năng Chuyển đổi ứng dụng trong ứng dụng iOS hoặc Android của mình.
Triển khai tính năng Chuyển đổi ứng dụng trong các ứng dụng gốc
Để triển khai tính năng Chuyển đổi ứng dụng, bạn cần sửa đổi mã uỷ quyền người dùng trong ứng dụng để chấp nhận một đường liên kết sâu từ Google.
Kiểm thử tính năng Chuyển đổi ứng dụng trên thiết bị
Giờ đây, sau khi tạo một Thao tác và định cấu hình tính năng App Flip trên bảng điều khiển và trong ứng dụng, bạn có thể kiểm thử tính năng App Flip trên thiết bị di động. Bạn có thể dùng ứng dụng Trợ lý Google để kiểm thử tính năng Chuyển đổi ứng dụng.
Để kiểm thử tính năng Lật ứng dụng trong ứng dụng Trợ lý, hãy làm theo các bước sau:
- Truy cập vào Actions Console rồi chọn dự án của bạn.
- Nhấp vào Kiểm thử trong trình đơn điều hướng trên cùng.
- Kích hoạt quy trình liên kết tài khoản từ ứng dụng Trợ lý:
- Mở ứng dụng Trợ lý Google.
- Nhấp vào Cài đặt.
- Trên thẻ Trợ lý, hãy nhấp vào Điều khiển nhà.
- Nhấp vào Thêm(+).
- Chọn Thao tác của bạn trong danh sách nhà cung cấp. Tên này sẽ có tiền tố "[test]" trong danh sách. Khi bạn chọn Hành động [kiểm thử] trong danh sách, Hành động đó sẽ mở ứng dụng của bạn.
- Xác minh rằng ứng dụng của bạn đã được khởi chạy và bắt đầu kiểm thử quy trình uỷ quyền.