Ringkasan

Google Health API adalah solusi komprehensif yang dibangun dari awal, yang memberi developer akses yang andal ke berbagai data kesehatan pengguna yang telah diberi izin dan berbagai jenis data. Google Health API menggunakan konsol baru untuk mendaftarkan aplikasi Anda, Google OAuth 2.0, jenis data baru, skema endpoint baru, dan format respons baru.

Panduan ini dirancang untuk membantu developer memigrasikan aplikasi Fitbit Web API yang sudah ada ke Google Health API yang baru. Bagian ini berisi rekomendasi untuk memastikan migrasi yang lancar sekaligus mempertahankan pengguna.

Mengapa Anda harus bermigrasi?

Ini bukan hanya update, tetapi juga langkah strategis untuk memastikan aplikasi Anda aman dan siap untuk kemajuan teknologi kesehatan di masa mendatang. Beberapa manfaat menggunakan Google Health API adalah:

  • Akses ke Data Komprehensif: Dapatkan akses yang andal ke berbagai jenis data dan data kesehatan pengguna yang diizinkan.
  • Keamanan yang Ditingkatkan: Kepatuhan terhadap praktik terbaik keamanan Google, yang selaras dengan standar keamanan, privasi, dan identitas Google.
  • Konsistensi: Menghilangkan inkonsistensi lama dalam format data, zona waktu, unit pengukuran, dan penanganan error untuk pengalaman developer yang lebih intuitif.
  • Skalabilitas & Persiapan untuk Masa Depan: Didesain agar dapat diskalakan untuk memenuhi permintaan di masa mendatang dan mendukung protokol modern seperti gRPC.

Beralih dari Fitbit Web API ke Google Health API melibatkan lebih dari sekadar modifikasi teknis. Karena peralihan ke library OAuth baru, token akses dan refresh yang ada tidak dapat ditransfer, sehingga pengguna harus memberikan ulang izin untuk integrasi yang telah diupdate.

Mendukung kedua metode login

Karena Fitbit Web API dan Google Health API menggunakan sistem yang berbeda untuk menangani login pengguna, saat Fitbit Web API masih aktif, aplikasi Anda akan memerlukan dukungan sementara untuk kedua metode secara bersamaan.

Daripada aplikasi Anda meminta data secara langsung, terapkan lapisan yang memutuskan apakah akan berinteraksi dengan Fitbit Web API atau Google Health API untuk pengguna tertentu, sehingga bagian aplikasi Anda yang lain tidak perlu mengkhawatirkan detailnya.

Perbarui database pengguna Anda untuk menyertakan tanda (misalnya, oauth_type) untuk mengidentifikasi sistem login yang mereka gunakan.

  • Untuk pengguna baru: Siapkan mereka secara otomatis dengan Google Health API baru (oauth_type: google).
  • Untuk pengguna lama: Tetap gunakan Fitbit Web API hingga mereka memperbarui izin mereka (oauth_type: fitbit).

Untuk menghindari gangguan pada pengalaman pengguna, sebaiknya jangan memaksa semua orang untuk logout dan login kembali. Sebagai gantinya:

  1. Saat pengguna yang tetap terhubung ke Fitbit Web API berinteraksi dengan aplikasi Anda, tunjukkan notifikasi yang ramah untuk mendorong mereka memperbarui koneksi.
  2. Saat pengguna menyetujui tindakan update, segera picu alur login Google Health.
  3. Setelah login Google berhasil, simpan kredensial Google baru ke profil pengguna dan alihkan tanda oauth_type mereka dari fitbit ke google. Jika penyiapan Anda memungkinkan, secara terprogram keluarkan mereka dari sistem Fitbit lama dengan mencabut token mereka agar tetap rapi dan aman.

Memastikan kontinuitas data

Saat mentransisikan integrasi dari Fitbit Web API lama ke Google Health API, aplikasi developer harus memperhitungkan perubahan dalam struktur identifikasi pengguna.

Fitur Fitbit Web API lama mengidentifikasi akun menggunakan string alfanumerik 6 karakter (seperti A1B2C3), sedangkan Google Health API menggunakan healthUserId yang diformat sebagai string hingga 63 digit & karakter.

Untuk menjembatani kesenjangan ini tanpa kehilangan konteks pengguna, developer dapat membuat kueri endpoint getIdentity untuk mendapatkan ID pengguna Fitbit dan Health. Endpoint ini menampilkan payload yang berisi legacyUserId dan healthUserId baru, sehingga aplikasi dapat membuat pemetaan secara dinamis antara data yang ada dan sistem akun baru.

Mengisi ulang data historis

Jika pengguna tidak melakukan autentikasi ke endpoint Google Health API baru sebelum endpoint lama dinonaktifkan, data mereka akan tetap tersedia selama mereka terus menyinkronkan perangkat mereka ke aplikasi Google Health. Namun, Anda mungkin mengalami kesenjangan data untuk pengguna ini.

Untuk mengisi ulang data mereka, setelah pengguna melakukan autentikasi ulang ke endpoint baru, Anda dapat menggunakan Google Health API kami untuk mengisi ulang data historis mereka. Lihat Membuat kueri data historis untuk mendapatkan panduan.

Komunikasi dan waktu

Untuk membantu pengguna Anda beralih dari OAuth Fitbit yang ada ke OAuth Google yang baru, ikuti praktik terbaik berikut.

Komunikasi yang mengutamakan nilai

Jangan memulai dengan "Kami memperbarui API kami", mulailah dengan manfaat mengintegrasikan data Google Health ke dalam aplikasi Anda, tetapi pastikan mereka mengetahui bahwa mereka perlu melakukan autentikasi ulang jika ingin data mereka disinkronkan:

  • Jelaskan dengan jelas fitur yang tersedia di aplikasi Anda yang didukung oleh integrasi, dan sesuaikan pesan Anda dengan cara pengguna mendapatkan manfaat dari fitur tersebut.
  • Fokus pada fitur Anda dan berikan kasus penggunaan, bukan detail penerapan teknis.
  • Jangan katakan: "Anda tidak akan dapat terhubung ke Fitbit API."
  • Lakukan: "Untuk terus melihat latihan fisik mendetail dengan data detak jantung, berikan kembali izin untuk Google Health API."

Waktu untuk memberi tahu pengguna

Dalam semua komunikasi pengguna, patuhi pedoman merek Google Health, dan gunakan banner, kartu, atau pemberitahuan yang dapat ditutup.

  • Jangan memicu layar izin ulang saat pengguna sedang di tengah-tengah latihan fisik atau mencatat sesuatu secara manual.
  • Hanya jadikan pemberian izin ulang sebagai hal yang wajib setelah beberapa minggu peringatan, bertepatan dengan batas waktu penghentian penggunaan Fitbit Web API resmi.
  • Jika pengguna belum memberikan izin ulang setelah batas akhir, berikan jalur pemulihan yang lancar. Berikan pesan bantuan di banner, kartu atau tooltip yang membantu mereka memahami alasan data mereka tidak ada, dan cara memperbaikinya.