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.

Để biết hướng dẫn về API hoặc nền tảng mà bạn muốn di chuyển sang, hãy truy cập vào Hướng dẫn di chuyển của Health Connect. Để so sánh Health Connect với API Google Fit và API Fitbit Web, hãy xem phần hướng dẫn so sánh Health Connect.

Tìm hiểu thêm về Health Connect và cách tích hợp với API này.

Trang này được dịch bởi Cloud Translation API.

Loại dữ liệu hoạt động

Bạn có thể dùng các loại dữ liệu này để ghi lại các hoạt động, bài tập thể dục và chỉ số về tập thể dục.

Hoạt động

Loại dữ liệu này có thể được dùng để ghi lại mọi hoạt động mà người dùng thực hiện. Thông tin này có thể là các hoạt động thể dục phổ biến như chạy bộ hoặc các môn thể thao khác nhau, cũng như các hoạt động như thiền, làm vườn và ngủ.

Nếu người dùng đã thực hiện nhiều hoạt động trong khoảng thời gian đó, hãy tạo phiên cho loại hoạt động chính và nhiều phân đoạn cho các loại hoạt động khác nhau. Ví dụ: nếu họ tập một chút kick quyền anh và quyền anh trong một môn võ tổng hợp hãy tạo một buổi tập võ tổng hợp. Sau đó, bạn có thể phân tích các chỉ số thành các phân đoạn.

Mỗi điểm dữ liệu cần có thời gian bắt đầu và thời gian kết thúc. Không cần phải đặt điểm dữ liệu nối tiếp nhau hoặc ngay sau nhau, thì có thể có những khoảng trống giữa chúng.

Kiến trúc chuyển trạng thái đại diện (REST)

Tên	`com.google.activity.segment`
Các phạm vi quyền của OAuth	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
Trường (định dạng – đơn vị)	loại hoạt động (`int` – enum) Loại hoạt động mà người dùng đã thực hiện. Xem danh sách các loại hoạt động tại đây.

Android

Tên	`com.google.activity.segment`
Đối tượng loại dữ liệu	`TYPE_ACTIVITY_SEGMENT`
Quyền trên Android	`ACTIVITY_RECOGNITION`
Trường (định dạng – đơn vị)	FIELD_ACTIVITY (`int`—enum) Loại hoạt động mà người dùng đã thực hiện. Xem danh sách các loại hoạt động tại đây.

Tỷ lệ trao đổi chất cơ bản (BMR)

Loại dữ liệu này thu thập BMR của người dùng, tính theo kilo calo. Mỗi điểm dữ liệu thể hiện số kilo calo mà một người dùng sẽ đốt cháy nếu nghỉ ngơi cả ngày, dựa trên chiều cao và cân nặng của trẻ. Bạn chỉ nên đặt thời gian kết thúc. Chiến dịch này sẽ được dùng làm dấu thời gian cho lần đọc.

Kiến trúc chuyển trạng thái đại diện (REST)

Tên	`com.google.calories.bmr`
Các phạm vi quyền của OAuth	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
Trường (định dạng – đơn vị)	calo (`float` — kcal mỗi ngày) Số kilo calo mà một người dùng sẽ đốt cháy nếu nghỉ ngơi cả ngày, dựa trên chiều cao và cân nặng của họ.

Android

Tên	`com.google.calories.bmr`
Đối tượng loại dữ liệu	`TYPE_BASAL_METABOLIC_RATE`
Trường (định dạng – đơn vị)	FIELD_CALORIES (`float` — kcal mỗi ngày) Số kilo calo mà một người dùng sẽ đốt cháy nếu nghỉ ngơi cả ngày, dựa trên tuổi, cân nặng và chiều cao của họ.

Lượng calo đã đốt cháy

Loại dữ liệu này cho biết tổng lượng calo (tính bằng kilo calo) do của người dùng, bao gồm cả lượng calo đốt cháy khi nghỉ ngơi (BMR). Mỗi điểm dữ liệu đại diện cho tổng kilo calo bị đốt cháy trong một khoảng thời gian, do đó cả thời gian bắt đầu và thời gian kết thúc .

Kiến trúc chuyển trạng thái đại diện (REST)

Tên	`com.google.calories.expended`
Các phạm vi quyền của OAuth	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
Trường (định dạng – đơn vị)	calo (`float` — kcal) Số kilo calo đã đốt cháy.

Android

Tên	`com.google.calories.expended`
Đối tượng loại dữ liệu	`TYPE_CALORIES_EXPENDED`
Quyền trên Android	`ACTIVITY_RECOGNITION`
Trường (định dạng – đơn vị)	FIELD_CALORIES (`float`—kcal) Số kilo calo đã đốt cháy.

Nhịp đạp xe

Nếu người dùng đi xe đạp, loại dữ liệu này có thể được dùng để ghi lại quá trình đạp xe của họ tốc độ, tính bằng số vòng quay mỗi phút của trục khuỷu (RPM). Mỗi điểm dữ liệu đại diện cho một giá trị đo tức thời của tốc độ đạp, nên chỉ có độ dài thời gian. Dấu thời gian này sẽ được dùng làm dấu thời gian cho kết quả đo.

Kiến trúc chuyển trạng thái đại diện (REST)

Tên	`com.google.cycling.pedaling.cadence`
Các phạm vi quyền của OAuth	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
Trường (định dạng – đơn vị)	vòng/phút (`float`—vòng/phút) Số vòng quay của trục quay xe đạp mỗi phút.

Android

Tên	`com.google.cycling.pedaling.cadence`
Đối tượng loại dữ liệu	`TYPE_CYCLING_PEDALING_CADENCE`
Trường (định dạng – đơn vị)	FIELD_RPM (`float`—vòng/phút) Số vòng quay của trục quay xe đạp mỗi phút.

Số đạp xe tích luỹ

Nếu người dùng đi xe đạp, loại dữ liệu này có thể được dùng để thu thập số vòng quay của trục khuỷu trong một khoảng thời gian. Mỗi điểm dữ liệu đại diện cho số vòng quay kể từ số đếm tại thời điểm bắt đầu.

Kiến trúc chuyển trạng thái đại diện (REST)

Tên	`com.google.cycling.pedaling.cumulative`
Các phạm vi quyền của OAuth	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
Trường (định dạng – đơn vị)	số vòng quay (`int`—số lượng) Số vòng quay của tay quay xe đạp trong một khoảng thời gian.

Android

Tên	`com.google.cycling.pedaling.cumulative`
Đối tượng loại dữ liệu	`TYPE_CYCLING_PEDALING_CUMULATIVE`
Trường (định dạng – đơn vị)	FIELD_REVOLUTIONS (`int`—số lượng) Số vòng quay của tay quay xe đạp trong một khoảng thời gian.

Điểm nhịp tim

Loại dữ liệu này cho biết số Điểm nhịp tim mà người dùng đã kiếm được từ tất cả hoạt động của họ. Mỗi điểm dữ liệu biểu thị số Điểm nhịp tim đã tính cho một khoảng thời gian.

Người dùng có thể đặt mục tiêu Điểm nhịp tim hằng ngày và theo dõi tiến trình của mình. Điểm nhịp tim có thể được tính bằng cách sử dụng:

nhịp tim
Các giá trị Mức trao đổi chất tương đương của Nhiệm vụ (MET)
tốc độ đi bộ

Số Điểm nhịp tim kiếm được phụ thuộc vào cường độ hoạt động. Sử dụng hướng dẫn này để tính và ghi Điểm nhịp tim:

Dữ liệu	1 HP (Hoạt động ở cường độ thấp trung bình)	2 HP (Hoạt động ở cường độ cao)
Tần số tim	1 phút hoạt động ở tần số tim tối đa trên 50%	1 phút hoạt động ở tần số tim tối đa trên 70%
Giá trị MET	3–6 MET Ví dụ: chèo thuyền hoặc leo núi đá,	>6 MET Ví dụ: tập luyện cường độ cao ngắt quãng (HIIT), môn trượt tuyết, bóng chuyền hoặc bóng bầu dục.
Tốc độ đi bộ	100 – 130 bước mỗi phút	>130 bước mỗi phút

Kiến trúc chuyển trạng thái đại diện (REST)

Tên	`com.google.heart_minutes`
Các phạm vi quyền của OAuth	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
Trường (định dạng – đơn vị)	cường độ (`float` – Điểm nhịp tim) Điểm nhịp tim kiếm được dựa trên cường độ tập thể dục hoặc hoạt động mà người dùng thực hiện.

Android

Tên	`com.google.heart_minutes`
Đối tượng loại dữ liệu	`TYPE_HEART_MINUTES`
Trường (định dạng – đơn vị)	FIELD_INTENSITY (`float`—điểm trái tim) Cường độ tập thể dục hoặc hoạt động mà người dùng thực hiện. 1 phút trong số hoạt động thể chất nhẹ đến vừa (như đi bộ nhanh hơn 2,5 dặm/giờ, hoặc đạp xe nhanh hơn 10 dặm/giờ) thì nhận được 1 điểm nhịp tim. Hơn 1 phút hoạt động cường độ cao sẽ nhận được 2 điểm nhịp tim.

Phút vận động

Loại dữ liệu này ghi lại số Phút vận động mà Google Fit tính được rằng mà người dùng kiếm được từ tất cả hoạt động của họ. Mỗi điểm dữ liệu biểu thị cho số Phút vận động trong một khoảng thời gian. Bạn phải đặt cả thời gian bắt đầu và kết thúc.

Người dùng có thể nhận được Phút vận động từ bất kỳ hoạt động nào như yoga, khiêu vũ hoặc làm vườn và các công việc gia đình khác. Nếu họ đi bộ, Google Fit sẽ trao một Lần vận động Phút mỗi khi trẻ đi được ít nhất 30 bước trong vòng 60 giây.

Kiến trúc chuyển trạng thái đại diện (REST)

Tên	`com.google.active_minutes`
Các phạm vi quyền của OAuth	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
Trường (định dạng – đơn vị)	duration (`int` — mili giây) Thời lượng Phút vận động kiếm được, tính bằng mili giây. Phạm vi hợp lệ: >=0

Android

Tên	`com.google.active_minutes`
Đối tượng loại dữ liệu	`TYPE_MOVE_MINUTES`
Trường (định dạng – đơn vị)	FIELD_DURATION (`int`—mili giây) Thời lượng Phút vận động kiếm được, tính bằng mili giây. Phạm vi hợp lệ: 0—Long.MAX_VALUE

Nguồn điện

Loại dữ liệu này ghi lại năng lượng mà người dùng tạo ra khi thực hiện một hoạt động, được đo bằng watt. Ví dụ: sử dụng đồng hồ đo điện khi tập thể dục trên xe đạp tại chỗ. Mỗi điểm dữ liệu biểu thị một phép đo tức thời của năng lượng tạo ra.

Mỗi điểm dữ liệu biểu thị một giá trị đo tức thời của công suất tạo ra, vì vậy 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.

Kiến trúc chuyển trạng thái đại diện (REST)

Tên	`com.google.power.sample`
Các phạm vi quyền của OAuth	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
Trường (định dạng – đơn vị)	watt (`float`—watt) Nguồn điện tạo ra, tính bằng watt.

Android

Tên	`com.google.power.sample`
Đối tượng loại dữ liệu	`TYPE_POWER_SAMPLE`
Trường (định dạng – đơn vị)	FIELD_WATTS (`float`—watt) Nguồn điện tạo ra, tính bằng watt.

Nhịp độ bước chân

Loại dữ liệu này ghi lại nhịp đi bộ, được đo bằng số bước mỗi phút. Một điểm dữ liệu biểu thị cách đo tức thời của nhịp bước theo bước mỗi phút.

Kiến trúc chuyển trạng thái đại diện (REST)

Tên	`com.google.step_count.cadence`
Các phạm vi quyền của OAuth	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
Trường (định dạng – đơn vị)	vòng/phút (`float` – bước/phút) Nhịp độ bước chân được đo bằng số bước mỗi phút.

Android

Tên	`com.google.step_count.cadence`
Đối tượng loại dữ liệu	`TYPE_STEP_COUNT_CADENCE`
Trường (định dạng – đơn vị)	FIELD_RPM (`float`—bước/phút) Nhịp độ bước chân được đo bằng số bước mỗi phút.

delta số bước

Loại dữ liệu này ghi lại số bước đã đi kể từ lần đọc gần nhất. Một chỉ được báo cáo một lần, vì vậy, các điểm dữ liệu không nên có thời gian chồng chéo. Chiến lược phát hành đĩa đơn thời gian bắt đầu của mỗi điểm dữ liệu phải thể hiện thời điểm bắt đầu của khoảng thời gian theo những bước đã thực hiện.

Thời gian bắt đầu phải bằng hoặc lớn hơn thời gian kết thúc thời gian của điểm dữ liệu trước đó. Cộng tất cả các giá trị lại với nhau trong một khoảng thời gian thời gian sẽ tính tổng số bước trong khoảng thời gian đó.

Kiến trúc chuyển trạng thái đại diện (REST)

Tên com.google.step_count.delta

Các phạm vi quyền của OAuth

https://www.googleapis.com/auth/fitness.activity.read

https://www.googleapis.com/auth/fitness.activity.write

Trường (định dạng – đơn vị)

bước (int—số lượng)

Số bước đã thực hiện trong một khoảng thời gian.

Phạm vi hợp lệ: 0 đến 10 bước mỗi giây

Android

Tên com.google.step_count.delta

Đối tượng loại dữ liệu TYPE_STEP_COUNT_DELTA

Quyền trên Android ACTIVITY_RECOGNITION

Trường (định dạng – đơn vị)

TYPE_STEP_COUNT_DELTA (int—số lượng)

Số bước đã thực hiện trong một khoảng thời gian.

Phạm vi hợp lệ: 0 đến 10 bước mỗi giây

Thể dục

Mỗi điểm dữ liệu đại diện cho một tập liên tục của một bài tập thể dục do người dùng thực hiện. Điểm dữ liệu chứa các trường dành cho loại bài tập thể dục (cho ví dụ như bài tập sức kháng hoặc tập tạ), số lần lặp lại của bài tập, thời lượng thực hiện và sức cản.

Kiến trúc chuyển trạng thái đại diện (REST)

Tên com.google.activity.exercise

Các phạm vi quyền của OAuth

https://www.googleapis.com/auth/fitness.activity.read

https://www.googleapis.com/auth/fitness.activity.write

Trường (định dạng – đơn vị)

tập thể dục (int—enum)

Giá trị đại diện cho các bài tập khác nhau, chẳng hạn như bài tập cử tạ, bài tập rèn luyện sức mạnh và bài tập tim mạch.

Giá trị được chấp nhận

back_extension
bridge.hip.single_leg
burpee
calf_press
calf_raise
calf_raise.seated
calf_raise.standing
chinup
clean
clean.hang
clean.hang_power
clean.jerk
clean.power
crunch
crunch.twisting
curl.bicep
deadlift
deadlift.rdl
deadlift.single_leg
deadlift.straight_leg
dip
dip.chest
dip.triceps
fly
good_morning
hip_extension
hip_raise
hip_thrust
jumping_jack
leg_curl
leg_extension
leg_press
leg_raise
lunge
lunge.rear
lunge.side
plank
plank.side
press.bench
press.bench.close_grip
press.bench.decline
press.bench.incline
press.jm
press.pike
press.shoulder
press.shoulder.arnold
press.shoulder.military
pulldown
pullover
pullup
pushup
pushup.close_grip
pushup.pike
raise.front
raise.lateral
raise.lateral.rear
row
row.high
row.upright
run.high_knee
russian_twist
shrug
situp
situp.twisting
squat
step_up
swing
thruster
triceps_extension
vups
wall_sit

cụm từ lặp lại (int—enum)

Số lần lặp lại một bài tập.

loại điện trở (int—enum)

Loại sức cản được dùng trong khi tập thể dục.

Giá trị được chấp nhận

"intVal": 0 // The resistance type is unknown, unspecified, or can't be represented by a value.
"intVal": 1 // The user is using a barbell for resistance.
"intVal": 2 // The user is using a cable for resistance. If using 2 cables are used (one for each arm), include the resistance weight for one arm.
"intVal": 3 // The user is using dumbells for resistance.
"intVal": 4 // The user is using a kettlebell for resistance
"intVal": 5 // The user is performing the exercise in a machine.
"intVal": 6 // The user is using their own body weight for resistance.

sức kháng (float – kg)

Sức đề kháng của bài tập thể dục (hoặc trọng lượng), tính bằng ki-lô-gam.

duration (int — mili giây)

Thời lượng của bài tập thể dục mà thời lượng quan trọng.

Android

Tên com.google.activity.exercise

Trường (định dạng – đơn vị)

FIELD_EXERCISE (int—enum)

Giá trị đại diện cho các bài tập khác nhau, chẳng hạn như bài tập cử tạ, bài tập rèn luyện sức mạnh và bài tập tim mạch.

Giá trị được chấp nhận

ARNOLD_PRESS
BACK_EXTENSION
BENCH_PRESS
BICEP_CURL
BURPEE
CALF_PRESS
CALF_RAISE
CHEST_DIP
CHINUP
CLEAN
CLEAN_JERK
CLOSE_GRIP_BENCH_PRESS
CLOSE_GRIP_PUSHUP
CRUNCH
DEADLIFT
DECLINE_BENCH_PRESS
DIP
FLY
FRONT_RAISE
GOOD_MORNING
HANG_CLEAN
HANG_POWER_CLEAN
HIGH_KNEE_RUN
HIGH_ROW
HIP_EXTENSION
HIP_RAISE
HIP_THRUST
INCLINE_BENCH_PRESS
JM_PRESS
JUMPING_JACK
LATERAL_RAISE
LEG_CURL
LEG_EXTENSION
LEG_PRESS
LEG_RAISE
LUNGE
MILITARY_PRESS
PIKE_PRESS
PIKE_PUSHUP
PLANK
POWER_CLEAN
PULLDOWN
PULLOVER
PULLUP
PUSHUP
RDL_DEADLIFT
REAR_LATERAL_RAISE
REAR_LUNGE
ROW
RUSSIAN_TWIST
SEATED_CALF_RAISE
SHOULDER_PRESS
SHRUG
SIDE_LUNGE
SIDE_PLANK
SINGLE_LEG_DEADLIFT
SINGLE_LEG_HIP_BRIDGE
SITUP
SQUAT
STANDING_CALF_RAISE
STEP_UP
STRAIGHT_LEG_DEADLIFT
SWING
THRUSTER
TRICEPS_DIP
TRICEPS_EXTENSION
TWISTING_CRUNCH
TWISTING_SITUP
UPRIGHT_ROW
V_UPS
WALL_SIT

FIELD_REPETITIONS (int—số lượng)

Số lần lặp lại một bài tập.

FIELD_RESISTANCE_TYPE (int—enum)

Loại sức cản được dùng trong khi tập thể dục.

Giá trị được chấp nhận

RESISTANCE_TYPE_UNKNOWN // The resistance type is unknown, unspecified, or can't be represented by a value.
RESISTANCE_TYPE_BARBELL // The user is using a barbell for resistance.
RESISTANCE_TYPE_CABLE // The user is using a cable for resistance. If using 2 cables are used (one for each arm), include the resistance weight for one arm.
RESISTANCE_TYPE_DUMBBELL // The user is using dumbells for resistance.
RESISTANCE_TYPE_KETTLEBELL // The user is using a kettlebell for resistance
RESISTANCE_TYPE_MACHINE // The user is performing the exercise in a machine.
RESISTANCE_TYPE_BODY // The user is using their own body weight for resistance.

FIELD_RESISTANCE (float—kg)

Sức đề kháng của bài tập thể dục (hoặc trọng lượng), tính bằng ki-lô-gam.

FIELD_DURATION (int—mili giây)

Thời lượng của bài tập thể dục mà thời lượng quan trọng.