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ề bài tập thể dục.

Hoạt động

Bạn có thể dùng loại dữ liệu này để 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 đang thực hiện nhiều hoạt động trong khoảng thời gian đó, hãy tạo một 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 võ thuật tổng hợp và quyền anh trong một lớp học võ tổng hợp, hãy tạo một phiên cho 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`
Phạm vi quyền 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 đang 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.

REST

Tên	`com.google.calories.bmr`
Phạm vi quyền 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ố kilocalo mà 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ố kilocalo mà 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 ghi lại tổng lượng calo (tính bằng kilocalo) mà người dùng đã đốt cháy, 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 đã đố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 .

REST

Tên	`com.google.calories.expended`
Phạm vi quyền 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ố kilocalo đã đố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, thì loại dữ liệu này có thể được dùng để ghi lại tốc độ đạp xe của họ, tính bằng số vòng quay tay quay mỗi phút (RPM). Mỗi điểm dữ liệu thể hiện một phép đo tức thì về tốc độ đạp xe, vì vậy, bạn chỉ nên đặt thời gian kết thúc. Giá trị 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.cycling.pedaling.cadence`
Phạm vi quyền 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 khuỷu xe đạp mỗi phút.

Số vòng đạ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`
Phạm vi quyền 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 quay (`int` – số lượng) Số vòng quay của trục khuỷu 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ần) 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 ghi lại 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 thể hiện số Điểm nhịp tim được tính toán 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 họ. Bạn có thể tính Điểm nhịp tim bằng cách sử dụng:

nhịp tim
Giá trị Mức tiêu thụ năng lượng của hoạt động (MET)
tốc độ đi bộ

Số Điểm nhịp tim bạn nhận được phụ thuộc vào cường độ của hoạt động. Hãy sử dụng hướng dẫn này để tính toán 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 đến 130 bước mỗi phút	>130 bước mỗi phút

REST

Tên	`com.google.heart_minutes`
Phạm vi quyền 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 của 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`
Phạm vi quyền 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 của số 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 của số 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 máy đo công suất khi tập thể dục trên xe đạp tập. Mỗi điểm dữ liệu biểu thị một phép đo tức thời của điện nă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. Giá trị này sẽ được dùng làm dấu thời gian cho lần đọc.

REST

Tên	`com.google.power.sample`
Phạm vi quyền 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`
Phạm vi quyền 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ỗi bước chỉ được báo cáo một lần để các điểm dữ liệu không có thời gian trùng lặp. 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 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 đó.

REST

Tên com.google.step_count.delta

Phạm vi quyền 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 – 10 bước/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 đi được 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 bộ bài tập thể dục liên tục do người dùng thực hiện. Điểm dữ liệu chứa các trường cho loại bài tập (ví dụ: bài tập sức đề kháng hoặc tập thể dục với tạ), số lần lặp lại của bài tập, thời lượng của bài tập và mức độ kháng cự.

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

Tên com.google.activity.exercise

Phạm vi quyền 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ài tập (int – enum)

Các giá trị đại diện cho nhiều bài tập thể dục, chẳng hạn như bài tập nâng tạ, bài tập thể dục tăng cường sức mạnh và bài tập thể dục 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

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 kilogam.

duration (int — mili giây)

Thời lượng của một bài tập thể dục mà thời lượng có ý nghĩa.

Android

Tên com.google.activity.exercise

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

FIELD_EXERCISE (int – enum)

Các giá trị đại diện cho nhiều bài tập thể dục, chẳng hạn như bài tập nâng tạ, bài tập thể dục tăng cường sức mạnh và bài tập thể dục 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ần lặp lại)

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 sử dụng trong bài 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)

Mức kháng của bài tập (hoặc trọng lượng), tính bằng kilô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.