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 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 sudah memiliki klien OAuth.
Menandatangani aplikasi
Pertama, buat kunci OAuth dengan menjalankan aplikasi di Android Studio. Saat Anda menjalankan atau men-debug aplikasi di Android Studio, aplikasi tersebut akan otomatis menghasilkan kunci OAuth yang ditujukan untuk pengembangan dan proses debug. Lihat Android Studio: Menandatangani build debug untuk mengetahui penjelasan lengkapnya.
Setelah aplikasi berjalan:
Hubungkan perangkat seluler ke komputer lokal. Android Studio akan mencantumkan perangkat yang terhubung menurut 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 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 OAuth dengan mengikuti petunjuk yang dijelaskan dalam Menyiapkan OAuth 2.0 / Aplikasi native/Android di situs Bantuan Konsol Google Cloud.
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 Konfigurasi layar izin akan muncul. Dalam hal ini, konfigurasi layar izin Anda menggunakan prosedur berikut. Jika tidak, lanjutkan ke bagian berikutnya.
- Klik Konfigurasi layar izin. 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 halaman Informasi aplikasi sesuai dengan petunjuk di layar, lalu klik Simpan dan lanjutkan. Panel Scopes akan ditampilkan.
- Anda tidak perlu menambahkan cakupan apa pun, jadi klik Save and continue. Panel Test users akan ditampilkan.
- Jika Anda ingin menambahkan pengguna untuk menguji akses ke aplikasi, klik Tambahkan pengguna. Panel Tambahkan pengguna akan ditampilkan. Pengguna pengujian memiliki hak istimewa untuk memberikan izin di aplikasi Anda.
- Di kolom kosong, tambahkan satu atau beberapa alamat email Akun Google, lalu klik Tambahkan.
- Klik Simpan dan lanjutkan. Panel Ringkasan akan ditampilkan.
- Tinjau informasi layar izin OAuth Anda, lalu klik Kembali ke dasbor.
Lihat Menyiapkan layar izin OAuth di situs Bantuan Konsol Google Cloud untuk mengetahui detail selengkapnya.
Mendaftarkan aplikasi dan membuat kredensial
Untuk mendaftarkan aplikasi ke OAuth 2.0 dan membuat kredensial OAuth, ikuti petunjuk yang diberikan di Menyiapkan OAuth 2.0. Anda harus menunjukkan jenis aplikasi, yaitu aplikasi native/Android.
Tambahkan sidik jari SHA-1 yang Anda dapatkan dari menandatangani aplikasi ke klien OAuth yang Anda siapkan di konsol Google Cloud dengan mengikuti petunjuk di Menyiapkan aplikasi OAuth 2.0 / Native di situs Bantuan Google Cloud Console.
Dengan perangkat seluler yang terhubung ke mesin lokal, pilih perangkat dari daftar, lalu klik Run project lagi untuk menjalankannya. Untuk petunjuk yang lebih mendetail, lihat Menjalankan aplikasi di perangkat hardware di situs Android Developers.
Jika Anda sudah memiliki klien OAuth
Jika sudah memiliki klien OAuth terverifikasi untuk aplikasi yang dipublikasikan, Anda dapat menggunakan klien OAuth yang 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 terverifikasi dari integrasi lain.
Pertimbangan berikut berlaku:
Ada batas 100 pengguna saat menggunakan klien OAuth yang sudah ada. Untuk informasi tentang cara menambahkan pengguna pengujian, lihat Menyiapkan layar izin OAuth. Terlepas dari verifikasi OAuth, ada batas 100 pengguna yang dapat memberikan izin ke aplikasi Anda yang diberlakukan oleh Home API. Batasan ini dicabut setelah pendaftaran Developer Console selesai.
Developer Console pendaftaran harus dikirim untuk disetujui saat Anda siap membatasi pemberian jenis perangkat melalui OAuth sebagai persiapan untuk mengupdate aplikasi 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.