Lật ứng dụng

Sau khi triển khai OAuth 2.0, bạn có thể tuỳ ý định cấu hình App Flip dựa trên xác thực. Việc này cho phép người dùng liên kết tài khoản của họ trong hệ thống xác thực của bạn với Tài khoản Google của họ một cách nhanh chóng hơn. Các phần sau đây mô tả cách thiết kế và triển khai App Flip cho Hành động smart home.

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 have a Google authorization statement such as "Once linked, Google will have permission to control your devices."
  2. 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.
  3. You must state a clear call-to-action on your consent screen and use the wording "Agree and link" for linking action. This is because users need to understand what data they're required to share with Google to link their accounts.
  4. You must provide a way for users to go back or cancel, if they choose not to link. Use the wording "Cancel" for the cancel action.
  5. You must implement this workflow: After clicking "Agree and link", you must show linking success and redirect the user back to the Google Home app automatically. The user should now see the linked device on the Google Home app with your action. After clicking "Cancel" you should redirect the user back to the Google Home app.

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

  4. 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.

  5. 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 1: Account linking consent screen design guidelines.

Thiết lập cho App Flip dựa trên OAuth

Các phần sau đây mô tả các điều kiện tiên quyết đối với App Flip 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 (Hành động).

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

Trước khi có thể định cấu hình App Flip, bạn cần làm những việc sau:

Định cấu hình App Flip trong bảng điều khiển Actions

Phần sau đây mô tả cách định cấu hình App Flip trong bảng điều khiển Actions.

  1. Điền vào tất cả các trường trong phần Thông tin ứng dụng OAuth. (Nếu App Flip không được hỗ trợ, OAuth thông thường sẽ được dùng làm phương án dự phòng.)
  2. 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.
  3. Điền vào trường Đường liên kết phổ quát. Để biết thêm thông tin về các đườ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 đến nội dung của bạn.
  4. 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 phần Định cấu hình ứng dụng của bạn (không bắt buộc).
  5. Nhấp vào Lưu.

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

Triển khai App Flip trong các ứng dụng gốc

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

Kiểm tra App Flip trên thiết bị của bạn

Bây giờ, khi đã tạo được Hành động và định cấu hình App Flip trên bảng điều khiển, bạn có thể kiểm thử App Flip trên thiết bị di động trong ứng dụng của mình. Bạn có thể sử dụng Google Assistant app hoặc Google Home app (GHA) để kiểm thử App Flip.

Để kiểm thử App Flip từ Google Assistant app, 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ử) trong 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 Google Assistant:
    1. Mở Google Assistant app.
    2. Nhấp vào Cài đặt.
    3. Trên thẻ Assistant, 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 đó sẽ mở ứng dụng của bạn.
    6. Xác minh rằng ứng dụng của bạn đã được phát hành và bắt đầu kiểm thử quy trình uỷ quyền.

Để kiểm thử App Flip qua ứng dụng Google Home, 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ử) trong 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 Home:
    1. Mở Google Home app (GHA).
    2. Nhấp vào nút +.
    3. Nhấp vào Thiết lập thiết bị.
    4. Nhấp vào Bạn đã thiết lập thiết bị?
    5. Chọn Hành động smart home của bạn từ 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 đó sẽ mở ứng dụng của bạn.
    6. Xác minh rằng ứng dụng của bạn đã được phát hành và bắt đầu kiểm thử quy trình uỷ quyền.
Trước
Tạo dự án Hành động
Tiếp
Xác định và đồng bộ hoá