Balik Aplikasi

Setelah memiliki implementasi OAuth 2.0, Anda dapat mengonfigurasi App Flip berbasis Auth, yang memungkinkan pengguna Anda dengan lebih cepat menautkan akun mereka di sistem otentikasi Anda ke Akun Google mereka. Tujuan bagian berikut menjelaskan cara merancang dan menerapkan 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.

Siapkan untuk App Flip berbasis OAuth

Bagian berikut menjelaskan prasyarat untuk App Flip berbasis OAuth dan cara mengonfigurasi App Flip di Konsol Actions.

Membuat Action smart home dan menyiapkan server OAuth 2.0

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

• Siapkan server OAuth 2.0. Untuk informasi selengkapnya tentang cara menyiapkan OAuth server, lihat Menerapkan server OAuth 2.0.
• Buat Action. Untuk membuat Tindakan, ikuti petunjuk di Membuat project Actions.

Mengonfigurasi App Flip di Konsol Actions

Bagian berikut menjelaskan cara mengonfigurasi App Flip di Konsol Actions.

1. Isi semua kolom pada 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 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 perangkat iOS atau Android aplikasi.

Menerapkan App Flip di aplikasi native

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

Uji App Flip di perangkat Anda

Setelah Anda membuat Action dan mengonfigurasi App Flip di konsol dan aplikasi Anda, 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 Uji di navigasi atas.
3. Picu alur penautan akun dari aplikasi Google Assistant:
1. Buka Google Assistant app
2. Klik Setelan.
3. Di tab Assistant, klik Kontrol Rumah.
4. Klik Add(+).
5. Pilih Action Anda dari daftar penyedia. Ini akan menjadi diawali dengan “[test]” dalam daftar. Jika Anda memilih Tindakan [test] dari daftar, aplikasi akan terbuka.
6. Verifikasi bahwa aplikasi Anda telah 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 Uji 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. Ini akan menjadi diawali dengan “[test]” dalam daftar. Jika Anda memilih Tindakan [test] dari daftar, aplikasi akan terbuka.
6. Verifikasi bahwa aplikasi Anda telah diluncurkan dan mulailah menguji alur otorisasi Anda.