Panduan ini menjelaskan cara memulai pengembangan dengan Google Fit di Android.
Penyiapan
Sebelum Anda mulai membangun aplikasi, selesaikan langkah-langkah berikut bagian.
Membuat Akun Google
Untuk menggunakan Google Fit API, Anda memerlukan Akun Google. Anda dapat membuat akun baru atau
menggunakan akun yang sudah ada.
Dapatkan layanan Google Play
Dapatkan library klien terbaru untuk layanan Google Play terkait pengembangan Anda host:
- Buka Android SDK Manager.
- Di bagian SDK Tools, temukan layanan Google Play.
- Jika status untuk paket ini bukan Terinstal, pilih keduanya dan klik Install Packages.
Mendapatkan client ID OAuth 2.0
Untuk mengaktifkan Fitness API, dapatkan client ID OAuth 2.0.
Membuat dan mengonfigurasi project
Sebaiknya gunakan lingkungan pengembangan Android Studio untuk membuat aplikasi dengan Fitness API. Sebagai detail tentang cara membuat project baru dan mengonfigurasinya di Android Studio, lihat Buat project.
Menambahkan library klien layanan Google Play
Di Android Studio, buka file build.gradle
untuk modul Anda dan tambahkan library klien layanan Google Play sebagai dependensi:
plugin { id("com.android.application") } ... dependencies { implementation("com.google.android.gms:play-services-fitness:21.2.0") implementation("com.google.android.gms:play-services-auth:21.3.0") }
apply plugin: 'com.android.application' ... dependencies { implementation 'com.google.android.gms:play-services-fitness:21.2.0' implementation 'com.google.android.gms:play-services-auth:21.3.0' }
Hal ini memastikan Gradle akan otomatis mendownload SDK kebugaran saat SDK tersebut membangun aplikasi Anda.
Membangun dan menguji aplikasi
Setelah menyelesaikan langkah-langkah penyiapan, Anda dapat mulai membangun aplikasi. Untuk mendapatkan memulai, pelajari jenis data yang dapat disimpan dan disimpan oleh aplikasi Anda dibaca. Pelajari lebih lanjut cara bekerja dengan data di Google Fit.
Mendapatkan izin Android yang diperlukan
Untuk membaca dan menulis beberapa jenis data, aplikasi Anda perlu meminta izin Android.
Mendapatkan izin OAuth
Jenis data yang izin aksesnya dimiliki aplikasi Anda
cakupan otorisasi. Untuk bertanya
untuk izin ini, Anda perlu menambahkan
jenis data yang perlu diakses oleh aplikasi Anda di FitnessOptions
instance Anda. Saat aplikasi meminta untuk menggunakan salah satu data Google Fit
Android SDK otomatis memeriksa cakupan mana saja yang dimilikinya dan menanyakan
pengguna untuk otorisasi
atas cakupan tersebut.
Membuat klien API
Membuat klien API dan menambahkan jenis data yang perlu diakses oleh aplikasi Anda menulis atau membaca data. Tersedia endpoint berikut:
-
SensorsClient
: Mengakses berbagai sumber data kesehatan dan kebugaran dari sensor hardware di perangkat lokal dan di perangkat pendamping. -
RecordingClient
: Untuk pengumpulan data sensor latar belakang yang selalu aktif dan berdaya rendah. -
HistoryClient
: Menyisipkan, menghapus, dan membaca data historis di Google Fit. -
SessionsClient
: Membuat dan mengelola Sesi aktivitas pengguna. -
GoalsClient
: Membaca sasaran Poin Jantung dan Langkah yang dibuat oleh pengguna di Google Fit. -
ConfigClient
: Mengakses jenis dan setelan data kustom di platform Google Fit.
Alur otorisasi pengguna yang dihasilkan
Berikut ini adalah hasil alur otorisasi yang dialami pengguna saat mereka dimintai izin:

- Izin Android: Pengguna melihat izin Android yang digunakan aplikasi Anda yang diminta sebelum mengunduhnya. Setelah diunduh, aplikasi meminta izin runtime apa pun yang diperlukan, dan pengguna memberikan atau menolak izin akses ini.
- Periksa dan hubungkan: Aplikasi Anda memeriksa apakah izin telah diberikan sebelum meminta akses ke jenis data lain.
- Permintaan cakupan OAuth: Google meminta pengguna untuk memberikan izin aplikasi Anda cakupan OAuth yang diperlukan untuk tipe data yang ingin diakses.
- Akses diterapkan: Setelah pengguna memberikan izin, aplikasi Anda dapat mengakses jenis data yang termasuk dalam cakupan yang telah diberikan pengguna izin akses.
Ajukan permohonan verifikasi
Setelah membuat dan menguji aplikasi, Anda perlu mengajukan permohonan verifikasi dengan alamat email tingkat pembenaran yang diperlukan untuk cakupan sensitif dan dibatasi.