Các API của Google Fit, bao gồm cả API Google Fit REST, sẽ ngừng hoạt động vào năm 2026. 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 cần di chuyển sang, hãy truy cập vào Hướng dẫn di chuyển sang Health Connect. Để so sánh Health Connect với các API Google Fit và API Fitbit Web, hãy truy cập vào 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.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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 hoạt động, bài tập và chỉ số liên quan đến hoạt động thể dục.

Hoạt động

Bạn có thể dùng kiểu dữ liệu này để ghi lại mọi hoạt động mà người dùng thực hiện. Dữ liệu này có thể bao gồm các hoạt động thể dục thông thường như chạy bộ hoặc các môn thể thao khác, 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 một phiên cho loại hoạt động chính và nhiều phân khúc cho các loại hoạt động khác. Ví dụ: nếu họ tập một chút kick boxing và boxing trong một lớp võ tổng hợp, hãy tạo một phiên tập võ tổng hợp. Sau đó, bạn có thể chia các loại hoạt động khác nhau thành các phân khúc.

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

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 đã 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 kiểu 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 ghi lại BMR của người dùng, tính bằng kilocalories. Mỗi điểm dữ liệu biểu thị số kilocalories 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ọ. 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ượt đọ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ố kilocalories mà người dùng sẽ đốt cháy nếu khi 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 kiểu dữ liệu	`TYPE_BASAL_METABOLIC_RATE`
Trường (định dạng – đơn vị)	FIELD_CALORIES (`float` kcal mỗi ngày) Số kilocalories 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 kilocalories) 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 biểu thị tổng số kilocalories được đốt cháy trong một khoảng thời gian, vì vậy, bạn nên đặt 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ố kilocalorie đã đốt cháy.

Android

Tên	`com.google.calories.expended`
Đối tượng kiểu 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ố kilocalorie đã đốt cháy.

Nhịp đạp xe

Nếu người dùng đi xe đạp, bạn có thể dùng kiểu dữ liệu này để ghi lại tốc độ đạp xe của họ, tính bằng số vòng quay của trục khuỷu mỗi phút (RPM). Mỗi điểm dữ liệu biểu thị một phép đo tức thời 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 dữ liệu đọc.

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ị)	rpm (`float` – rpm) Số vòng quay của trục khuỷu xe đạp mỗi phút.

Android

Tên	`com.google.cycling.pedaling.cadence`
Đối tượng kiểu 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.

Tổng số lần đạp xe

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

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ị)	revolutions (`int` – số lượt) 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 kiểu 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 trục khuỷu 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 đã tích luỹ đượ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 được 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. Bạn có thể tính Điểm nhịp tim bằng cách sử dụng:

tần số 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 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 đến trung bình)	2 HP (Hoạt động cường độ cao)
Tần số tim	1 phút hoạt động ở mức >50% nhịp tim tối đa	1 phút hoạt động ở mức >70% nhịp tim tối đa
Giá trị MET	3-6 MET. Ví dụ: chèo thuyền hoặc leo núi,	>6 MET. Ví dụ: HIIT, trượt tuyết, bóng chuyền hoặc bóng đá.
Tốc độ đi bộ	100 – 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 được ghi nhận dựa trên cường độ của bài tập hoặc hoạt động mà người dùng thực hiện.

Android

Tên	`com.google.heart_minutes`
Đối tượng kiểu dữ liệu	`TYPE_HEART_MINUTES`
Trường (định dạng – đơn vị)	FIELD_INTENSITY (`float` – điểm tim) Cường độ của bài tập hoặc hoạt động mà người dùng thực hiện. Một phút hoạt động thể chất từ nhẹ đến vừa phải (như đi bộ nhanh hơn 4 km/giờ hoặc đạp xe nhanh hơn 16 km/giờ) sẽ nhận được 1 điểm nhịp tim. 1 phút hoạt động có cường độ cao hơn sẽ giúp bạn 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 toán được cho người dùng, dựa trên tất cả hoạt động của họ. Mỗi điểm dữ liệu biểu thị số phút vận động được tính toán cho một khoảng thời gian. Bạn phải đặt cả thời gian bắt đầu và thời gian kết thúc.

Người dùng có thể tích luỹ Phút vận động từ mọi hoạt động như tập yoga, khiêu vũ hoặc làm vườn và các công việc nhà khác. Nếu họ đi bộ, Google Fit sẽ trao 1 Phút vận động mỗi khi họ thực hiện ít nhất 30 bước trong vòng 60 giây.

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 Phút vận động đã tích luỹ, tính bằng mili giây. Phạm vi hợp lệ: >=0

Android

Tên	`com.google.active_minutes`
Đối tượng kiểu 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 Phút vận động đã tích luỹ, tính bằng mili giây. Phạm vi hợp lệ: 0 – Long.MAX_VALUE

Công suất

Loại dữ liệu này ghi lại công suất 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ập thể dục. Mỗi điểm dữ liệu biểu thị một phép đo tức thời về công suất được tạo ra.

Mỗi điểm dữ liệu biểu thị một phép đo tức thời về công suất được tạo ra, 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 dữ liệu đọ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) Năng lượng được tạo ra, tính bằng watt.

Android

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

Nhịp độ số bước

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

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 kiểu 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.

Chênh lệch số bước

Loại dữ liệu này ghi lại số bước đã đi kể từ lần đọc gần đây nhất. Mỗi bước chỉ được báo cáo một lần nên các điểm dữ liệu không được có thời gian trùng lặp. 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 khoảng thời gian mà các bước đượ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 đó. Khi cộng tất cả các giá trị lại với nhau trong một khoảng thời gian, bạn sẽ tính được 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 đã đi trong một khoảng thời gian.

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

Android

Tên com.google.step_count.delta

Đối tượng kiểu 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 trong một khoảng thời gian.

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

Thể dục

Mỗi điểm dữ liệu đại diện cho một nhóm bài tập thể dục liên tục duy nhất do người dùng thực hiện. Điểm dữ liệu này chứa các trường cho loại bài tập (ví dụ: bài tập kháng lực hoặc bài tập 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à lực kháng.

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ị)

exercise (int – enum)

Các giá trị đại diện cho nhiều bài tập, chẳng hạn như bài tập nâng 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

repetitions (int – enum)

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

resistance type (int – enum)

Loại lực cản được sử dụng trong bài tập.

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.

lực cản (float—kg)

Lực cản của bài tập (hoặc trọng lượng), tính bằng ki-lô-gam.

duration (int – mili giây)

Thời lượng của một bài tập 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, chẳng hạn như bài tập nâng 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 của một bài tập.

FIELD_RESISTANCE_TYPE (int – enum)

Loại lực cản được sử dụng trong bài tập.

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)

Lực cản của bài tập (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 một bài tập mà thời lượng có ý nghĩa.

Loại dữ liệu hoạt động Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Hoạt động

REST

Android

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

REST

Android

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

REST

Android

Nhịp đạp xe

REST

Android

Tổng số lần đạp xe

REST

Android

Điểm nhịp tim

REST

Android

Phút vận động

REST

Android

Công suất

REST

Android

Nhịp độ số bước

REST

Android

Chênh lệch số bước

REST

Android

Thể dục

REST

Android

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