Home API menggunakan OAuth 2.0 untuk memberikan akses ke perangkat dalam struktur. OAuth memungkinkan pengguna memberikan izin ke aplikasi atau layanan tanpa harus mengekspos kredensial login mereka.
Jika sudah memiliki klien OAuth yang terverifikasi (misalnya, dari aplikasi yang sudah dipublikasikan), Anda dapat menggunakan klien tersebut untuk menguji Home API tanpa menyiapkan klien baru. Untuk mengetahui informasi selengkapnya, lihat Jika Anda memiliki klien OAuth yang sudah ada.
Menandatangani aplikasi
Pertama, buat sertifikat debug dengan menjalankan aplikasi Anda di Android Studio. Saat Anda menjalankan atau men-debug aplikasi di Android Studio, aplikasi tersebut akan otomatis membuat sertifikat debug yang ditujukan untuk pengembangan dan proses debug. Lihat Android Studio: Menandatangani build debug build untuk penjelasan lengkap.
Setelah aplikasi berjalan:
Hubungkan perangkat seluler Anda ke mesin lokal. Android Studio akan mencantumkan perangkat yang terhubung berdasarkan nomor model. Pilih perangkat Anda dari daftar, lalu klik Run project. Tindakan ini akan mem-build dan menginstal Aplikasi Contoh di perangkat seluler Anda.
Untuk mengetahui petunjuk yang lebih mendetail, lihat Menjalankan aplikasi di perangkat hardware di situs Android Developers.
Hentikan aplikasi yang sedang berjalan.
Dapatkan sidik jari SHA-1 sertifikat debug dengan mengikuti petunjuk yang dijelaskan dalam Menyiapkan OAuth 2.0 / Aplikasi native / Android di situs Bantuan Google Cloud Console.
Menyiapkan layar izin OAuth
- Di konsol Google Cloud, buka dasbor pemilih project dan pilih project yang ingin Anda gunakan untuk membuat kredensial OAuth.
- Buka halaman APIs and Services, lalu klik Credentials di menu navigasi.
Jika Anda belum mengonfigurasi layar izin untuk project Google Cloud ini, tombol Configure consent screen akan muncul. Dalam hal ini, konfigurasi layar izin Anda menggunakan prosedur berikut. Jika tidak, lanjutkan ke bagian berikutnya.
- Klik Configure consent screen. Halaman OAuth consent screen akan ditampilkan.
- Bergantung pada kasus penggunaan Anda, pilih Internal atau External, lalu klik Create. Panel OAuth consent screen akan ditampilkan.
- Masukkan informasi di App information page sesuai dengan petunjuk di layar, lalu klik Save and continue. Panel Scopes akan ditampilkan.
- Anda tidak perlu menambahkan cakupan apa pun, jadi klik Save and continue. Panel Test users akan ditampilkan.
- Klik Audience , lalu klik tombol + ADD USERS.
- Masukkan alamat email pengguna pengujian Anda, lalu klik tombol SAVE.
- Klik Save and continue. Panel Summary akan ditampilkan.
- Tinjau informasi layar izin OAuth Anda, lalu klik Back to dashboard.
Lihat Menyiapkan layar izin OAuth screen di situs Bantuan Google Cloud Console untuk mengetahui detail selengkapnya.
Mendaftarkan aplikasi dan membuat kredensial
Untuk mendaftarkan aplikasi untuk OAuth 2.0 dan membuat kredensial OAuth, ikuti petunjuk yang diberikan di Menyiapkan OAuth 2.0. Anda harus menunjukkan jenis aplikasi, yaitu native/Android app.
Tambahkan sidik jari SHA-1 yang Anda dapatkan dari penandatanganan aplikasi ke klien OAuth yang Anda siapkan di konsol Google Cloud dengan mengikuti petunjuk di Menyiapkan OAuth 2.0 / Aplikasi native di situs Bantuan Google Cloud Console.
Dengan perangkat seluler Anda terhubung ke mesin lokal, pilih perangkat Anda dari daftar, lalu klik Run project lagi untuk menjalankannya. Untuk mengetahui petunjuk yang lebih mendetail, lihat Menjalankan aplikasi di perangkat hardware di situs Android Developers.
Jika Anda memiliki klien OAuth yang sudah ada
Jika sudah memiliki klien OAuth yang terverifikasi untuk aplikasi yang dipublikasikan, Anda dapat menggunakan klien OAuth yang sudah ada untuk menguji Home API.
Pendaftaran Google Home Developer Console tidak diperlukan untuk menguji dan menggunakan Home API. Namun, Anda tetap memerlukan pendaftaran Developer Console yang disetujui untuk memublikasikan aplikasi, meskipun Anda memiliki klien OAuth yang terverifikasi dari integrasi lain.
Pertimbangan berikut berlaku:
Ada batas 100 pengguna saat menggunakan klien OAuth yang sudah ada. Untuk mengetahui informasi tentang cara menambahkan pengguna pengujian, lihat Siapkan layar izin OAuth screen. Terlepas dari verifikasi OAuth, ada batas 100 pengguna yang ditetapkan oleh Home API yang dapat memberikan izin ke aplikasi Anda. Batasan ini akan dihapus setelah pendaftaran Developer Console selesai.
Developer Console pendaftaran harus dikirim untuk disetujui saat Anda siap membatasi pemberian jenis perangkat melalui OAuth sebagai persiapan untuk memperbarui aplikasi Anda dengan Home API.
Untuk aplikasi Google Cloud yang masih menunggu verifikasi OAuth, pengguna tidak dapat menyelesaikan alur OAuth hingga verifikasi selesai. Upaya untuk memberikan izin akan gagal dengan error berikut:
Access blocked: <Project Name> has not completed the Google verification process.