Loại dữ liệu về calo và năng lượng

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:

Bảng: Các loại dữ liệu calo của Google Health API

Loại dữ liệu   dataType   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ố không thực
Năng lượng đốt cháy khi hoạt động   active-energy-burned   active_energy_burned	Khoảng thời gian	list, reconcile, rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly
Tổng lượng calo   total-calories   total_calories	Khoảng thời gian	rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly

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.

Các truy vấn cho kiểu dữ liệu total-calories phải có bộ lọc khoảng thời gian (chẳng hạn như total_calories.interval.start_time hoặc total_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
}

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.