API Google Fit, termasuk Google Fit REST API, akan dihentikan pada tahun 2026. Mulai 1 Mei 2024, developer tidak dapat mendaftar untuk menggunakan API ini.

Sebaiknya lakukan migrasi ke Google Health API untuk integrasi berbasis cloud atau Health Connect untuk pelacakan langkah dan aplikasi Android yang mengutamakan perangkat seluler. Untuk mengetahui petunjuk tentang API atau platform yang akan digunakan untuk bermigrasi, buka panduan migrasi Fit.

Google menggunakan teknologi AI untuk menerjemahkan konten ke dalam bahasa pilihan Anda. Terjemahan AI mungkin mengandung kesalahan.

Mulai menggunakan Android

Panduan ini menjelaskan cara memulai pengembangan dengan Google Fit di Android.

Penyiapan

Sebelum mulai membangun aplikasi, selesaikan langkah-langkah di bagian berikut.

Membuat Akun Google

Untuk menggunakan Google Fit API, Anda memerlukan Akun Google. Anda dapat membuat akun baru atau menggunakan akun yang ada. Sebaiknya buat akun terpisah untuk menguji aplikasi Anda dari perspektif pengguna.

Dapatkan layanan Google Play

Dapatkan library klien terbaru untuk layanan Google Play di host pengembangan Anda:

Buka Android SDK Manager.
Di bagian SDK Tools, temukan layanan Google Play.
Jika status untuk paket ini bukan Installed, pilih keduanya, lalu klik Install Packages.

Mendapatkan client ID OAuth 2.0

Untuk mengaktifkan Fitness API, dapatkan client ID OAuth 2.0.

Membuat dan mengonfigurasi project Anda

Sebaiknya gunakan lingkungan pengembangan Android Studio untuk membangun aplikasi dengan Fitness API. Untuk mengetahui detail tentang cara membuat project baru dan mengonfigurasinya di Android Studio, lihat Membuat 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:

DSL Kotlin

plugin {
    id("com.android.application")
}

...

dependencies {
        implementation("com.google.android.gms:play-services-fitness:21.3.0")
        implementation("com.google.android.gms:play-services-auth:22.0.0")
}

Groovy DSL

apply plugin: 'com.android.application'

...

dependencies {
    implementation 'com.google.android.gms:play-services-fitness:21.3.0'
    implementation 'com.google.android.gms:play-services-auth:22.0.0'
}

Tindakan ini memastikan Gradle otomatis mendownload SDK kebugaran saat mem-build aplikasi Anda.

Mem-build dan menguji aplikasi

Setelah menyelesaikan langkah-langkah penyiapan, Anda dapat mulai mem-build aplikasi. Untuk memulai, pelajari jenis data yang dapat disimpan dan dibaca oleh aplikasi Anda. Pelajari lebih lanjut cara menggunakan data di Google Fit.

Mendapatkan izin Android yang diperlukan

Untuk membaca dan menulis beberapa jenis data, aplikasi Anda harus meminta izin Android.

Mendapatkan izin OAuth

Jenis data yang dapat diakses oleh aplikasi Anda sesuai dengan cakupan otorisasi. Untuk meminta izin ini, Anda harus menambahkan jenis data yang memerlukan akses aplikasi dalam instance FitnessOptions. Saat aplikasi Anda meminta untuk menggunakan salah satu jenis data Google Fit, Android SDK akan otomatis memeriksa cakupan yang dimilikinya dan meminta otorisasi kepada pengguna untuk cakupan tersebut.

Membuat klien API

Buat klien API dan tambahkan jenis data yang perlu diakses aplikasi Anda untuk menulis atau membaca data. Endpoint berikut tersedia:

SensorsClient: Mengakses berbagai sumber data kesehatan dan kebugaran dari sensor hardware di perangkat lokal dan di perangkat pendamping.
RecordingClient: Untuk pengumpulan data sensor di 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 Kardio dan Langkah yang dibuat oleh pengguna di Google Fit.
ConfigClient: Mengakses jenis dan setelan data kustom di platform Google Fit.

Lihat contoh cara membuat klien Fitness API.

Alur otorisasi pengguna yang dihasilkan

Berikut adalah alur otorisasi yang dihasilkan dan dialami pengguna saat mereka diminta memberikan izin:

**Gambar 1.**Alur otorisasi untuk pengguna.

Izin Android: Pengguna melihat izin Android yang diminta aplikasi Anda sebelum mendownloadnya. Setelah didownload, aplikasi Anda akan meminta izin runtime yang diperlukan, dan pengguna akan memberikan atau menolak izin 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 cakupan OAuth yang diperlukan aplikasi Anda untuk jenis data yang ingin diakses.
Akses diterapkan: Setelah pengguna memberikan izin, aplikasi Anda dapat mengakses jenis data yang termasuk dalam cakupan yang telah diizinkan oleh pengguna.

Mengajukan permohonan verifikasi

Setelah membuat dan menguji aplikasi, Anda harus mengajukan permohonan verifikasi dengan berbagai tingkat justifikasi yang diperlukan untuk cakupan sensitif dan dibatasi.