APIهای Google Fit، از جمله Google Fit REST API، پس از 30 ژوئن 2025 دیگر در دسترس نخواهند بود . از 1 می 2024، توسعه دهندگان نمی توانند برای استفاده از این API ها ثبت نام کنند .

برای دستورالعمل‌هایی که در مورد کدام API یا پلتفرم باید به آن مهاجرت کنید، از راهنمای مهاجرت Health Connect دیدن کنید. برای مقایسه Health Connect با APIهای Google Fit و APIهای وب Fitbit، از راهنمای مقایسه Health Connect دیدن کنید.

درباره Health Connect و نحوه ادغام با API بیشتر بیاموزید .

این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

انواع داده های فعالیت

این نوع داده ها را می توان برای ثبت فعالیت ها، تمرینات و معیارهای مربوط به ورزش استفاده کرد.

فعالیت

از این نوع داده می توان برای ثبت هر فعالیتی که کاربر انجام می دهد استفاده کرد. این می تواند فعالیت های تناسب اندام رایج مانند دویدن یا ورزش های مختلف و همچنین فعالیت هایی مانند مدیتیشن، باغبانی و خواب باشد.

اگر کاربر در آن بازه زمانی بیش از یک فعالیت انجام می‌داد، یک جلسه برای نوع فعالیت اصلی و چندین بخش برای انواع مختلف فعالیت ایجاد کنید. به عنوان مثال، اگر آنها در طول کلاس هنرهای رزمی ترکیبی کمی کیک بوکس و بوکس انجام دادند، یک جلسه برای هنرهای رزمی ترکیبی ایجاد کنید. سپس می‌توانید انواع فعالیت‌های مختلف را به بخش‌هایی تقسیم کنید.

هر نقطه داده نیاز به زمان شروع و زمان پایان دارد. لازم نیست نقاط داده پشت سر هم یا مستقیماً پشت سر هم قرار گیرند، ممکن است شکاف هایی بین آنها وجود داشته باشد.

استراحت

نام	`com.google.activity.segment`
محدوده های مجوز OAuth	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
فیلدها (فرمت-واحدها)	نوع فعالیت ( `int` — enum) نوع فعالیتی که کاربر انجام می داد. لیست انواع فعالیت ها را اینجا ببینید.

اندروید

نام	`com.google.activity.segment`
شی نوع داده	`TYPE_ACTIVITY_SEGMENT`
مجوز اندروید	`ACTIVITY_RECOGNITION`
فیلدها (فرمت-واحد)	FIELD_ACTIVITY ( `int` — enum) نوع فعالیتی که کاربر انجام می داد. لیست انواع فعالیت ها را اینجا ببینید.

نرخ متابولیسم پایه (BMR)

این نوع داده، BMR کاربر را بر حسب کیلوکالری می گیرد. هر نقطه داده بر اساس قد و وزن نشان دهنده تعداد کیلو کالری است که کاربر در صورت استراحت در تمام روز می سوزاند. فقط زمان پایان باید تنظیم شود. این به عنوان مهر زمانی برای خواندن استفاده خواهد شد.

استراحت

نام	`com.google.calories.bmr`
محدوده های مجوز OAuth	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
فیلدها (فرمت-واحدها)	کالری ( `float` - کیلوکالری در روز) بر اساس قد و وزن، تعداد کیلوکالری که یک کاربر در تمام طول روز استراحت می کند، می سوزاند.

اندروید

نام	`com.google.calories.bmr`
شی نوع داده	`TYPE_BASAL_METABOLIC_RATE`
فیلدها (فرمت-واحدها)	FIELD_CALORIES ( `float` — کیلوکالری در روز) بر اساس سن، وزن و قد، تعداد کیلوکالری که یک کاربر در تمام طول روز استراحت می کند، می سوزاند.

کالری سوزانده شده است

این نوع داده، کل کالری سوزانده شده توسط کاربر (بر حسب کیلو کالری) از جمله کالری سوزانده شده در حالت استراحت (BMR) را جمع آوری می کند. هر نقطه داده نشان دهنده کل کیلو کالری سوزانده شده در یک بازه زمانی است، بنابراین هر دو زمان شروع و پایان باید تنظیم شوند.

استراحت

نام	`com.google.calories.expended`
محدوده مجوز OAuth	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
فیلدها (فرمت-واحدها)	کالری ( `float` - کیلو کالری) تعداد کیلو کالری سوزانده شده

اندروید

نام	`com.google.calories.expended`
شی نوع داده	`TYPE_CALORIES_EXPENDED`
مجوز اندروید	`ACTIVITY_RECOGNITION`
فیلدها (فرمت-واحدها)	FIELD_CALORIES ( `float` — کیلوکالری) تعداد کیلو کالری سوزانده شده

رکاب زدن دوچرخه سواری

اگر کاربر دوچرخه سواری کند، می توان از این نوع داده برای ثبت سرعت پدال زدن او، بر حسب دور میل لنگ در دقیقه (RPM) استفاده کرد. هر نقطه داده نشان دهنده یک اندازه گیری لحظه ای از سرعت پدال زدن است، بنابراین فقط زمان پایان باید تنظیم شود. این به عنوان مهر زمانی برای خواندن استفاده خواهد شد.

استراحت

نام	`com.google.cycling.pedaling.cadence`
محدوده های مجوز OAuth	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
فیلدها (فرمت-واحدها)	دور در دقیقه ( `float` - دور در دقیقه) تعداد چرخش میل لنگ دوچرخه در دقیقه.

اندروید

نام	`com.google.cycling.pedaling.cadence`
شی نوع داده	`TYPE_CYCLING_PEDALING_CADENCE`
فیلدها (فرمت-واحدها)	FIELD_RPM ( `float` — دور در دقیقه) تعداد چرخش میل لنگ دوچرخه در دقیقه.

دوچرخه سواری رکاب زدن تجمعی

اگر کاربر دوچرخه سواری کند، می توان از این نوع داده برای ثبت تعداد دورهای میل لنگ در یک دوره زمانی استفاده کرد. هر نقطه داده نشان دهنده تعداد دورهای از زمان شمارش در زمان شروع است.

استراحت

نام	`com.google.cycling.pedaling.cumulative`
محدوده های مجوز OAuth	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
فیلدها (فرمت-واحدها)	انقلاب ( `int` —count) تعداد چرخش میل لنگ دوچرخه در یک دوره زمانی.

اندروید

نام	`com.google.cycling.pedaling.cumulative`
شی نوع داده	`TYPE_CYCLING_PEDALING_CUMULATIVE`
فیلدها (فرمت-واحدها)	FIELD_REVOLUTIONS ( `int` —count) تعداد چرخش میل لنگ دوچرخه در یک دوره زمانی.

نقاط قلب

این نوع داده، تعداد امتیازهای قلبی را که کاربر از تمام فعالیت‌هایش کسب کرده است، ثبت می‌کند. هر نقطه داده نشان دهنده تعداد نقاط قلب محاسبه شده برای یک بازه زمانی است.

کاربر می تواند یک هدف روزانه Heart Point تعیین کند و پیشرفت خود را پیگیری کند. امتیاز قلب را می توان با استفاده از موارد زیر محاسبه کرد:

ضربان قلب
مقادیر معادل متابولیک وظیفه (MET).
سرعت راه رفتن

تعداد Heart Point های کسب شده به شدت فعالیت بستگی دارد. از این راهنما برای محاسبه و نوشتن Heart Points استفاده کنید:

داده ها	1 اسب بخار (فعالیت با شدت کم و متوسط)	2 اسب بخار (فعالیت با شدت بالا)
ضربان قلب	1 دقیقه فعالیت با حداکثر ضربان قلب بیش از 50٪	1 دقیقه فعالیت با بیش از 70 درصد ضربان قلب
مقدار MET	3-6 MET. به عنوان مثال، قایقرانی یا صخره نوردی،	> 6 MET. به عنوان مثال، HIIT، اسکی، والیبال یا فوتبال.
سرعت راه رفتن	100-130 قدم در دقیقه	بیش از 130 قدم در دقیقه

استراحت

نام	`com.google.heart_minutes`
محدوده های مجوز OAuth	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
فیلدها (فرمت-واحدها)	شدت ( `float` - نقاط قلب) امتیازات قلبی بر اساس شدت تمرین یا فعالیتی که کاربر انجام می دهد، به دست می آید.

اندروید

نام	`com.google.heart_minutes`
شی نوع داده	`TYPE_HEART_MINUTES`
فیلدها (فرمت-واحدها)	FIELD_INTENSITY ( `float` - نقاط قلب) شدت تمرین یا فعالیتی که کاربر انجام می دهد. یک دقیقه فعالیت بدنی سبک تا متوسط (مثل راه رفتن سریعتر از 2.5 مایل در ساعت یا دوچرخه سواری سریعتر از 10 مایل در ساعت) 1 امتیاز قلبی کسب می کند. یک دقیقه فعالیت شدیدتر 2 امتیاز قلب کسب می کند.

دقیقه حرکت

این نوع داده، تعداد دقیقه‌های حرکتی را که Google Fit محاسبه می‌کند، از تمام فعالیت‌های کاربر به دست می‌آورد. هر نقطه داده نشان دهنده تعداد مشتق شده از Move Minutes برای یک بازه زمانی است. زمان شروع و پایان هر دو باید تنظیم شود.

کاربران می توانند از هر فعالیتی مانند یوگا، رقص، یا باغبانی و سایر کارهای خانه، Move Minutes کسب کنند. اگر آنها به پیاده روی بروند، Google Fit هر بار که حداقل 30 قدم در 60 ثانیه بردارد، یک دقیقه حرکت جایزه می دهد.

استراحت

نام	`com.google.active_minutes`
محدوده مجوز OAuth	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
فیلدها (فرمت-واحدها)	مدت زمان ( `int` - میلی ثانیه) مدت زمان Move Minutes به دست آمده، بر حسب میلی ثانیه. محدوده معتبر : >=0

اندروید

نام	`com.google.active_minutes`
شی نوع داده	`TYPE_MOVE_MINUTES`
فیلدها (فرمت-واحدها)	FIELD_DURATION ( `int` — میلی ثانیه) مدت زمان Move Minutes به دست آمده، بر حسب میلی ثانیه. محدوده معتبر : 0—Long.MAX_VALUE

قدرت

این نوع داده، توان تولید شده توسط کاربر هنگام انجام یک فعالیت را که بر حسب وات اندازه گیری می شود، دریافت می کند. به عنوان مثال، استفاده از برق سنج هنگام ورزش روی دوچرخه ثابت. هر نقطه داده نشان دهنده اندازه گیری لحظه ای توان تولید شده است.

هر نقطه داده نشان دهنده یک اندازه گیری لحظه ای از توان تولید شده است، بنابراین فقط زمان پایان باید تنظیم شود. این به عنوان مهر زمانی برای خواندن استفاده خواهد شد.

استراحت

نام	`com.google.power.sample`
محدوده های مجوز OAuth	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
فیلدها (فرمت-واحدها)	وات ( `float` - وات) توان تولید شده، بر حسب وات

اندروید

نام	`com.google.power.sample`
شی نوع داده	`TYPE_POWER_SAMPLE`
فیلدها (فرمت-واحدها)	FIELD_WATTS ( `float` — وات) توان تولید شده، بر حسب وات

آهنگ شمارش گام ها

این نوع داده آهنگ راه رفتن را که بر حسب گام در دقیقه اندازه گیری می شود، ثبت می کند. هر نقطه داده نشان دهنده اندازه گیری لحظه ای آهنگ در گام در دقیقه است.

استراحت

نام	`com.google.step_count.cadence`
محدوده های مجوز OAuth	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
فیلدها (فرمت-واحدها)	دور در دقیقه ( `float` - گام / دقیقه) سرعت بر حسب گام در دقیقه اندازه گیری می شود.

اندروید

نام	`com.google.step_count.cadence`
شی نوع داده	`TYPE_STEP_COUNT_CADENCE`
فیلدها (فرمت-واحدها)	FIELD_RPM ( `float` — گام/ دقیقه) سرعت بر حسب گام در دقیقه اندازه گیری می شود.

دلتا شمارش گام

این نوع داده تعداد مراحل برداشته شده از آخرین خواندن را ثبت می کند. هر مرحله فقط یک بار گزارش می شود، بنابراین نقاط داده نباید زمان همپوشانی داشته باشند. زمان شروع هر نقطه داده باید نشان دهنده شروع فاصله زمانی باشد که در آن مراحل برداشته شده است.

زمان شروع باید برابر یا بیشتر از زمان پایان نقطه داده قبلی باشد. جمع کردن همه مقادیر با هم برای یک دوره زمانی، تعداد کل مراحل در آن دوره را محاسبه می کند.

استراحت

نام com.google.step_count.delta

محدوده های مجوز OAuth

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

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

فیلدها (فرمت-واحدها)

مراحل ( int —count)

تعداد اقدامات انجام شده در یک دوره زمانی

محدوده معتبر : 0-10 قدم در ثانیه

اندروید

نام com.google.step_count.delta

شی نوع داده TYPE_STEP_COUNT_DELTA

مجوز اندروید ACTIVITY_RECOGNITION

فیلدها (فرمت-واحدها)

TYPE_STEP_COUNT_DELTA ( int - تعداد)

تعداد اقدامات انجام شده در یک دوره زمانی

محدوده معتبر : 0-10 قدم در ثانیه

تمرین

هر نقطه داده نشان دهنده یک مجموعه مداوم از یک تمرین تمرینی است که توسط کاربر انجام می شود. نقطه داده شامل فیلدهایی برای نوع تمرین (به عنوان مثال تمرینات مقاومتی یا تمرینات با وزنه)، تعداد تکرارهای تمرین، مدت زمان تمرین و مقاومت است.

استراحت

نام com.google.activity.exercise

محدوده های مجوز OAuth

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

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

فیلدها (فرمت-واحدها)

تمرین ( int — enum)

ارزش‌هایی که نشان‌دهنده تمرین‌های مختلف، مانند تمرینات وزنه‌برداری، تمرینات قدرتی، و تمرینات قلبی عروقی هستند.

ارزش های پذیرفته شده

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

تکرارها ( int - enum)

تعداد تکرارهای یک تمرین.

نوع مقاومت ( int —enum)

نوع مقاومت مورد استفاده در طول تمرین.

ارزش های پذیرفته شده

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

مقاومت ( float - کیلوگرم)

مقاومت تمرین (یا وزن)، بر حسب کیلوگرم.

مدت زمان ( int - میلی ثانیه)

مدت زمان تمرینی که مدت آن اهمیت دارد.

اندروید

نام com.google.activity.exercise

فیلدها (فرمت-واحدها)

FIELD_EXERCISE ( int — enum)

ارزش های پذیرفته شده

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 —count)

تعداد تکرارهای یک تمرین.

FIELD_RESISTANCE_TYPE ( int — enum)

نوع مقاومت مورد استفاده در طول تمرین.

ارزش های پذیرفته شده

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 — کیلوگرم)

مقاومت تمرین (یا وزن)، بر حسب کیلوگرم.

FIELD_DURATION ( int — میلی ثانیه)

مدت زمان تمرینی که مدت آن اهمیت دارد.