Ringkasan

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.

This figure shows the steps for a user to link their Google account to your authentication system. The first screenshot shows how a user can select your app if their Google account is linked to your app. The second screenshot shows the confirmation for linking their Google account with your app. The third screenshot shows a successfully linked user account in the Google app.
Figure 1. Account linking on a user's phone with App Flip.

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.

Untuk mengetahui informasi selengkapnya tentang alur kode otorisasi penautan OAuth, lihat Menerapkan server OAuth Anda.

Panduan desain

Bagian ini menjelaskan persyaratan dan rekomendasi desain untuk layar izin penautan akun App Flip. Setelah Google memanggil aplikasi Anda, aplikasi Anda akan menampilkan layar izin kepada pengguna.

Persyaratan

  1. Anda harus menginformasikan bahwa akun pengguna ditautkan ke Google, bukan ke produk Google tertentu, seperti Google Home atau Asisten Google.

Rekomendasi

Sebaiknya Anda melakukan hal berikut:

  1. Menampilkan Kebijakan Privasi Google. Sertakan link ke Kebijakan Privasi Google di layar izin.

  2. Data yang akan dibagikan. Gunakan bahasa yang jelas dan ringkas untuk memberi tahu pengguna data apa yang diperlukan Google dan alasannya.

  3. Pesan ajakan (CTA) yang jelas. Nyatakan pesan ajakan yang jelas di layar izin Anda, seperti “Setuju dan tautkan”. Hal ini karena pengguna perlu memahami data apa yang harus mereka bagikan kepada Google untuk menautkan akun mereka.

  4. Kemampuan untuk menolak atau membatalkan. Berikan cara bagi pengguna untuk kembali, menolak, atau membatalkan, jika mereka memilih untuk tidak menautkan.

  5. Kemampuan untuk membatalkan tautan. Menawarkan mekanisme bagi pengguna untuk membatalkan tautan, seperti URL ke setelan akun mereka di platform Anda. Atau, Anda dapat menyertakan link ke Akun Google tempat pengguna dapat mengelola akun tertaut mereka.

  6. Kemampuan untuk mengubah akun pengguna. Sarankan metode bagi pengguna untuk beralih akun. Hal ini sangat bermanfaat jika pengguna cenderung memiliki beberapa akun.

    • Jika pengguna harus menutup layar izin untuk beralih akun, kirimkan error yang dapat dipulihkan ke Google agar pengguna dapat login ke akun yang diinginkan dengan penautan OAuth dan alur implisit.

  7. Sertakan logo Anda. Menampilkan logo perusahaan Anda di layar izin. Gunakan panduan gaya Anda untuk menempatkan logo. Jika Anda ingin menampilkan logo Google juga, lihat Logo dan merek dagang.

Gambar ini menunjukkan contoh layar izin dengan penjelasan tentang persyaratan dan rekomendasi individual yang harus diikuti saat Anda mendesain layar izin pengguna.
Gambar 2. Panduan desain layar izin penautan akun.

Penyiapan untuk Pengalihan Aplikasi berbasis OAuth

Bagian berikut menjelaskan prasyarat untuk Pengalihan Aplikasi berbasis OAuth dan cara mengonfigurasi project Pengalihan Aplikasi di konsol Actions.

Buat Tindakan dan siapkan server OAuth 2.0

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

  • Membuat Tindakan. Untuk membuat Tindakan, ikuti petunjuk di bagian Membuat project.
  • Siapkan server OAuth 2.0. Untuk mengetahui informasi selengkapnya tentang cara menyiapkan server OAuth, lihat Menerapkan penautan akun OAuth.

Mengonfigurasi fitur Ganti Aplikasi di Konsol Actions

Bagian berikut menjelaskan cara mengonfigurasi App Flip di konsol Actions.

  1. Klik Develop di navigasi atas. Kemudian, klik Penautan akun di navigasi sebelah kiri.
  2. Aktifkan tombol di samping Penautan akun.
  3. Di bagian Pembuatan akun, pilih Tidak, saya hanya ingin mengizinkan pembuatan akun di situs saya.
  4. Klik Berikutnya.
  5. Di bagian Jenis penautan, pilih OAuth dan Kode otorisasi dari menu drop-down.
  6. Klik Berikutnya.
  7. Isi semua kolom di bagian Informasi Klien OAuth. (Jika App Flip tidak didukung, OAuth reguler akan digunakan sebagai pengganti.)
  8. Klik Berikutnya.
  9. Di bagian Gunakan aplikasi Anda untuk penautan akun (opsional), centang Aktifkan untuk iOS.
  10. Isi kolom Universal Link. Untuk informasi selengkapnya tentang link universal, lihat Mengizinkan Aplikasi dan Situs untuk Menautkan ke Konten Anda .
  11. Jika Anda ingin mengonfigurasi klien secara opsional, tambahkan cakupan, lalu klik Tambahkan cakupan di bagian Konfigurasi klien Anda (opsional). Jika tidak, klik Berikutnya.
  12. Di bagian Petunjuk pengujian, ketik test (atau string lainnya) sebagai placeholder. (Mengisi kolom ini dengan akun pengujian hanya diperlukan jika Anda benar-benar mengirimkan Tindakan untuk dipublikasikan.)
  13. Klik Simpan.

Sekarang Anda dapat melanjutkan ke bagian berikutnya untuk menerapkan fitur Peralihan Aplikasi di aplikasi iOS atau Android Anda.

Menerapkan App Flip di aplikasi native Anda

Untuk menerapkan Pengalihan Aplikasi, Anda perlu mengubah kode otorisasi pengguna di aplikasi Anda agar menerima deep link dari Google.

Menguji Peralihan Aplikasi di perangkat Anda

Setelah membuat Action dan mengonfigurasi fitur Ganti Aplikasi di konsol dan di aplikasi, Anda dapat menguji fitur Ganti Aplikasi di perangkat seluler. Anda dapat menggunakan aplikasi Asisten Google untuk menguji Pengalihan Aplikasi.

Untuk menguji fitur Ganti Aplikasi dari aplikasi Asisten, ikuti langkah-langkah berikut:

  1. Buka konsol Actions dan pilih project Anda.
  2. Klik Test di navigasi atas.
  3. Memicu alur penautan akun dari aplikasi Asisten:
    1. Buka aplikasi Asisten Google.
    2. Klik Setelan.
    3. Di tab Asisten, klik Kontrol Rumah.
    4. Klik Tambahkan(+).
    5. Pilih Action Anda dari daftar penyedia. Aplikasi ini akan diberi awalan “[test]” dalam daftar. Saat Anda memilih Action [pengujian] dari daftar, Action tersebut akan membuka aplikasi Anda.
    6. Pastikan aplikasi Anda diluncurkan dan mulai uji alur otorisasi Anda.