Fitbit Web API telah ditingkatkan dan dimodernisasi untuk memberikan fondasi yang lebih terstandardisasi, konsisten, dan skalabel untuk integrasi developer, dan kini disebut Google Health API. Google Health API mewakili evolusi strategis Fitbit Web API lama, yang dibangun kembali dari awal di infrastruktur modern Google.
Dengan platform ini, developer mendapatkan akses ke kecanggihan penuh alat developer Google Cloud dan kemudahan cara yang sudah dikenal dan disederhanakan bagi pengguna untuk mengelola izin mereka melalui Google OAuth 2.0.
Apa yang Anda dapatkan dengan Google Health API?
- Sumber kebenaran terpadu: "Reconciled Stream" baru kami menangani tugas kompleks dalam merekonsiliasi titik data yang tumpang-tindih dari berbagai sumber. Hal ini memastikan aplikasi menampilkan data konsisten yang sama dengan yang dilihat pengguna dalam aplikasi Fitbit. Aliran data ini akan disediakan selain aliran data pihak pertama kami yang mencakup data dari perangkat Fitbit dan Pixel, serta entri manual.
- Modernisasi & performa teknis: Kami telah menggabungkan lebih dari 100 endpoint lama menjadi kumpulan paket jenis data yang disederhanakan dan menghilangkan inkonsistensi dalam format data, zona waktu, satuan pengukuran, dan penanganan error. Selain itu, kami kini mendukung protokol HTTP/REST untuk pengambilan data berperforma tinggi. Selain itu, data intraday dan webhook kini tersedia untuk semua jenis data yang relevan melalui endpoint daftar khusus.
- Webhook & skalabilitas yang ditingkatkan: Manfaatkan dukungan webhook yang diperluas, termasuk langganan otomatis dan pengelolaan mendetail untuk semua jenis data yang relevan, yang dirancang untuk diskalakan dengan aplikasi kesehatan berbasis AI generasi berikutnya.
- Identitas & keamanan yang disederhanakan: Ganti Otorisasi Fitbit (FOT) lama dengan Google OAuth 2.0. Hal ini memungkinkan developer menggunakan library autentikasi Google standar, menyederhanakan codebase, sekaligus memberi pengguna cara yang familier dan terpusat untuk mengelola izin mereka. Semua cakupan Google Health API dikategorikan sebagai Dibatasi, sehingga memerlukan peninjauan privasi dan keamanan untuk akses.
Puas dengan hasilnya? Mulai sekarang!
Versi API dan saluran beta publik
Google Health API menggunakan pembuatan versi berbasis saluran sesuai dengan
Proposal Peningkatan API
(AIP) Google, khususnya
AIP-185: Pembuatan versi
API
dan AIP-181: Tingkat
stabilitas. API ini
tersedia di dua saluran publik: saluran v4 stabil dan saluran v4beta
beta publik. Google mendukung kedua saluran melalui saluran dukungan standar.
Membandingkan saluran stabil dan beta
Sesuai dengan AIP-185, saluran v4beta bertindak sebagai superset dari saluran v4 yang stabil. Library ini mencakup
semua fungsi v4 yang stabil beserta jenis data, kolom, dan
metode akses awal yang sedang menjalani pengujian partner.
Dalam dokumentasi, elemen API yang hanya tersedia di saluran beta menampilkan label v4beta.
| Fitur | Saluran stabil (v4) |
Saluran beta publik (v4beta) |
|---|---|---|
| URI dasar REST | https://health.googleapis.com/v4 |
https://health.googleapis.com/v4beta |
| Paket gRPC | google.devicesandservices.health.v4 |
google.devicesandservices.health.v4beta |
| Dokumen referensi | REST v4 dan RPC v4 | REST v4beta dan RPC v4beta |
| Tingkat stabilitas | Siap produksi dan diatur oleh aturan kompatibilitas mundur AIP-180. | Pratinjau tidak stabil dapat berubah atau dihapus kapan saja tanpa pemberitahuan. |
| Penggunaan yang dimaksudkan | Aplikasi produksi live yang ditampilkan kepada pengguna. | Pengujian awal, pembuatan prototipe, validasi skema, dan masukan developer. |
| Dukungan | Didukung melalui saluran dukungan standar. | Didukung melalui saluran dukungan standar untuk laporan bug, pemecahan masalah, dan masukan desain. |
Cara memperlakukan saluran v4beta
Saat mempelajari kemampuan yang diberi tag v4beta, ikuti panduan berikut:
- Gunakan
v4betaterutama di lingkungan pengujian pengembangan, staging, dan non-produksi. Sebaiknya jangan mengirimkan fitur produksi yang bergantung pada endpointv4betaatau jenis data khusus beta. - Skema, nama kolom, perilaku endpoint, dan representasi data di
v4betadapat berubah tanpa peringatan. Fitur dan jenis data beta juga dapat dihapus sepenuhnya jika tidak memenuhi sasaran validasi. - Isolasi kode klien
v4betaeksperimental di balik tombol fitur atau modul terpisah sehingga perubahan yang dapat menyebabkan gangguan di saluran beta tidak mengganggu integrasiv4inti Anda. - Dapatkan dukungan, laporkan masalah, dan bagikan masukan penerapan untuk
v4betamelalui saluran dukungan standar kami untuk membantu membentuk desain API akhir.
Promosi dari v4beta ke v4 stabil
Jenis data dan fitur baru memasuki v4beta untuk mendukung pengujian partner dan
validasi pasar sebelum beralih ke saluran v4 stabil.
Google mengevaluasi fitur beta berdasarkan kriteria berikut sebelum mempromosikannya ke v4:
- Pengujian partner mengonfirmasi bahwa model data, semantik kolom, dan pola kueri memenuhi persyaratan aplikasi di dunia nyata.
- Masukan developer dan peninjauan desain telah selesai, dan skema siap dikunci berdasarkan jaminan kompatibilitas mundur AIP-180.
- Pipeline data end-to-end, sinkronisasi perangkat, dan keandalan layanan memenuhi standar kualitas produksi.
- Sesuai dengan aturan penghentian penggunaan AIP-185,
semua kolom atau perilaku yang tidak digunakan lagi selama pengujian beta akan dihapus, bukan
dipromosikan ke
v4.
Meskipun AIP-181
memberikan aturan umum sekitar 90 hari untuk evaluasi beta, waktu
sebenarnya untuk mempromosikan fitur dari v4beta ke v4 bergantung pada kompleksitas
fitur, ketersediaan hardware, dan masukan validasi. Beberapa fitur mungkin
akan lulus lebih cepat, sementara fitur lainnya mungkin tetap berada di v4beta lebih lama atau dihentikan.
Saat jenis data atau fitur dipromosikan ke saluran v4 stabil, Google
akan mengumumkan kelulusan tersebut di Catatan rilis. Pada saat itu, perbarui permintaan Anda dari https://health.googleapis.com/v4beta ke
https://health.googleapis.com/v4 sebelum merilis integrasi kepada pengguna produksi.
Bagaimana dengan Fitbit Web API?
Fitbit Web API lama telah dinonaktifkan sesuai dengan linimasa berikut:
- 30 September 2026 (Akhir dukungan): Dukungan untuk Fitbit Web API berakhir, dan Google berhenti memperbaiki bug atau memberikan dukungan API.
- 2 November 2026 (Penonaktifan API): Endpoint Fitbit Web API dan Fitbit OAuth
dinonaktifkan dan tidak lagi berfungsi atau menyinkronkan data ke atau dari
pengguna Google Health. Permintaan ke endpoint ini akan gagal dan menampilkan kode status HTTP
410 Gone.
Developer yang menggunakan Fitbit Web API dan Otorisasi Fitbit lama harus memigrasikan aplikasi dan pengguna mereka ke Google Health API dan Google OAuth 2.0.
Lihat panduan migrasi untuk memulai.
Perangkat apa yang didukung?
Semua perangkat Fitbit dan Google Pixel Watch, baik yang saat ini maupun yang sebelumnya, akan mengumpulkan data yang ditampilkan melalui Google Health API. Jenis data yang tersedia akan bergantung pada fungsi yang didukung perangkat.
Daftar perangkat saat ini dapat ditemukan di Google Store.
Bagaimana cara memberikan masukan?
Masukan Anda sangat berharga. Sebaiknya sampaikan pendapat Anda melalui saluran dukungan kami, yang tercantum di halaman Dukungan.
Meskipun kami telah berupaya keras untuk memastikan API ini mendukung Anda dengan baik, Google Health API terus berkembang secara aktif. Perhatikan bahwa berdasarkan masukan Anda, kami mungkin akan memperkenalkan perubahan antara sekarang dan akhir Mei yang akan memerlukan pembaruan yang sesuai di pihak Anda.
Roadmap
Berikut adalah daftar fitur yang akan hadir pada tahun 2026.
Kuartal 4 2026
Jenis Data (baca & tulis)
- Suhu kulit terperinci
- Laju Metabolisme Basal
- Kami akan menambahkan jenis data untuk mencapai kesetaraan dengan Health Connect. Anda dapat mengharapkan lebih banyak jenis data Health Connect yang akan ditambahkan pada Kuartal 4 tahun 2026 dan Kuartal 1 tahun 2027.
Fitur
- Saluran beta publik untuk akses awal ke jenis data baru
- Endpoint statistik untuk memantau telemetri webhook