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 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 thụ, mức tiêu thụ khi vận động và tỷ lệ trao đổi chất lúc nghỉ ngơi (cơ bản).
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ố 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 calo và mức tiêu hao năng lượng:
Loại dữ liệudataType
filter tham số |
Loại bản ghi |
Các thao tác có thể thực hiện |
Phạm vi | Hỗ trợ webhook |
Hỗ trợ số 0 thực |
|---|---|---|---|---|---|
Năng lượng đốt cháy khi hoạt động
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 | dinh dưỡng |
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ề biểu thị 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 phái sinh chỉ đọc, 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 toán 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.
Lưu ý: Các truy vấn cho kiểu dữ liệu
total-caloriesphải bao gồm một bộ lọc khoảng thời gian (chẳng hạn nhưtotal_calories.interval.start_timehoặctotal_calories.interval.civil_start_time). Phạm vi tối đa cho các truy vấn này là 14 ngày.
Ví dụ về truy vấn
Để truy vấn loại dữ liệu total-calories, hãy gửi yêu cầu đến điểm cuối list bằng bộ lọc khoảng thời gian:
Yêu cầu
GET https://health.googleapis.com/v4/users/me/dataTypes/total-calories/dataPoints?filter=total_calories.interval.start_time >= "2026-04-20T00:00:00Z" AND total_calories.interval.start_time < "2026-04-21T00:00:00Z" Authorization: Bearer access-token Accept: application/json
Năng lượng hoạt động đã đốt cháy
Năng lượng hoạt động đã đốt cháy là năng lượng mà người dùng đốt cháy trong thời gian hoạt động, không bao gồm mức tiêu hao năng lượng cơ bản, được đo bằng kilocalories (kcal).
Ví dụ về biểu thị 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
Lượng năng lượng cơ bản đã đốt cháy là 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 khoảng thời gian nhất định, đượ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 giá trị năng lượng cơ bản hằng ngày, hãy 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 nghỉ ngơi bình thường, được đo bằng kilocalories mỗi ngày (kcal/day). Vì tỷ lệ này thay đổi theo các thông tin cập nhật về thể chất (chẳng hạn như cân nặng) theo thời gian, nên API 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 hằng ngày tương ứng với bản tổng hợp hằng ngày về năng lượng cơ bản đã đốt cháy.
Ví dụ về biểu thị REST
{
"date": {
"year": 2026,
"month": 4,
"day": 20
},
"dataSource": { ... },
"rateKcalPerDay": 1650.0
}
Nguyên tắc
Khi tích hợp chỉ số calo và năng lượng vào ứng dụng, hãy làm theo các nguyên tắc sau:
- Thông tin tổng quan hằng ngày: Để cho biết tổng mức tiêu thụ calo hằng ngày, hãy yêu cầu thông tin tổng hợp hằng ngày của kiểu dữ liệu
total-calories. - Mức tiêu thụ chỉ tí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 tính 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 lúc nghỉ ngơi hoặc xu hướng trao đổi chất cơ bản, hãy truy vấn
basal-metabolic-rateđể biết các giá trị BMR. Coi các mẫu BMR là mức 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.