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.

Panduan desain

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

Persyaratan

  1. Anda harus memiliki pernyataan otorisasi Google, seperti "Setelah ditautkan, Google akan memiliki izin untuk mengontrol perangkat Anda".
  2. Anda harus memberitahukan bahwa akun pengguna ditautkan ke Google, bukan ke produk Google tertentu, seperti Google Home atau Asisten Google.
  3. Anda harus menyatakan pesan ajakan (CTA) yang jelas di layar izin dan menggunakan kata-kata "Setuju dan tautkan" untuk tindakan penautan. Hal ini karena pengguna perlu memahami data apa yang perlu mereka bagikan kepada Google untuk menautkan akun mereka.
  4. Anda harus menyediakan cara bagi pengguna untuk kembali atau membatalkan, jika mereka memilih untuk tidak menautkan. Gunakan kata "Cancel" untuk tindakan pembatalan.
  5. Anda harus menerapkan alur kerja ini: Setelah mengklik "Setuju dan tautkan", Anda harus menunjukkan keberhasilan penautan dan mengalihkan pengguna kembali ke aplikasi Google Home secara otomatis. Sekarang pengguna akan melihat perangkat tertaut di aplikasi Google Home dengan tindakan Anda. Setelah mengklik "Cancel", Anda harus mengalihkan pengguna kembali ke aplikasi Google Home.

Rekomendasi

Sebaiknya Anda melakukan hal berikut:

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

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

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

  4. 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, kirim error yang dapat dipulihkan ke Google agar pengguna dapat login ke akun yang diinginkan menggunakan penautan OAuth dan alur implisit.
  5. Sertakan logo Anda. Tampilkan logo perusahaan Anda di layar izin. Gunakan panduan gaya untuk menempatkan logo Anda. Jika Anda juga ingin menampilkan logo Google, lihat Logo dan merek dagang.

Gambar ini menampilkan contoh layar izin dengan pesan untuk setiap persyaratan dan rekomendasi yang harus diikuti saat Anda mendesain layar izin pengguna.
Gambar 1: Panduan desain layar izin penautan akun.

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.