Các kiểu dữ liệu của Google Health API

Bảng sau đây chứa danh sách đầy đủ các loại dữ liệu, với một số cột để giúp bạn hiểu rõ cách biểu thị từng loại trong Google Health API, cũng như phạm vi mà từng loại có sẵn.

Lưu ý: Health API không hỗ trợ các thiết bị Fitbit Ace. Để biết thêm thông tin, hãy xem Chính sách quyền riêng tư của Fitbit dành cho tài khoản của trẻ em.

Trường loại dữ liệu

Bảng các loại dữ liệu của Google Health API bao gồm một số cột trường để giúp bạn hiểu được cách biểu thị và yêu cầu của từng loại dữ liệu. Các cột này như sau:

Bảng: Nội dung mô tả các trường kiểu dữ liệu của Google Health API

Trường	Mô tả
dataType	Giá trị nhận dạng được phân tách bằng dấu gạch ngang (ví dụ: active-minutes) được dùng trong URL điểm cuối.
Tham số filter	Mã nhận dạng được phân tách bằng dấu gạch dưới (ví dụ: active_minutes) được dùng làm giá trị cho tham số bộ lọc dataType trong các yêu cầu tổng hợp và tổng hợp hằng ngày.
Loại bản ghi	Cho biết cấu trúc và định dạng của dữ liệu được ghi lại. Trong trường hợp này, điều này phù hợp với biểu thị tài nguyên của các điểm dữ liệu. Các giá trị có thể là: Interval (Biểu thị các phép đo được ghi lại trong một khoảng thời gian.) Sample (Biểu thị các phép đo tức thời.) Daily (Biểu thị các số liệu đo lường được tổng hợp hoặc ghi lại hằng ngày.) Session (Đại diện cho một khối bản ghi liên tục, chẳng hạn như một buổi tập luyện hoặc một phiên điện tâm đồ (ECG).) Food (Biểu thị một món ăn hoặc thực thể dữ liệu liên quan đến dinh dưỡng.)
Các thao tác có thể thực hiện	Liệt kê các phương thức API được hỗ trợ cho loại dữ liệu (chẳng hạn như list, create và rollUp).
Phạm vi	(Các) phạm vi OAuth bắt buộc để truy cập vào kiểu dữ liệu.
Hỗ trợ webhook	Cho biết loại dữ liệu hỗ trợ thông báo theo thời gian thực bằng cách sử dụng webhook khi dữ liệu mới được đồng bộ hoá.
Hỗ trợ giá trị 0 thực	Cho biết rằng kiểu dữ liệu hỗ trợ việc ghi lại các giá trị 0 rõ ràng để phân biệt giữa giá trị 0 đang hoạt động (chẳng hạn như 0 phút hoạt động) với dữ liệu bị thiếu hoặc chưa được ghi lại.
Độ phân giải lưu trữ	Khoảng thời gian ghi hoặc lấy mẫu tối thiểu mà các điểm dữ liệu được lưu trữ (ví dụ: 1 phút cho steps). Đối với các bản tổng hợp, khoảng thời gian này biểu thị windowSize tối thiểu được đề xuất để đảm bảo việc tổng hợp được phân phối đồng đều mà không có các cấu phần dữ liệu phụ.
Thiết bị tương thích	Một danh sách có thể mở rộng gồm các thiết bị vật lý có thể ghi lại và đồng bộ hoá loại dữ liệu này với Google Health API (bằng ứng dụng Fitbit).

Bảng: Các kiểu dữ liệu của Google Health API

Loại dữ liệu	Các thao tác có thể thực hiện	Phạm vi
Năng lượng đốt cháy khi hoạt động dataType: active-energy-burned tham số bộ lọc: active_energy_burned Loại bản ghi: Khoảng thời gian Độ phân giải lưu trữ: 1 phút Hướng dẫn về lượng calo và năng lượng	list, reconcile, rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly
Phút hoạt động dataType: active-minutes tham số bộ lọc: active_minutes Loại bản ghi: Khoảng thời gian Độ phân giải lưu trữ: 1 phút Thiết bị tương thích Fitbit Air Fitbit Alta Fitbit Alta HR Fitbit Blaze Fitbit Charge 2 Fitbit Charge 3 Fitbit Flex 2 Fitbit Inspire Fitbit Inspire HR Pixel Watch 4	list, reconcile, rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly
Số phút hoạt động cho vùng nhịp tim dataType: active-zone-minutes tham số bộ lọc: active_zone_minutes Loại bản ghi: Khoảng thời gian Độ phân giải lưu trữ: 1 phút Hỗ trợ webhook Thiết bị tương thích Fitbit Air Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Inspire 2 Fitbit Inspire 3 Fitbit Ionic Fitbit Luxe Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4 Fitbit Versa Lite	list, reconcile, rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly
Cấp độ hoạt động dataType: activity-level tham số bộ lọc: activity_level Loại bản ghi: Khoảng thời gian Hỗ trợ webhook	list, reconcile	.activity_and_fitness.readonly .activity_and_fitness.writeonly
Độ cao dataType: altitude tham số bộ lọc: altitude Loại bản ghi: Khoảng thời gian Độ phân giải lưu trữ: 1 phút Hỗ trợ webhook Hỗ trợ số 0 thực	list, reconcile, rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly
Đường huyết dataType: blood-glucose tham số bộ lọc: blood_glucose Loại bản ghi: Mẫu Hỗ trợ webhook Hướng dẫn về các chỉ số sức khỏe	list, get, reconcile, rollup, dailyRollup	.health_metrics_and_measurements.readonly .health_metrics_and_measurements.writeonly
Lượng mỡ trong cơ thể dataType: body-fat tham số bộ lọc: body_fat Loại bản ghi: Mẫu Hỗ trợ webhook Thiết bị tương thích Fitbit Aria Fitbit Aria 2 Fitbit Aria Air	list, get, reconcile, rollup, dailyRollup, create, update, batchDelete	.health_metrics_and_measurements.readonly .health_metrics_and_measurements.writeonly
Lượng calo tiêu thụ theo vùng tần số tim dataType: calories-in-heart-rate-zone tham số bộ lọc: calories_in_heart_rate_zone Loại bản ghi: Khoảng thời gian Độ phân giải lưu trữ: 1 phút Hỗ trợ webhook	rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly
Nhiệt độ cơ thể dataType: core-body-temperature tham số bộ lọc: core_body_temperature Loại bản ghi: Mẫu Hướng dẫn về Android vitals	list, get, reconcile, rollup, dailyRollup	.health_metrics_and_measurements.readonly .health_metrics_and_measurements.writeonly
Sự thay đổi tần số tim hằng ngày dataType: daily-heart-rate-variability tham số bộ lọc: daily_heart_rate_variability Loại bản ghi: Hằng ngày Hỗ trợ webhook Hướng dẫn về chỉ số sức khỏe Hướng dẫn về giấc ngủ Thiết bị tương thích Fitbit Air Fitbit Alta HR Fitbit Blaze Fitbit Charge 2 Fitbit Charge 3 Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Inspire 2 Fitbit Inspire 3 Fitbit Inspire HR Fitbit Ionic Fitbit Luxe Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4	list, reconcile	.health_metrics_and_measurements.readonly .health_metrics_and_measurements.writeonly
Vùng tần số tim hằng ngày dataType: daily-heart-rate-zones tham số bộ lọc: daily_heart_rate_zones Loại bản ghi: Hằng ngày Hỗ trợ webhook Hướng dẫn về các chỉ số sức khỏe	list, reconcile	.health_metrics_and_measurements.readonly .health_metrics_and_measurements.writeonly
Độ bão hoà oxy hằng ngày dataType: daily-oxygen-saturation tham số bộ lọc: daily_oxygen_saturation Loại bản ghi: Hằng ngày Hỗ trợ webhook Hướng dẫn về chỉ số sức khỏe Hướng dẫn về giấc ngủ Thiết bị tương thích Fitbit Air Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Inspire 3 Fitbit Ionic Fitbit Luxe Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4	list, reconcile	.health_metrics_and_measurements.readonly .health_metrics_and_measurements.writeonly
Nhịp thở hằng ngày dataType: daily-respiratory-rate tham số bộ lọc: daily_respiratory_rate Loại bản ghi: Hằng ngày Hỗ trợ webhook Hướng dẫn về chỉ số sức khỏe Hướng dẫn về giấc ngủ Thiết bị tương thích Fitbit Air Fitbit Alta HR Fitbit Blaze Fitbit Charge 2 Fitbit Charge 3 Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Inspire 2 Fitbit Inspire 3 Fitbit Inspire HR Fitbit Ionic Fitbit Luxe Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4	list, reconcile	.health_metrics_and_measurements.readonly .health_metrics_and_measurements.writeonly
Tần số tim lúc nghỉ ngơi hằng ngày dataType: daily-resting-heart-rate tham số bộ lọc: daily_resting_heart_rate Loại bản ghi: Hằng ngày Hỗ trợ webhook Hướng dẫn về các chỉ số sức khỏe Thiết bị tương thích Fitbit Air Fitbit Alta HR Fitbit Blaze Fitbit Charge 2 Fitbit Charge 3 Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Inspire 2 Fitbit Inspire 3 Fitbit Inspire HR Fitbit Ionic Fitbit Luxe Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4 Fitbit Versa Lite	list, reconcile	.health_metrics_and_measurements.readonly .health_metrics_and_measurements.writeonly
Thông tin về nhiệt độ cơ thể trong lúc ngủ hằng ngày dataType: daily-sleep-temperature-derivations tham số bộ lọc: daily_sleep_temperature_derivations Loại bản ghi: Hằng ngày Hỗ trợ webhook Hướng dẫn về chỉ số sức khỏe Hướng dẫn về giấc ngủ Thiết bị tương thích Fitbit Air Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Inspire 2 Fitbit Inspire 3 Fitbit Inspire HR Fitbit Ionic Fitbit Luxe Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4	list, reconcile	.health_metrics_and_measurements.readonly .health_metrics_and_measurements.writeonly
Lượng oxy tối đa hằng ngày dataType: daily-vo2-max tham số bộ lọc: daily_vo2_max Loại bản ghi: Hằng ngày Thiết bị tương thích Fitbit Air Fitbit Alta HR Fitbit Blaze Fitbit Charge 2 Fitbit Charge 3 Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Inspire 2 Fitbit Inspire 3 Fitbit Ionic Fitbit Luxe Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4 Fitbit Versa Lite	list, reconcile	.activity_and_fitness.readonly .activity_and_fitness.writeonly
Khoảng cách dataType: distance tham số bộ lọc: distance Loại bản ghi: Khoảng thời gian Độ phân giải lưu trữ: 1 phút Hỗ trợ webhook Hỗ trợ số 0 thực Thiết bị tương thích Fitbit Air Fitbit Alta Fitbit Alta HR Fitbit Blaze Fitbit Charge 2 Fitbit Charge 3 Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Flex 2 Fitbit Inspire Fitbit Inspire 2 Fitbit Inspire 3 Fitbit Inspire HR Fitbit Ionic Fitbit Luxe Fitbit MobileTrack Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4 Fitbit Versa Lite	list, reconcile, rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly
Điện tâm đồ (ECG) dataType: electrocardiogram tham số bộ lọc: electrocardiogram Loại bản ghi: Phiên Hướng dẫn về Android vitals Thiết bị tương thích Fitbit Charge 5 Fitbit Charge 6 Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2	danh sách	.ecg.readonly
Tập thể dục dataType: exercise tham số bộ lọc: exercise Loại bản ghi: Phiên Hỗ trợ webhook Hướng dẫn về các bài tập Thiết bị tương thích Fitbit Air Fitbit Alta Fitbit Alta HR Fitbit Blaze Fitbit Charge 2 Fitbit Charge 3 Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Flex 2 Fitbit Inspire Fitbit Inspire 2 Fitbit Inspire 3 Fitbit Inspire HR Fitbit Ionic Fitbit Luxe Fitbit MobileTrack Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4 Fitbit Versa Lite	list, get, reconcile, create, update, batchDelete	.activity_and_fitness.readonly .activity_and_fitness.writeonly
Tầng dataType: floors tham số bộ lọc: floors Loại bản ghi: Khoảng thời gian Độ phân giải lưu trữ: 1 phút Hỗ trợ webhook Hỗ trợ số 0 thực	reconcile, rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly
Đồ ăn dataType: food tham số bộ lọc: food Loại bản ghi: Thực phẩm Hướng dẫn về dinh dưỡng	list, get	.nutrition.readonly .nutrition.writeonly
Đơn vị đo lường thực phẩm dataType: food-measurement-unit tham số bộ lọc: food_measurement_unit Loại bản ghi: Thực phẩm Hướng dẫn về dinh dưỡng Thiết bị tương thích Fitbit Air Fitbit Blaze Fitbit Charge 2 Fitbit Charge 3 Fitbit Charge 4 Fitbit Ionic Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4	list, get	.nutrition.readonly .nutrition.writeonly
Tần số tim dataType: heart-rate tham số bộ lọc: heart_rate Loại bản ghi: Mẫu Độ phân giải lưu trữ: 1 giây (1s) Hỗ trợ webhook Hướng dẫn về các chỉ số sức khỏe Thiết bị tương thích Fitbit Air Fitbit Alta HR Fitbit Blaze Fitbit Charge 2 Fitbit Charge 3 Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Inspire 2 Fitbit Inspire 3 Fitbit Inspire HR Fitbit Ionic Fitbit Luxe Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4 Fitbit Versa Lite	list, reconcile, rollup, dailyRollup	.health_metrics_and_measurements.readonly .health_metrics_and_measurements.writeonly
Sự thay đổi tần số tim dataType: heart-rate-variability tham số bộ lọc: heart_rate_variability Loại bản ghi: Mẫu Hỗ trợ webhook Hướng dẫn về chỉ số sức khỏe Hướng dẫn về giấc ngủ Thiết bị tương thích Fitbit Air Fitbit Alta Fitbit Alta HR Fitbit Blaze Fitbit Charge 2 Fitbit Charge 3 Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Flex 2 Fitbit Inspire Fitbit Inspire 2 Fitbit Inspire 3 Fitbit Inspire HR Fitbit Ionic Fitbit Luxe Fitbit MobileTrack Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4 Fitbit Versa Lite	list, reconcile	.health_metrics_and_measurements.readonly .health_metrics_and_measurements.writeonly
Chiều cao dataType: height tham số bộ lọc: height Loại bản ghi: Mẫu Hỗ trợ webhook	list, get, reconcile, create, update, batchDelete	.health_metrics_and_measurements.readonly .health_metrics_and_measurements.writeonly
Nhật ký về lượng nước uống dataType: hydration-log tham số bộ lọc: hydration_log Loại bản ghi: Phiên Hỗ trợ webhook	list, get, reconcile, rollup, dailyRollup, create, update, batchDelete	.nutrition.readonly .nutrition.writeonly
Thông báo về tình trạng nhịp tim không đều dataType: irregular-rhythm-notification tham số bộ lọc: irregular_rhythm_notification Loại bản ghi: Phiên Hướng dẫn về Android vitals	danh sách	.irn.readonly
Kỳ kinh nguyệt dataType: menstrual-period tham số bộ lọc: menstrual_period Loại bản ghi: Khoảng thời gian Hướng dẫn về sức khoẻ phụ nữ	create, update, batchDelete	.reproductive_health.writeonly
Tâm trạng dataType: moods tham số bộ lọc: moods Loại bản ghi: Mẫu Hướng dẫn về sức khoẻ phụ nữ	create, update, batchDelete	.mindfulness.writeonly
Nhật ký dinh dưỡng dataType: nutrition-log tham số bộ lọc: nutrition_log Loại bản ghi: Phiên Hỗ trợ webhook Hướng dẫn về dinh dưỡng Thiết bị tương thích Fitbit Air Fitbit Charge 3 Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Inspire 2 Fitbit Inspire 3 Fitbit Luxe Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4 Fitbit Versa Lite	list, get, reconcile, rollup, dailyRollup, create, update, batchDelete	.nutrition.readonly .nutrition.writeonly
Kiểm tra tình trạng rụng trứng dataType: ovulation-test tham số bộ lọc: ovulation_test Loại bản ghi: Mẫu Hướng dẫn về sức khoẻ phụ nữ	create, update, batchDelete	.reproductive_health.writeonly
Độ bão hoà oxy dataType: oxygen-saturation tham số bộ lọc: oxygen_saturation Loại bản ghi: Mẫu Hướng dẫn về Android vitals Hướng dẫn về giấc ngủ Thiết bị tương thích Fitbit Air Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Inspire 3 Fitbit Ionic Fitbit Luxe Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4	list, reconcile	.health_metrics_and_measurements.readonly .health_metrics_and_measurements.writeonly
Tóm tắt nhịp thở khi ngủ dataType: respiratory-rate-sleep-summary tham số bộ lọc: respiratory_rate_sleep_summary Loại bản ghi: Mẫu Hỗ trợ webhook Hướng dẫn về chỉ số sức khỏe Hướng dẫn về giấc ngủ Thiết bị tương thích Fitbit Air Fitbit Alta HR Fitbit Blaze Fitbit Charge 2 Fitbit Charge 3 Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Inspire 2 Fitbit Inspire 3 Fitbit Inspire HR Fitbit Ionic Fitbit Luxe Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4	list, reconcile	.health_metrics_and_measurements.readonly .health_metrics_and_measurements.writeonly
Lượng oxy tối đa khi chạy dataType: run-vo2-max tham số bộ lọc: run_vo2_max Loại bản ghi: Mẫu Hỗ trợ webhook Thiết bị tương thích Fitbit Air Fitbit Alta HR Fitbit Blaze Fitbit Charge 2 Fitbit Charge 3 Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Inspire 2 Fitbit Inspire 3 Fitbit Ionic Fitbit Luxe Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4 Fitbit Versa Lite	list, reconcile, rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly
Giai đoạn ít vận động dataType: sedentary-period tham số bộ lọc: sedentary_period Loại bản ghi: Khoảng thời gian Hỗ trợ webhook Thiết bị tương thích Fitbit Air Fitbit Alta Fitbit Alta HR Fitbit Blaze Fitbit Charge 2 Fitbit Charge 3 Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Flex 2 Fitbit Inspire Fitbit Inspire 2 Fitbit Inspire 3 Fitbit Inspire HR Fitbit Ionic Fitbit Luxe Fitbit MobileTrack Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4 Fitbit Versa Lite	list, reconcile, rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly
Ngủ dataType: sleep tham số bộ lọc: sleep Loại bản ghi: Phiên Hỗ trợ webhook Hướng dẫn về giấc ngủ Thiết bị tương thích Fitbit Air Fitbit Alta Fitbit Alta HR Fitbit Blaze Fitbit Charge 2 Fitbit Charge 3 Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Flex 2 Fitbit Inspire Fitbit Inspire 2 Fitbit Inspire 3 Fitbit Inspire HR Fitbit Ionic Fitbit Luxe Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4 Fitbit Versa Lite	list, get, reconcile, create, update, batchDelete	.sleep.readonly .sleep.writeonly
Các bước dataType: steps tham số bộ lọc: steps Loại bản ghi: Khoảng thời gian Độ phân giải lưu trữ: 1 phút Hỗ trợ Webhook Hỗ trợ số 0 thực Hướng dẫn các bước Thiết bị tương thích Fitbit Air Fitbit Alta Fitbit Alta HR Fitbit Blaze Fitbit Charge 2 Fitbit Charge 3 Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Flex 2 Fitbit Inspire Fitbit Inspire 2 Fitbit Inspire 3 Fitbit Inspire HR Fitbit Ionic Fitbit Luxe Fitbit MobileTrack Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4 Fitbit Versa Lite	list, reconcile, rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly
Dữ liệu về số lượt bơi dataType: swim-lengths-data tham số bộ lọc: swim_lengths_data Loại bản ghi: Khoảng thời gian Thiết bị tương thích Fitbit Air Fitbit Charge 3 Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Flex 2 Fitbit Inspire Fitbit Inspire 2 Fitbit Inspire 3 Fitbit Inspire HR Fitbit Ionic Fitbit Luxe Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4 Fitbit Versa Lite	list, reconcile, rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly
Triệu chứng dataType: symptoms tham số bộ lọc: symptoms Loại bản ghi: Mẫu Hướng dẫn về sức khoẻ phụ nữ	create, update, batchDelete	.logged_symptoms.writeonly
Thời gian ở vùng tần số tim dataType: time-in-heart-rate-zone tham số bộ lọc: time_in_heart_rate_zone Loại bản ghi: Khoảng thời gian Độ phân giải lưu trữ: 1 phút Hỗ trợ webhook	list, reconcile, rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly
Tổng lượng calo dataType: total-calories tham số bộ lọc: total_calories Loại bản ghi: Khoảng thời gian Độ phân giải lưu trữ: 1 phút Hỗ trợ giá trị 0 thực Hướng dẫn về calo và năng lượng Thiết bị tương thích Fitbit Air Fitbit Alta Fitbit Alta HR Fitbit Blaze Fitbit Charge 2 Fitbit Charge 3 Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Flex 2 Fitbit Inspire Fitbit Inspire 2 Fitbit Inspire 3 Fitbit Inspire HR Fitbit Ionic Fitbit Luxe Fitbit MobileTrack Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4 Fitbit Versa Lite	rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly
Tốc độ tiêu thụ oxy tối đa dataType: vo2-max tham số bộ lọc: vo2_max Loại bản ghi: Mẫu Thiết bị tương thích Fitbit Air Fitbit Alta HR Fitbit Blaze Fitbit Charge 2 Fitbit Charge 3 Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Inspire 2 Fitbit Inspire 3 Fitbit Ionic Fitbit Luxe Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4 Fitbit Versa Lite	list, reconcile	.activity_and_fitness.readonly .activity_and_fitness.writeonly
Trọng lượng dataType: weight tham số bộ lọc: weight Loại bản ghi: Mẫu Hỗ trợ webhook Thiết bị tương thích Fitbit Aria Fitbit Aria 2 Fitbit Aria Air	list, get, reconcile, rollup, dailyRollup, create, update, batchDelete	.health_metrics_and_measurements.readonly .health_metrics_and_measurements.writeonly

Điều kiện ràng buộc truy vấn

Khi truy vấn các điểm dữ liệu, dữ liệu tổng hợp hoặc dữ liệu tổng hợp hằng ngày từ API, hãy lưu ý đến các ràng buộc sau:

• Yêu cầu về bộ lọc: Một số loại dữ liệu phái sinh chỉ đọc (chẳng hạn như total-calories) yêu cầu bộ lọc chỉ định thời gian bắt đầu khoảng thời gian (bằng thời gian thực hoặc thời gian dân sự).
• Giới hạn về phạm vi truy vấn: Các điểm cuối tổng hợp dữ liệu tổng hợp và tổng hợp dữ liệu hằng ngày sẽ thực thi giới hạn tối đa về phạm vi truy vấn dựa trên loại dữ liệu:
  • Phạm vi truy vấn tối đa là 14 ngày đối với calories-in-heart-rate-zone, heart-rate, active-minutes và total-calories.
  • Phạm vi truy vấn tối đa là 90 ngày cho tất cả các loại dữ liệu khác.
• Kích thước cửa sổ tổng hợp: Khi gọi điểm cuối rollUp, thời lượng windowSize phải ít nhất là 1 giây ("1s"). Thời lượng dưới 1 giây sẽ bị từ chối bằng INVALID_ARGUMENT. Ngoài ra, hãy chọn windowSize bằng hoặc lớn hơn độ phân giải bộ nhớ cơ bản của loại dữ liệu (chẳng hạn như "60s" cho các loại dữ liệu có khoảng thời gian 1 phút như steps và distance) để tránh phân phối không đồng đều trên các khoảng thời gian phụ. Để biết thông tin chi tiết, hãy xem phần Kích thước cửa sổ tổng hợp và độ phân giải bộ nhớ cơ bản.

Loại dữ liệu hằng ngày so với loại dữ liệu theo khoảng thời gian

Đối với một số chỉ số sinh lý nhất định, chẳng hạn như Sự thay đổi tần số tim (HRV) hoặc Độ bão hoà oxy (SpO2), Google Health API cung cấp 2 loại dữ liệu riêng biệt: phiên bản Hằng ngày và phiên bản Khoảng thời gian. Việc hiểu rõ sự khác biệt giữa hai chỉ số này là mấu chốt để chọn chỉ số phù hợp cho trường hợp sử dụng của bạn:

• Hằng ngày: Một bản tóm tắt duy nhất, được tổng hợp trước cho cả ngày. Sử dụng thông tin này cho các xu hướng tổng quan và trang tổng quan hằng ngày để tiết kiệm thời gian xử lý.

• Khoảng thời gian: Các phép đo chi tiết, có độ phân giải cao được thực hiện trong suốt cả ngày. Sử dụng chỉ số này để lập biểu đồ biến động trong ngày hoặc thực hiện phân tích chuyên sâu theo từng giờ.

Phạm vi cung cấp dữ liệu

Dữ liệu của người dùng chỉ được cập nhật sau khi họ đồng bộ hoá thiết bị theo dõi hoạt động hoặc nhập dữ liệu mới theo cách thủ công vào ứng dụng di động hoặc ứng dụng web Fitbit. Thiết bị Fitbit và ứng dụng di động Fitbit có thể tự động đồng bộ hoá sau mỗi 15 phút khi ứng dụng Fitbit đang mở trên thiết bị di động và hai thiết bị này có kết nối dữ liệu đang hoạt động và nằm trong phạm vi Bluetooth. Nếu người dùng đang theo dõi hoạt động bằng MobileTrack, thì MobileTrack sẽ đồng bộ hoá mỗi giờ miễn là ứng dụng đang mở.

Truy vấn dữ liệu trước đây

Một trong những lợi ích cốt lõi của Google Health API là khả năng theo dõi hiệu suất của người dùng và giám sát các chỉ số quan trọng về sức khoẻ của họ trong thời gian dài. Bạn có thể truy vấn dữ liệu của người dùng từ thời điểm dữ liệu được ghi lại; API không áp đặt bất kỳ giới hạn hoặc hạn chế nào về lượng dữ liệu trong quá khứ mà ứng dụng của bạn có thể sử dụng.

Tuy nhiên, việc truy vấn dữ liệu cũ vẫn phải chịu sự điều chỉnh của giới hạn tốc độ tiêu chuẩn. Để quản lý độ ổn định của hệ thống và ngăn chặn tải trọng quá mức, Google Health API sử dụng tính năng phân trang tự động với kích thước trang dành riêng cho từng điểm cuối. Hãy lưu ý những ranh giới và hành vi sau:

• Phân trang tự động: Nếu bạn truy vấn một khoảng thời gian dài của dữ liệu, API sẽ chỉ trả về trang kết quả đầu tiên (tối đa là giới hạn kích thước trang) cho điểm cuối đó, cùng với một nextPageToken. Bạn phải sử dụng nextPageToken để yêu cầu các trang tiếp theo.
• Kích thước trang thay đổi: Giới hạn tối đa phụ thuộc vào điểm cuối và loại dữ liệu. Đối với hầu hết các loại dữ liệu, kích thước trang được giới hạn tối đa là 10.000. Tuy nhiên, đối với một số kiểu dữ liệu như exercise và sleep, kích thước trang mặc định và tối đa được giới hạn ở mức 25. Ví dụ: nếu một ứng dụng yêu cầu tất cả dữ liệu giấc ngủ trong 10 năm qua, thì API vẫn chỉ trả về 25 phiên ngủ trên trang đầu tiên.
• Các quy định hạn chế về phạm vi ngày tổng hợp: Đối với các điểm cuối tổng hợp và tổng hợp dữ liệu (chẳng hạn như rollUp và dailyRollUp), phạm vi ngày truy vấn bị hạn chế dựa trên kiểu dữ liệu:
  • Phạm vi tối đa là 14 ngày đối với calories-in-heart-rate-zone, heart-rate, active-minutes và total-calories.
  • Phạm vi tối đa là 90 ngày cho tất cả các loại dữ liệu tổng hợp khác.

Tuỳ thuộc vào lượng dữ liệu cũ mà ứng dụng của bạn cần, việc truy xuất toàn bộ tập dữ liệu sẽ yêu cầu phân trang tuần tự qua các trang. Hãy lưu ý điều này khi thiết kế quy trình đồng bộ hoá dữ liệu của ứng dụng.

Để đảm bảo hiệu suất tối ưu và tránh lỗi API, hãy làm theo các nguyên tắc sau khi truy vấn dữ liệu cũ:

Đồng bộ hoá dữ liệu theo giai đoạn (tải nóng so với tải lạnh)

• Tải "nóng" ban đầu: Chỉ tìm nạp và hiển thị dữ liệu trong 7–14 ngày gần đây nhất trong trình tự tải chính. Điều này đảm bảo người dùng thấy dữ liệu ngay lập tức mà không cần chờ các truy vấn chạy trong thời gian dài.
• Tải "lạnh" trong nền: Uỷ quyền truy xuất dữ liệu cũ trong quá khứ cho một hàng đợi không đồng bộ, có mức độ ưu tiên thấp hơn hoặc quy trình trong nền sau khi giao diện người dùng chính được kết xuất.

Phân đoạn truy vấn để tổng hợp

• Vì các điểm cuối tổng hợp và tổng hợp hằng ngày áp dụng giới hạn phạm vi ngày tối đa (14 hoặc 90 ngày tuỳ thuộc vào loại dữ liệu), nên bạn phải chia các truy vấn tổng hợp dữ liệu cũ có quy mô lớn thành các khoảng thời gian nhỏ hơn, tuần tự trong các giới hạn này.
• Xử lý hàng loạt hoặc theo trình tự các truy vấn phụ này một cách an toàn để tuân thủ giới hạn về mức độ đồng thời và duy trì các chỉ báo tiến trình ổn định trên giao diện người dùng.

Tận dụng các bản tổng hợp được tổng hợp trước

Tái cấu trúc trang tổng quan và biểu đồ xu hướng để sử dụng các điểm cuối tóm tắt được tổng hợp trước (chẳng hạn như DailyRollUpDataPoints). Điều này sẽ giảm đáng kể chi phí tính toán ở phần phụ trợ và thời gian truyền mạng cho máy khách.

Xử lý lỗi linh hoạt (thử lại thông minh)

• Triển khai quy trình xử lý thời gian đợi luỹ thừa nghiêm ngặt khi gặp phải giới hạn về tốc độ (429 Too Many Requests) và thời gian chờ của cổng máy chủ (504 Gateway Timeout). Đừng bao giờ thử lại ngay lập tức các tải trọng lớn không thành công. Việc thử lại ngay lập tức sẽ làm tăng tình trạng tắc nghẽn phụ trợ và làm trầm trọng thêm tình trạng suy giảm hệ thống.

Cảnh báo: Nếu không tuân thủ những nguyên tắc này, bạn có thể gặp phải hành vi và lỗi không mong muốn.

Quyền truy cập của bên thứ ba

Các thiết bị Fitbit không thể giao tiếp trực tiếp với các ứng dụng hoặc dịch vụ bên thứ ba. Những thiết bị này được thiết kế để giao tiếp và đồng bộ hoá riêng với ứng dụng Fitbit.

Thiết bị tự động đồng bộ hoá dữ liệu trong suốt cả ngày, bất cứ khi nào ứng dụng Fitbit mở hoặc cứ 15 phút một lần nếu Bluetooth đang hoạt động và ứng dụng đang chạy ở chế độ nền. Sau khi quá trình đồng bộ hoá này hoàn tất, dữ liệu sẽ có sẵn cho các dịch vụ bên thứ ba thông qua Google Health API.

Tiêu chuẩn về khoảng cách

Khoảng cách tập thể dục, chẳng hạn như elevationGainMillimeters, được đo bằng milimet làm đơn vị tiêu chuẩn vì những lý do sau:

1. Duy trì độ chính xác của dữ liệu: Lý do quan trọng nhất để sử dụng đơn vị milimet là đảm bảo chúng tôi không mất độ chính xác nào trong dữ liệu mà chúng tôi đọc và cung cấp. Việc sử dụng một đơn vị nhỏ như milimet cho phép chúng tôi biểu thị các phép đo với độ chính xác cao.
2. Chuẩn hoá: Milimet là đơn vị chuẩn hoá được thiết kế trên các dịch vụ của chúng tôi. Tính nhất quán này giúp đảm bảo trải nghiệm đồng nhất cho các nhà phát triển tương tác với nhiều phần của API.
3. Hỗ trợ hệ thống đo lường trên diện rộng: Việc sử dụng một đơn vị cơ bản như milimet giúp nhà phát triển dễ dàng chuyển đổi sang bất kỳ đơn vị nào khác mà họ chọn, bất kể họ đang làm việc với hệ thống đo lường bằng mét, hệ thống đo lường của Anh hoặc các hệ thống đo lường khác.

Thời lượng ban ngày thay đổi

API Health ưu tiên thời gian của người dùng để tính đến độ dài ngày thay đổi do Giờ tiết kiệm ánh sáng ban ngày hoặc việc đi lại. Mỗi điểm dữ liệu được lưu trữ cùng với cả dấu thời gian UTC thực tế và độ lệch UTC đang hoạt động tại thời điểm xảy ra sự kiện. Điều này cho phép hệ thống:

• Ánh xạ sự kiện với một thời điểm chính xác trong thực tế.
• Điều chỉnh thời gian theo bối cảnh địa phương của người dùng để tổng hợp.

Giờ tiết kiệm ánh sáng ban ngày

Khi quy ước giờ mùa hè diễn ra, việc "chuyển về" sẽ dẫn đến một ngày dương lịch có 25 giờ và dữ liệu tổng hợp cho ngày đó sẽ chứa dữ liệu của 25 giờ. Việc "chuyển sang giờ mùa hè" dẫn đến một ngày dương lịch kéo dài 23 giờ, trong đó thời gian được chuyển về Giờ chuẩn.

Du lịch

Việc di chuyển qua các múi giờ có thể gây ra nhiều biến thể đáng kể hơn về thời lượng thực tế của một ngày dương lịch.

Sử dụng điểm cuối dailyRollUp để điều chỉnh sự khác biệt về múi giờ. Tính năng này tự động phân bổ dữ liệu cho ngày trên lịch mà dữ liệu được ghi lại theo giờ địa phương của người dùng, nhờ đó "kết hợp" ngày lại với nhau bất kể có sự thay đổi về múi giờ.