Tổng quan

Tính năng Liên kết App Flip (App Flip) dựa trên OAuth cho phép người dùng dễ dàng và nhanh chóng liên kết tài khoản của họ trong hệ thống xác thực với Tài khoản Google. Nếu ứng dụng của bạn được cài đặt trên điện thoại của người dùng khi họ bắt đầu quy trình liên kết tài khoản, thì họ sẽ được chuyển liền mạch đến ứng dụng của bạn để lấy quyền uỷ quyền của người dùng.

Phương pháp này cung cấp quá trình liên kết nhanh hơn và dễ dàng hơn vì người dùng không phải nhập lại tên người dùng và mật khẩu để xác thực; thay vào đó, App Flip sẽ tận dụng thông tin xác thực từ tài khoản của người dùng trên ứng dụng của bạn. Sau khi người dùng liên kết Tài khoản Google của họ với ứng dụng của bạn, họ có thể tận dụng mọi công cụ tích hợp mà bạn đã phát triển.

Bạn có thể thiết lập tính năng Lật ứng dụng cho cả ứng dụng iOS và Android.

Hình này minh hoạ các bước để người dùng liên kết Tài khoản Google của họ với hệ thống xác thực của bạn. Ảnh chụp màn hình đầu tiên cho thấy cách người dùng có thể chọn ứng dụng của bạn nếu Tài khoản Google của họ được liên kết với ứng dụng của bạn. Ảnh chụp màn hình thứ hai cho thấy thông báo xác nhận liên kết Tài khoản Google của họ với ứng dụng của bạn. Ảnh chụp màn hình thứ ba cho thấy một tài khoản người dùng đã liên kết thành công trong ứng dụng Google.
Hình 1. Liên kết tài khoản trên điện thoại của người dùng bằng tính năng Lật ứng dụng.

Yêu cầu

Để triển khai tính năng Lật ứng dụng, bạn phải đáp ứng các yêu cầu sau:

  • Bạn phải có ứng dụng Android hoặc iOS.
  • Bạn phải sở hữu, quản lý và duy trì một máy chủ OAuth 2.0 hỗ trợ luồng mã uỷ quyền OAuth 2.0.

Để 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.

Design guidelines

This section describes the design requirements and recommendations for the App Flip account linking consent screen. After Google calls your app, your app displays the consent screen to the user.

Requirements

  1. You must communicate that the user’s account is being linked to Google, not to a specific Google product, such as Google Home or Google Assistant.

Recommendations

We recommend that you do the following:

  1. Display Google's Privacy Policy. Include a link to Google’s Privacy Policy on the consent screen.

  2. Data to be shared. Use clear and concise language to tell the user what data of theirs Google requires and why.

  3. Clear call-to-action. State a clear call-to-action on your consent screen, such as “Agree and link.” This is because users need to understand what data they're required to share with Google to link their accounts.

  4. Ability to deny or cancel. Provide a way for users to go back, deny, or cancel, if they choose not to link.

  5. Ability to unlink. Offer a mechanism for users to unlink, such as a URL to their account settings on your platform. Alternatively, you can include a link to Google Account where users can manage their linked account.

  6. Ability to change user account. Suggest a method for users to switch their account(s). This is especially beneficial if users tend to have multiple accounts.

    • If a user must close the consent screen to switch accounts, send a recoverable error to Google so the user can sign in to the desired account with OAuth linking and the implicit flow.
  7. Include your logo. Display your company logo on the consent screen. Use your style guidelines to place your logo. If you wish to also display Google's logo, see Logos and trademarks.

This figure shows an example consent screen with call-outs to the
            individual requirements and recommendations to be followed when
            you design a user consent screen.
Figure 2. Account linking consent screen design guidelines.

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:

Đị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.

  1. 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.
  2. Bật nút chuyển bên cạnh mục Liên kết tài khoản.
  3. 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.
  4. Nhấp vào Tiếp theo.
  5. Trong phần Loại liên kết, hãy chọn OAuthMã uỷ quyền trong trình đơn thả xuống.
  6. Nhấp vào Tiếp theo.
  7. Đ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.)
  8. Nhấp vào Tiếp theo.
  9. 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.
  10. Đ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 .
  11. 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.
  12. 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.)
  13. 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:

  1. Truy cập vào Actions Console rồi chọn dự án của bạn.
  2. Nhấp vào Kiểm thử trong trình đơn điều hướng trên cùng.
  3. Kích hoạt quy trình liên kết tài khoản từ ứng dụng Trợ lý:
    1. Mở ứng dụng Trợ lý Google.
    2. Nhấp vào Cài đặt.
    3. Trên thẻ Trợ lý, hãy nhấp vào Điều khiển nhà.
    4. Nhấp vào Thêm(+).
    5. 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.
    6. 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.