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 của bạn.

Hướng dẫn thiết kế

Phần này mô tả các yêu cầu và đề xuất về thiết kế cho màn hình đồng ý liên kết tài khoản App Flip. Sau khi Google gọi ứng dụng của bạn, ứng dụng sẽ hiển thị màn hình yêu cầu sự đồng ý cho người dùng.

Yêu cầu

  1. Bạn phải thông báo rằng tài khoản của người dùng đang được liên kết với Google, không phải với một sản phẩm cụ thể của Google, chẳng hạn như Google Home hoặc Trợ lý Google.

Đề xuất

Bạn nên làm như sau:

  1. Hiển thị Chính sách quyền riêng tư của Google. Thêm đường liên kết đến Chính sách quyền riêng tư của Google trên màn hình yêu cầu đồng ý.

  2. Dữ liệu cần chia sẻ. Sử dụng ngôn từ rõ ràng và súc tích để cho người dùng biết dữ liệu mà Google yêu cầu và lý do.

  3. Lời kêu gọi hành động rõ ràng. Đưa ra lời kêu gọi hành động rõ ràng trên màn hình xin phép, chẳng hạn như “Đồng ý và liên kết”. Điều này là vì người dùng cần biết dữ liệu nào họ cần phải chia sẻ với Google để liên kết tài khoản của họ.

  4. Khả năng huỷ. Cung cấp cách để người dùng quay lại hoặc huỷ nếu họ chọn không liên kết.

  5. Có thể huỷ liên kết. Cung cấp cơ chế để người dùng huỷ liên kết, chẳng hạn như URL đến phần cài đặt tài khoản của họ trên nền tảng của bạn. Ngoài ra, bạn có thể đưa vào một đường liên kết đến Tài khoản Google để người dùng có thể quản lý tài khoản được liên kết của họ.

  6. Khả năng thay đổi tài khoản người dùng. Đề xuất một phương thức để người dùng chuyển đổi(các) tài khoản của họ. Điều này đặc biệt có lợi nếu người dùng có xu hướng sử dụng nhiều tài khoản.

    • Nếu người dùng phải đóng màn hình xin phép để chuyển đổi tài khoản, hãy gửi cho Google lỗi có thể khôi phục để người dùng có thể đăng nhập vào tài khoản mong muốn bằng tính năng liên kết OAuth và quy trình ngầm ẩn.
  7. Thêm biểu trưng của bạn. Hiển thị biểu trưng công ty của bạn trên màn hình xin phép. Sử dụng nguyên tắc về phong cách để đặt biểu trưng của bạn. Nếu bạn cũng muốn hiển thị biểu trưng của Google, hãy xem phần Biểu trưng và nhãn hiệu.

Hình này cho thấy một ví dụ về màn hình yêu cầu sự đồng ý, trong đó có chú thích về các yêu cầu và đề xuất riêng lẻ cần tuân thủ khi thiết kế màn hình yêu cầu sự đồng ý của người dùng.
Hình 2. Nguyên tắc thiết kế màn hình xin phép liên kết tài khoản.

Thiết lập cho tính năng Lật ứ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 Lật ứng dụng dựa trên OAuth và cách định cấu hình dự án App Flip trong bảng điều khiển Actions.

Tạo Hành động và thiết lập máy chủ OAuth 2.0

Trước khi có thể định cấu hình tính năng Lật ứng dụng, bạn cần làm những việc sau:

  • Tạo một Hành động. Để tạo một Hành động, hãy làm theo hướng dẫn trong phần Tạo dự án.
  • Thiết lập máy chủ OAuth 2.0. Để biết thêm thông tin về cách thiết lập máy chủ OAuth, hãy xem bài viết Triển khai liên kết tài khoản OAuth.

Định cấu hình tính năng Lật ứng dụng trong bảng điều khiển Actions

Phần sau đây mô tả cách định cấu hình tính năng Lật ứng dụng trong Bảng điều khiển Actions.

  1. Nhấp vào Phát triển trong thanh điều hướng trên cùng. Sau đó, hãy nhấp vào mục Liên kết tài khoản trong bảng điều hướng bên trái.
  2. Gạt nút chuyển bên cạnh mục Liên kết tài khoản sang vị trí bật.
  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 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 ứng dụng OAuth. (Nếu tính năng Lật ứng dụng không được hỗ trợ, thì OAuth thông thường sẽ được dù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 chọn Bật cho iOS.
  10. Điền vào trường Liên kết phổ quát. Để biết thêm thông tin về đường liên kết phổ quát, hãy xem phần Cho phép ứng dụng và trang web liên kết với nội dung của bạn .
  11. Nếu bạn muốn tuỳ ý định cấu hình ứng dụng, 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 của bạn (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 một tài khoản kiểm thử vào trường này nếu thực sự đang gửi Hành động của mình để xuất bản.)
  13. Nhấp vào Lưu.

Bây giờ, bạn có thể tiếp tục chuyển sang phần tiếp theo để triển khai tính năng Lật ứng dụng trong ứng dụng iOS hoặc Android.

Triển khai App Flip trong các ứng dụng gốc của bạn

Để triển khai tính năng Lật ứng dụng, bạn cần sửa đổi mã uỷ quyền cho người dùng trong ứng dụng để chấp nhận đường liên kết sâu từ Google.

Kiểm thử tính năng Lật ứng dụng trên thiết bị

Bây giờ, bạn đã tạo một Hành động và định cấu hình tính năng Lật ứng dụng trên bảng điều khiển và trong ứng dụng của mình, bạn có thể thử nghiệm tính năng Lật ứng dụng trên thiết bị di động. Bạn có thể dùng ứng dụng Trợ lý Google để thử nghiệm tính năng Lật ứng dụng.

Để kiểm thử tính năng Lật ứng dụng trên ứng dụng Trợ lý, hãy làm theo các bước sau:

  1. Chuyển đến Bảng điều khiển Actions rồi chọn dự án của bạn.
  2. Nhấp vào Test (Kiểm thử) ở thanh điều hướng trên cùng.
  3. Kích hoạt quy trình liên kết tài khoản trong ứ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 Hành động của bạn trong danh sách nhà cung cấp. Tên này sẽ có tiền tố là “[test]” trong danh sách. Khi bạn chọn Hành động [test] trong danh sách, thao tác này 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.