API Google Fit, bao gồm cả API Google Fit REST, sẽ ngừng hoạt động sau ngày 30 tháng 6 năm 2025. Kể từ ngày 1 tháng 5 năm 2024, nhà phát triển không thể đăng ký sử dụng các API này.
Google Fit có các loại dữ liệu sức khoẻ dành cho các phép đo liên quan đến việc quản lý
sức khoẻ tổng thể (trái ngược với thể chất).
Danh sách loại dữ liệu
Bạn có thể tìm hiểu thêm về các loại dữ liệu sức khoẻ và các trường của chúng trong tài liệu tham khảo về Android. Các trường có đơn vị enum có danh sách giá trị được chấp nhận để chọn. Chỉ sử dụng một trong các giá trị được phép để đọc và ghi dữ liệu thành công.
Đường huyết
Loại dữ liệu này ghi lại nồng độ gluco trong máu. Mỗi dữ liệu
biểu thị một chỉ số đo đường huyết tức thời. Tìm hiểu thêm về cách ghi dữ liệu đường huyết.
Nồng độ glucose trong máu tính bằng mmol/L, trong đó 1 mmol/L là 18 mg/dL.
mối quan hệ thời gian với bữa ăn (int – enum) (trường không bắt buộc)
Thời điểm đo so với thời điểm người dùng ăn.
Giá trị được chấp nhận
"intVal": 1 // Reading wasn't taken before or after a meal
"intVal": 2 // Reading was taken during a fasting period
"intVal": 3 // Reading was taken before a meal
"intVal": 4 // Reading was taken after a meal
loại bữa ăn (int – enum) (trường không bắt buộc)
Loại bữa ăn mà người dùng đã ăn xung quanh khi hệ thống lấy chỉ số.
mối quan hệ tạm thời với giấc ngủ (int—enum) (trường không bắt buộc)
Khi chỉ số đo được so sánh với thời điểm người dùng ngủ.
Giá trị được chấp nhận
"intVal": 1 // User was fully awake
"intVal": 2 // Before the user fell asleep
"intVal": 3 // After the user woke up
"intVal": 4 // While the user was still sleeping
nguồn mẫu (int— enum) (trường không bắt buộc)
Loại chất lỏng trong cơ thể dùng để đo lượng glucose trong máu.
Nồng độ glucose trong máu tính bằng mmol/L, trong đó 1 mmol/L là 18 mg/dL.
FIELD_TEMPORAL_RELATION_TO_MEAL (int – enum) (trường không bắt buộc)
Thời điểm đo lường dữ liệu so với thời điểm người dùng ăn.
Giá trị được chấp nhận
FIELD_TEMPORAL_RELATION_TO_MEAL_GENERAL // Reading wasn't taken before or after a meal
FIELD_TEMPORAL_RELATION_TO_MEAL_FASTING // Reading was taken during a fasting period
FIELD_TEMPORAL_RELATION_TO_MEAL_BEFORE_MEAL // Reading was taken before a meal
FIELD_TEMPORAL_RELATION_TO_MEAL_AFTER_MEAL // Reading was taken after a meal
FIELD_MEAL_TYPE (int – enum) (trường không bắt buộc)
Loại bữa ăn mà người dùng đã ăn vào khoảng thời gian đo.
FIELD_TEMPORAL_RELATION_TO_SLEEP (int – enum) (trường không bắt buộc)
Khi chỉ số đo được so sánh với thời điểm người dùng ngủ.
Giá trị được chấp nhận
TEMPORAL_RELATION_TO_SLEEP_FULLY_AWAKE // User was fully awake.
TEMPORAL_RELATION_TO_SLEEP_BEFORE_SLEEP // Before the user fell asleep.
TEMPORAL_RELATION_TO_SLEEP_ON_WAKING // After the user woke up.
TEMPORAL_RELATION_TO_SLEEP_DURING_SLEEP // While the user was still sleeping.
FIELD_BLOOD_GLUCOSE_SPECIMEN_SOURCE (int—enum) (trường không bắt buộc)
Loại dữ liệu này ghi lại huyết áp của người dùng. Mỗi điểm dữ liệu đại diện cho
một chỉ số đo huyết áp tức thời. Tìm hiểu thêm về cách viết máu
dữ liệu về áp suất.
vị trí cơ thể (int – enum) (trường không bắt buộc)
Vị trí cơ thể của người dùng khi đo.
Giá trị được chấp nhận
"intVal": 1 // Standing up
"intVal": 2 // Sitting down
"intVal": 3 // Lying down
"intVal": 4 // Reclining
vị trí đo lường (int—enum) (trường không bắt buộc)
Nhóm thử nghiệm nào và một phần của nhóm thử nghiệm nào đã được đo.
Giá trị được chấp nhận
"intVal": 1 // Left wrist
"intVal": 2 // Right wrist
"intVal": 3 // Left upper arm
"intVal": 4 // Right upper arm
Android
Tên
com.google.blood_pressure
Đối tượng loại dữ liệu
TYPE_BLOOD_PRESSURE
Trường (định dạng – đơn vị)
FIELD_BLOOD_PRESSURE_SYSTOLIC (float—mmHg)
Đo huyết áp tâm thu.
FIELD_BLOOD_PRESSURE_DIASTOLIC (float—mmHg)
Giá trị đo huyết áp tâm trương.
FIELD_BODY_POSITION (int – enum) (trường không bắt buộc)
Vị trí cơ thể của người dùng khi đo.
Giá trị được chấp nhận
BODY_POSITION_STANDING // Standing up
BODY_POSITION_SITTING // Sitting down
BODY_POSITION_LYING_DOWN // Lying down
BODY_POSITION_SEMI_RECUMBENT // Reclining
FIELD_BLOOD_PRESSURE_MEASUREMENT_LOCATION (int – enum) (trường không bắt buộc)
Cánh tay và phần cánh tay được đo.
Giá trị được chấp nhận
BLOOD_PRESSURE_MEASUREMENT_LOCATION_LEFT_WRIST // Left wrist
BLOOD_PRESSURE_MEASUREMENT_LOCATION_RIGHT_WRIST // Right wrist
BLOOD_PRESSURE_MEASUREMENT_LOCATION_LEFT_UPPER_ARM // Left upper arm
BLOOD_PRESSURE_MEASUREMENT_LOCATION_RIGHT_UPPER_ARM // Right upper arm
Tỷ lệ mỡ trong cơ thể
Loại dữ liệu này thu thập tỷ lệ phần trăm mỡ trong cơ thể của một người dùng. Mỗi điểm dữ liệu đại diện cho tổng lượng mỡ trong cơ thể của một người dưới dạng tỷ lệ phần trăm tổng khối lượng cơ thể.
Loại dữ liệu này ghi lại nội dung mô tả về chất nhầy cổ tử cung. Mỗi điểm dữ liệu đại diện cho một nội dung mô tả tự đánh giá về chất nhầy cổ tử cung của người dùng. Tất cả các trường đều không bắt buộc và có thể được dùng để mô tả hình dạng và cảm nhận về chất nhầy cổ tử cung cũng như số lượng.
kết cấu của chất nhầy cổ tử cung (int—enum) (trường không bắt buộc)
Độ đặc hoặc kết cấu của chất nhầy cổ tử cung của người dùng.
Giá trị được chấp nhận
"intVal": 1 // Dry, little or no mucus
"intVal": 2 // Sticky
"intVal": 3 // Creamy
"intVal": 4 // Watery
"intVal": 5 // Clear and stretchy like egg white
lượng dịch nhầy cổ tử cung (int – enum) (trường không bắt buộc)
Lượng chất nhầy cổ tử cung mà người dùng quan sát được.
Giá trị được chấp nhận
"intVal": 1 // Light
"intVal": 2 // Medium
"intVal": 3 // Heavy
Android
Tên
com.google.cervical_mucus
Đối tượng loại dữ liệu
TYPE_CERVICAL_MUCUS
Trường (định dạng – đơn vị)
FIELD_CERVICAL_MUCUS_TEXTURE (int—enum) (trường không bắt buộc)
Độ đặc hoặc kết cấu của chất nhầy cổ tử cung của người dùng.
Giá trị được chấp nhận
CERVICAL_MUCUS_TEXTURE_DRY // Dry, little or no mucus
CERVICAL_MUCUS_TEXTURE_STICKY // Sticky
CERVICAL_MUCUS_TEXTURE_CREAMY // Creamy
CERVICAL_MUCUS_TEXTURE_WATERY // Watery
CERVICAL_MUCUS_TEXTURE_EGG_WHITE // Clear and stretchy
FIELD_CERVICAL_MUCUS_AMOUNT (int—enum) (trường không bắt buộc)
Lượng chất nhầy cổ tử cung mà người dùng quan sát được.
Trong loại dữ liệu này, mỗi điểm dữ liệu biểu thị một báo cáo về cổ tử cung của người dùng. Tất cả
là tùy chọn và có thể được sử dụng để thêm mô tả về vị trí,
sự giãn nở và độ cứng của cổ tử cung.
Loại dữ liệu này ghi lại nhịp tim của người dùng theo số nhịp/phút. Vì mỗi
điểm dữ liệu biểu thị giá trị đo tức thời của nhịp tim, chỉ thời gian kết thúc
. Dấu thời gian này sẽ được dùng làm dấu thời gian cho kết quả đo.
Loại dữ liệu này ghi lại chiều cao của người dùng tính bằng mét. Vì mỗi điểm dữ liệu
biểu thị chiều cao của người dùng tại thời điểm đọc, chỉ thời gian kết thúc
. Dấu thời gian này sẽ được dùng làm dấu thời gian cho kết quả đo.
Loại dữ liệu này mô tả mức kinh nguyệt của người dùng
(đốm, sáng, trung bình hoặc đậm). Mỗi điểm dữ liệu đại diện cho một phần mô tả về
lượng máu kinh của người dùng.
Loại dữ liệu này ghi lại lượng oxy lưu thông trong máu, được đo bằng tỷ lệ phần trăm hemoglobin bão hoà oxy. Mỗi điểm dữ liệu thể hiện một kết quả đo độ bão hoà oxy trong máu tại thời điểm đo.
Các trường không bắt buộc cũng cho phép bạn thêm thông tin về mọi sản phẩm oxy bổ sung nếu
được quản lý.
Chỉ số độ bão hoà oxy trong máu dưới dạng phần trăm.
Phạm vi hợp lệ: 0 đến 100%
lượng oxy bổ sung (float – lít/phút)
Tốc độ oxy bổ sung được cung cấp cho một người dùng tính bằng lít/phút.
Đặt thành 0 nếu không cung cấp oxy bổ sung và người dùng chỉ hít thở không khí trong phòng.
chế độ quản trị liệu pháp oxy (int—enum) (trường không bắt buộc)
Cách thực hiện liệu pháp oxy.
Có thể không có hoặc 1 nếu được dùng bằng ống thông mũi.
hệ thống bão hoà oxy (int – enum) (trường không bắt buộc)
Nơi đo độ bão hoà oxy.
Có thể không có hoặc 1 nếu được đo bằng các mao dẫn ngoại vi.
phương pháp đo độ bão hoà oxy (int—enum) (trường không bắt buộc)
Cách đo độ bão hoà oxy.
Có thể không có hoặc 1 nếu đo bằng máy đo nồng độ oxy xung.
Android
Tên
com.google.oxygen_saturation
Đối tượng loại dữ liệu
TYPE_OXYGEN_SATURATION
Trường (định dạng – đơn vị)
FIELD_OXYGEN_SATURATION (float – phần trăm)
Chỉ số độ bão hoà oxy trong máu dưới dạng phần trăm.
Tốc độ cung cấp oxy bổ sung cho người dùng tính bằng lít/phút.
Giá trị 0 cho biết không có oxy bổ sung và người dùng chỉ hít thở không khí trong phòng.
FIELD_OXYGEN_THERAPY_ADMINISTRATION_MODE (int – enum) (trường không bắt buộc)
Cách sử dụng liệu pháp oxy.
Có thể không có hoặc 1 nếu được dùng bằng ống thông mũi.
FIELD_OXYGEN_SATURATION_SYSTEM (int—enum) (trường không bắt buộc)
Nơi đo độ bão hoà oxy.
Có thể không có hoặc 1 nếu được đo trong các mao mạch ngoại vi.
FIELD_OXYGEN_SATURATION_MEASUREMENT_METHOD (int – enum) (trường không bắt buộc)
Cách đo độ bão hoà oxy.
Có thể không có hoặc là 1 nếu được đo bằng máy đo nồng độ oxy trong máu.
Ngủ
Loại dữ liệu này ghi lại thời lượng và kiểu ngủ của người dùng. Mỗi điểm dữ liệu đại diện cho một khoảng thời gian của một giai đoạn ngủ.
Thời gian bắt đầu của điểm dữ liệu thể hiện thời điểm bắt đầu giai đoạn ngủ và luôn cần được đưa vào. Dấu thời gian cho biết thời điểm kết thúc giấc ngủ
giai đoạn đầu. Khoảng thời gian không cần phải liên tục nhưng không được chồng chéo.
Giá trị đại diện cho các giai đoạn và loại giấc ngủ khác nhau.
Giá trị được chấp nhận
"intVal": 0 // Unspecified or unknown if user is sleeping.
"intVal": 1 // Awake; user is awake.
"intVal": 2 // Sleeping; generic or non-granular sleep description.
"intVal": 3 // Out of bed; user gets out of bed in the middle of a sleep session.
"intVal": 4 // Light sleep; user is in a light sleep cycle.
"intVal": 5 // Deep sleep; user is in a deep sleep cycle.
"intVal": 6 // REM sleep; user is in a REM sleep cyle.
Android
Tên
com.google.sleep.segment
Đối tượng loại dữ liệu
TYPE_SLEEP_SEGMENT
Trường (định dạng – đơn vị)
FIELD_SLEEP_SEGMENT_TYPE (int—enum)
Giá trị đại diện cho các giai đoạn và loại giấc ngủ khác nhau.
Giá trị được chấp nhận
SLEEP_SEGMENT_TYPE_UNSPECIFIED // Unspecified or unknown if user is sleeping.
AWAKE // Awake; user is awake.
SLEEP // Sleeping; generic or non-granular sleep description.
OUT_OF_BED // Out of bed; user gets out of bed in the middle of a sleep session.
SLEEP_LIGHT // Light sleep; user is in a light sleep cycle.
SLEEP_DEEP // Deep sleep; user is in a deep sleep cycle.
SLEEP_REM // REM sleep; user is in a REM sleep cyle.
Chảy máu âm đạo
Loại dữ liệu này ghi lại việc người dùng có bị xuất huyết (chảy máu giữa kỳ kinh nguyệt hay không). Mỗi điểm dữ liệu đại diện cho một thực thể phát hiện, vì vậy, mỗi điểm
phải có dấu thời gian và trường lần xuất hiện phải được đặt thành
một.
Loại dữ liệu này ghi lại cân nặng của người dùng tính theo kilogam. Vì mỗi điểm dữ liệu
thể hiện trọng số của người dùng tại thời điểm đọc, chỉ thời gian kết thúc
. Dấu thời gian này sẽ được dùng làm dấu thời gian cho kết quả đo.
[null,null,["Cập nhật lần gần đây nhất: 2024-10-15 UTC."],[[["This documentation details various health data types available in Google Fit, including blood glucose, blood pressure, body fat percentage, body temperature, cervical mucus, cervical position, and heart rate, categorized for health management purposes."],["Each data type is described with its REST and Android specific details, including data type name, required OAuth permission scopes, and data fields with format and units."],["Additional health data types accessible through the Google Fit API include heart rate, height, menstruation, ovulation test results, oxygen saturation, sleep, vaginal spotting, and weight, also with REST and Android integration details."],["Apps must comply with Google's API User Data Policy, the Google Fit Developer and User Data Policy, and have a verified consent screen to access user health data."]]],[]]