Tất cả các điểm cuối Google Health API đọc và ghi dữ liệu người dùng đều yêu cầu người dùng đồng ý với việc thu thập dữ liệu đó thông qua một hoặc nhiều phạm vi. Ứng dụng phải cung cấp danh sách các phạm vi khi gọi điểm cuối uỷ quyền OAuth2 của Google. Xem phần Lấy mã truy cập OAuth2. Mã truy cập được cấp sẽ chỉ chứa những phạm vi mà người dùng đồng ý đã uỷ quyền.
Tất cả các phạm vi API Google Health đều bắt đầu bằng:
https://www.googleapis.com/auth/googlehealth
Triển khai
Để mang lại trải nghiệm tốt nhất cho người dùng và đảm bảo tuân thủ quy định về bảo mật, khi yêu cầu phạm vi, bạn nên:
- Chỉ yêu cầu các phạm vi cần thiết: Chỉ yêu cầu quyền truy cập vào các phạm vi dữ liệu cụ thể mà ứng dụng của bạn cần để hoạt động.
- Chỉ định cấu hình quyền ghi khi gửi dữ liệu: Chỉ định cấu hình quyền "ghi" (ví dụ: sử dụng phạm vi
writeonly) nếu bạn đang gửi dữ liệu đến Google Health. - Xử lý một phần sự đồng ý một cách thích hợp: Ứng dụng của bạn sẽ không gặp lỗi nếu người dùng không chọn tất cả các phạm vi xuất hiện trên màn hình xin phép.
- Nếu ứng dụng của bạn yêu cầu tất cả các phạm vi được trình bày hoạt động, bạn có thể trình bày văn bản: "Để có trải nghiệm người dùng tốt nhất, bạn nên bật tất cả các phạm vi."
Các phạm vi hiện có
| Phạm vi | Quyền |
|---|---|
| .activity_and_fitness.readonly | Xem dữ liệu về hoạt động và thể chất của bạn trong Google Health. |
| .activity_and_fitness.writeonly | Thêm dữ liệu về hoạt động chung và dữ liệu thể chất vào Google Health, đồng thời chỉnh sửa hoặc xoá dữ liệu mà ứng dụng này thêm vào. |
| .ecg.readonly | Xem dữ liệu ECG (điện tâm đồ) của bạn trong Google Health. |
| .health_metrics_and_measurements.readonly | Xem dữ liệu số đo và chỉ số sức khoẻ của bạn trong Google Health. |
| .health_metrics_and_measurements.writeonly | Thêm dữ liệu số đo và chỉ số sức khoẻ của bạn vào Google Health, cũng như chỉnh sửa hoặc xoá dữ liệu mà ứng dụng này thêm. |
| .irn.readonly | Xem dữ liệu Thông báo về tình trạng nhịp tim không đều trên Google Health của bạn. |
| .location.readonly | Xem vị trí GPS của bạn trên Google Health được ghi lại trong một bài tập thể dục. |
| .nutrition.readonly | Xem dữ liệu dinh dưỡng của bạn trong Google Health. |
| .nutrition.writeonly | Thêm dữ liệu dinh dưỡng vào Google Health, cũng như chỉnh sửa hoặc xoá dữ liệu mà ứng dụng này thêm. |
| .profile.readonly | Xem dữ liệu hồ sơ của bạn trong Google Health. |
| .profile.writeonly | Thêm dữ liệu hồ sơ vào Google Health, cũng như chỉnh sửa hoặc xoá dữ liệu mà ứng dụng này thêm. |
| .settings.readonly | Xem chế độ cài đặt của bạn trong Google Health. |
| .settings.writeonly | Thêm dữ liệu chế độ cài đặt vào Google Health, cũng như chỉnh sửa hoặc xoá dữ liệu mà ứng dụng này thêm vào. |
| .sleep.readonly | Xem dữ liệu giấc ngủ của bạn trong Google Health. |
| .sleep.writeonly | Thêm dữ liệu giấc ngủ vào Google Health, cũng như chỉnh sửa hoặc xoá dữ liệu mà ứng dụng này thêm. |