Balik Aplikasi

Setelah memiliki penerapan OAuth 2.0, Anda dapat secara opsional mengonfigurasi App Flip berbasis OAuth, yang memungkinkan pengguna Android menautkan akun mereka di sistem autentikasi Anda ke Akun Google mereka dengan lebih cepat. Bagian berikut menjelaskan cara mendesain dan menerapkan App Flip untuk integrasi Cloud-to-cloud 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.

Menyiapkan App Flip berbasis OAuth

Bagian berikut menjelaskan prasyarat untuk fitur Ganti Aplikasi berbasis OAuth dan cara mengonfigurasi project Ganti Aplikasi di Konsol Developer Google Home.

Membuat integrasi Cloud-to-cloud dan menyiapkan server OAuth 2.0

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

Mengonfigurasi fitur Ganti Aplikasi di Konsol Developer

Bagian berikut menjelaskan cara mengonfigurasi App Flip di Konsol Developer.

  1. Isi semua kolom di bagian Informasi Klien OAuth. (Jika App Flip tidak didukung, OAuth reguler akan digunakan sebagai pengganti.)
  2. Di bagian Gunakan aplikasi Anda untuk penautan akun(opsional), centang Aktifkan untuk iOS.
  3. Isi kolom Universal Link. Untuk mengetahui informasi selengkapnya tentang link universal, lihat Mengizinkan Aplikasi dan Situs Menautkan ke Konten Anda.
  4. Jika Anda 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 Anda

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

Menguji App Flip di perangkat Anda

Setelah membuat integrasi Cloud-to-cloud dan mengonfigurasi App Flip di konsol dan di aplikasi, Anda dapat menguji App Flip di perangkat seluler. Anda dapat menggunakan aplikasi Google Home untuk menguji fitur Peralihan Aplikasi.

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

  1. Buka Konsol Developer, lalu pilih project Anda.
  2. Buka Cloud-to-cloud > Test.
  3. Memicu 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 Integrasi cloud-ke-cloud Anda dari daftar penyedia. Aplikasi ini akan diawali dengan “[test]” dalam daftar. Saat Anda memilih integrasi [test] dari daftar, aplikasi Anda akan terbuka.
    6. Pastikan aplikasi Anda diluncurkan dan mulai uji alur otorisasi Anda.
Sebelumnya
Membuat integrasi Cloud-ke-cloud
Berikutnya
Identifikasi dan sinkronisasi