Google Health API cung cấp các loại dữ liệu theo dõi lượng calo và mức tiêu hao năng lượng của người dùng. Các loại dữ liệu này đo lường nhiều khía cạnh của quá trình đốt cháy năng lượng, bao gồm tổng mức tiêu hao, mức đốt cháy khi vận động và tỷ lệ trao đổi chất khi nghỉ ngơi (cơ bản).
Hãy tìm hiểu sự khác biệt giữa các loại dữ liệu này để xác định chỉ số nào phù hợp với ứng dụng của bạn.
Các loại dữ liệu được hỗ trợ
API này hỗ trợ các loại dữ liệu sau đây để đo lường lượng calo và mức tiêu hao năng lượng:
Loại dữ liệudataType
filter tham số |
Bản ghi loại |
Các thao tác có sẵn |
Phạm vi | Hỗ trợ webhook |
Hỗ trợ giá trị 0 thực |
|---|---|---|---|---|---|
Năng lượng hoạt động đã đốt cháy
active-energy-burnedactive_energy_burned
|
Khoảng thời gian | list, reconcile, rollup, dailyRollup | activity_and_fitness | ||
Năng lượng cơ bản đã đốt cháy
basal-energy-burnedbasal_energy_burned
|
Khoảng thời gian | list, reconcile | activity_and_fitness | ||
Tỷ lệ trao đổi chất cơ bản
basal-metabolic-ratebasal_metabolic_rate
|
Mẫu | list, reconcile | nutrition |
Các phần sau đây cung cấp thông tin chi tiết về kỹ thuật cho từng loại dữ liệu, bao gồm cả ví dụ về cách biểu diễn REST và các ràng buộc cụ thể về việc tích hợp.
Tổng lượng calo
Tổng lượng calo là một loại dữ liệu chỉ đọc được lấy ra, theo dõi tất cả năng lượng mà người dùng tiêu hao, bao gồm cả quá trình trao đổi chất cơ bản và năng lượng hoạt động, được đo bằng kilocalories (kcal). Giá trị này được tính dựa trên mức tiêu hao năng lượng hoạt động và tỷ lệ trao đổi chất cơ bản của người dùng.
Năng lượng hoạt động đã đốt cháy
Năng lượng hoạt động đã đốt cháy biểu thị năng lượng mà người dùng đốt cháy trong các khoảng thời gian hoạt động, không bao gồm mức tiêu hao năng lượng cơ bản của họ, được đo bằng kilocalories (kcal).
Ví dụ về cách biểu diễn REST
{
"startTime": "2026-04-20T08:00:00Z",
"startUtcOffset": "0s",
"endTime": "2026-04-20T08:30:00Z",
"endUtcOffset": "0s",
"dataSource": { ... },
"kcal": 150.0
}
Năng lượng cơ bản đã đốt cháy
Năng lượng cơ bản đã đốt cháy biểu thị lượng calo đã đốt cháy do quá trình trao đổi chất khi nghỉ ngơi của người dùng trong các khoảng thời gian, được đo bằng kilocalories (kcal).
Lưu ý: Bạn không thể sử dụng các thao tác tổng hợp và tổng hợp hằng ngày cho loại dữ liệu này. Để lấy các giá trị năng lượng cơ bản hằng ngày, hãy sử dụng loại dữ liệu Tỷ lệ trao đổi chất cơ bản.
Tỷ lệ trao đổi chất cơ bản
Tỷ lệ trao đổi chất cơ bản đo lường năng lượng mà cơ thể tiêu hao ở trạng thái bình thường, khi nghỉ ngơi, được đo bằng kilocalories mỗi ngày (kcal/day). Vì tỷ lệ này dao động theo các thay đổi về thể chất (chẳng hạn như cân nặng) theo thời gian, nên API sẽ ghi lại BMR dưới dạng chuỗi thời gian của các mẫu tỷ lệ.
Nhà phát triển có thể coi trường rateKcalPerDay trong mẫu basal-metabolic-rate là đối tượng tương ứng hằng ngày với thông tin tổng quan hằng ngày của năng lượng đốt cháy cơ bản.
Ví dụ về cách biểu diễn REST
{
"date": {
"year": 2026,
"month": 4,
"day": 20
},
"dataSource": { ... },
"rateKcalPerDay": 1650.0
}
Nguyên tắc
Khi tích hợp các chỉ số về calo và năng lượng trong ứng dụng, hãy làm theo các nguyên tắc sau:
- Tổng quan hằng ngày: Để hiển thị tổng mức tiêu hao calo hằng ngày, hãy yêu cầu tổng hợp hằng ngày của loại dữ liệu
total-calories. - Mức tiêu hao chỉ dành cho hoạt động: Để theo dõi lượng calo đã đốt cháy trong một bài tập cụ thể hoặc trong suốt cả ngày, không bao gồm tỷ lệ trao đổi chất khi nghỉ ngơi, hãy truy vấn
active-energy-burned. - Chỉ số cơ bản: Để theo dõi tỷ lệ trao đổi chất khi nghỉ ngơi hoặc xu hướng trao đổi chất cơ bản, hãy truy vấn
basal-metabolic-rateđể lấy các giá trị BMR. Hãy coi các mẫu BMR là giá trị cơ sở hằng ngày cho mức tiêu thụ năng lượng khi nghỉ ngơi của người dùng.