Balik Aplikasi

Setelah memiliki implementasi OAuth 2.0, secara opsional Anda dapat mengonfigurasi App Flip berbasis Auth, sehingga pengguna dapat menautkan akun mereka di sistem autentikasi ke Akun Google mereka dengan lebih cepat. Bagian berikut menjelaskan cara mendesain dan mengimplementasikan App Flip untuk Action smart home Anda.

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.

Penyiapan untuk App Flip berbasis OAuth

Bagian berikut menjelaskan prasyarat untuk App Flip berbasis OAuth dan cara mengonfigurasi project App Flip Anda di konsol Actions.

Membuat Action smart home dan menyiapkan server OAuth 2.0

Sebelum dapat mengonfigurasi App Flip, Anda perlu melakukan hal berikut:

Mengonfigurasi App Flip di konsol Actions

Bagian berikut menjelaskan cara mengonfigurasi App Flip di konsol Actions.

  1. Isi semua kolom di bagian Informasi klien OAuth. (Jika App Flip tidak didukung, OAuth reguler akan digunakan sebagai penggantian.)
  2. Di bagian Gunakan aplikasi Anda untuk penautan akun(opsional), centang Aktifkan untuk iOS.
  3. Isi kolom Link Universal. Untuk informasi selengkapnya tentang link universal, lihat Mengizinkan Aplikasi dan Situs untuk Menautkan ke Konten Anda.
  4. Jika ingin mengonfigurasi klien secara opsional, tambahkan cakupan, lalu klik Tambahkan cakupan di bagian Konfigurasi klien Anda (opsional).
  5. Klik Simpan.

Sekarang Anda dapat melanjutkan ke bagian berikutnya untuk menerapkan App Flip di aplikasi iOS atau Android.

Menerapkan App Flip di aplikasi native

Untuk menerapkan App Flip, Anda harus mengubah kode otorisasi pengguna di aplikasi untuk menerima deep link dari Google.

Menguji App Flip di perangkat Anda

Setelah membuat Action dan mengonfigurasi App Flip di konsol dan aplikasi, Anda dapat menguji App Flip di perangkat seluler. Anda dapat menggunakan Google Assistant app atau Google Home app (GHA) untuk menguji App Flip.

Untuk menguji App Flip dari Google Assistant app, ikuti langkah-langkah berikut:

  1. Buka konsol Actions dan pilih project Anda.
  2. Klik Test di navigasi atas.
  3. Picu alur penautan akun dari aplikasi Google Assistant:
    1. Buka Google Assistant app.
    2. Klik Setelan.
    3. Pada tab Assistant, klik Kontrol Rumah.
    4. Klik Add(+).
    5. Pilih Action Anda dari daftar penyedia. Nama ini akan diawali dengan "[test]" dalam daftar. Saat Anda memilih Action [test] dari daftar, Action tersebut akan membuka aplikasi Anda.
    6. Verifikasi bahwa aplikasi Anda diluncurkan dan mulailah menguji alur otorisasi Anda.

Untuk menguji App Flip dari aplikasi Google Home, ikuti langkah-langkah berikut:

  1. Buka konsol Actions dan pilih project Anda.
  2. Klik Test di navigasi atas.
  3. Picu alur penautan akun dari aplikasi Home:
    1. Buka Google Home app (GHA).
    2. Klik tombol +.
    3. Klik Siapkan perangkat.
    4. Klik Sudah menyiapkan sesuatu?
    5. Pilih Action smart home Anda dari daftar penyedia. Nama ini akan diawali dengan "[test]" dalam daftar. Saat Anda memilih Action [test] dari daftar, Action tersebut akan membuka aplikasi Anda.
    6. Verifikasi bahwa aplikasi Anda diluncurkan dan mulailah menguji alur otorisasi Anda.
Sebelumnya
Membuat project Action
Berikutnya
Identifikasi dan sinkronisasi