OAuth-based App Flip Linking (App Flip) allows your users to easily and quickly link their accounts in your authentication system to their Google accounts. If your app is installed on your user’s phone when they initiate the account linking process, they are seamlessly flipped to your app to obtain user authorization.
This approach provides a faster and easier linking process since the user does not have to re-enter their username and password to authenticate; instead, App Flip leverages the credentials from the user's account on your app. Once a user has linked their Google account with your app, they can take advantage of any integrations that you have developed.
You can set up App Flip for both iOS and Android apps.
Requirements
To implement App Flip, you must fulfill the following requirements:
- You must have an Android or iOS app.
- You must own, manage and maintain an OAuth 2.0 server which supports the OAuth 2.0 authorization code flow.
Để 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
- 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:
Display Google's Privacy Policy. Include a link to Google’s Privacy Policy on the consent screen.
Data to be shared. Use clear and concise language to tell the user what data of theirs Google requires and why.
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.
Ability to cancel. Provide a way for users to go back or cancel, if they choose not to link.
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.
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.
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.
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.