Semua endpoint Google Health API yang membaca dan menulis data pengguna memerlukan izin pengguna untuk pengumpulan data tersebut melalui satu atau beberapa cakupan. Aplikasi harus memberikan daftar cakupan saat memanggil endpoint autentikasi OAuth2 Google. Lihat Mendapatkan Token Akses OAuth2. Token akses yang dikeluarkan hanya akan berisi cakupan yang telah diizinkan oleh pengguna yang memberikan izin.
Semua cakupan Google Health API dimulai dengan:
https://www.googleapis.com/auth/googlehealth
Penerapan
Untuk memberikan pengalaman pengguna terbaik dan memastikan kepatuhan keamanan, saat meminta cakupan, Anda harus:
- Hanya minta cakupan yang diperlukan: Hanya minta akses ke cakupan data tertentu yang diperlukan aplikasi Anda agar dapat berfungsi.
- Konfigurasi akses tulis hanya saat mengirim data: Hanya konfigurasi akses "tulis"
(misalnya, menggunakan cakupan
writeonly) jika Anda mengirim data ke Google Health. - Tangani izin sebagian dengan baik: Aplikasi Anda tidak boleh gagal
jika pengguna tidak memilih semua cakupan yang ditampilkan di layar izin.
- Jika aplikasi Anda memerlukan semua cakupan yang ditampilkan agar dapat berfungsi, Anda dapat menampilkan teks: "Untuk pengalaman pengguna terbaik, sebaiknya aktifkan semua cakupan."
Cakupan yang tersedia
| Cakupan | Izin |
|---|---|
| .activity_and_fitness.readonly | Melihat data aktivitas dan kebugaran Google Health Anda. |
| .activity_and_fitness.writeonly | Menambahkan data aktivitas dan kebugaran ke Google Health, serta mengedit atau menghapus data yang ditambahkannya. |
| .ecg.readonly | Melihat data EKG Google Health Anda. |
| .health_metrics_and_measurements.readonly | Melihat data pengukuran dan metrik kesehatan Google Health Anda. |
| .health_metrics_and_measurements.writeonly | Menambahkan metrik kesehatan dan data pengukuran ke Google Health, serta mengedit atau menghapus data yang ditambahkannya. |
| .irn.readonly | Melihat data Notifikasi Irama Tidak Teratur Google Health Anda. |
| .location.readonly | Melihat lokasi GPS Google Health Anda yang direkam selama latihan. |
| .nutrition.readonly | Melihat data nutrisi Google Health Anda. |
| .nutrition.writeonly | Menambahkan data nutrisi ke Google Health, serta mengedit atau menghapus data yang ditambahkannya. |
| .profile.readonly | Melihat data profil Google Health Anda. |
| .profile.writeonly | Menambahkan data profil ke Google Health, serta mengedit atau menghapus data yang ditambahkannya. |
| .settings.readonly | Melihat setelan Google Health Anda. |
| .settings.writeonly | Menambahkan data setelan ke Google Health, serta mengedit atau menghapus data yang ditambahkannya. |
| .sleep.readonly | Melihat data tidur Google Health Anda. |
| .sleep.writeonly | Menambahkan data tidur ke Google Health, serta mengedit atau menghapus data yang ditambahkannya. |