ממשקי ה-API של Google Fit, כולל Google Fit, לא יהיו זמינים יותר אחרי 30 ביוני 2025. החל מ-1 במאי 2024, מפתחים לא יוכלו להירשם לשימוש בממשקי ה-API האלה.

כדי לקבל הוראות לגבי ה-API או הפלטפורמה שאליהם צריך לעבור, אפשר לעיין במדריך להעברת נתונים של Health Connect. להשוואה בין Health Connect לממשקי ה-API של Google Fit לבין ממשקי ה-API של Fitbit Web, אפשר לעיין במדריך ההשוואה של Health Connect.

מידע נוסף על Health Connect ועל השילוב עם ה-API.

דף זה תורגם על ידי Cloud Translation API.

סוגים של נתוני פעילות

ניתן להשתמש בסוגי הנתונים האלה כדי לתעד את הפעילויות, האימונים והמדדים הקשורים לפעילות הגופנית.

פעילות

סוג הנתונים הזה יכול לשמש כדי לתעד כל פעילות של המשתמש. זו יכולה להיות פעילויות כושר נפוצות כמו ריצה או סוגי ספורט שונים, וגם פעילויות כמו מדיטציה, גינון ושינה.

אם המשתמש ביצע יותר מפעילות אחת בתקופת הזמן הזו, צריך ליצור סשן לסוג הפעילות הראשי, ומספר פלחים לסוגי הפעילויות השונים. לדוגמה, אם הם עשו קצת קיט אגרוף ואגרוף במהלך שיעור באומנויות לחימה משולבות, צרו מפגש לאומנויות לחימה משולבות. לאחר מכן אפשר לחלק את סוגי הפעילויות השונים לפלחים.

לכל נקודה על הגרף צריכות להיות שעת התחלה ושעת סיום. נקודות על הגרף לא צריכות להיות צמודות אחת לשנייה או ישירות זו אחר זו, יכולים להיות פערים ביניהן.

REST

שם	`com.google.activity.segment`
היקפי ההרשאות של OAuth	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
שדות (פורמט – יחידות)	סוג פעילות (`int`—enum) סוג הפעילות שהמשתמש ביצע. כאן אפשר לראות את הרשימה של סוגי הפעילות.

Android

שם	`com.google.activity.segment`
אובייקט סוג נתונים	`TYPE_ACTIVITY_SEGMENT`
הרשאה ב-Android	`ACTIVITY_RECOGNITION`
שדות (פורמט – יחידה)	FIELD_ACTIVITY (`int`—טיפוסים) סוג הפעילות שהמשתמש ביצע. כאן אפשר לראות את הרשימה של סוגי הפעילות.

קצב חילוף החומרים הבסיסי (BMR)

סוג הנתונים הזה מתעד את ה-BMR של המשתמש, בקלוריות. כל נקודת נתונים מייצגת את מספר הקלוריות שמשתמש ישרף אם הוא היה במנוחה כל היום, על סמך הגובה והמשקל שלו. צריך להגדיר רק את שעת הסיום. הערך הזה ישמש כחותמת הזמן של המדידה.

REST

שם	`com.google.calories.bmr`
היקפי ההרשאות של OAuth	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
שדות (פורמט – יחידות)	קלוריות (`float` - קלוריות ליום) מספר הקלוריות שמשתמש ישרף אם הוא היה במנוחה כל היום, על סמך הגובה והמשקל שלו.

Android

שם	`com.google.calories.bmr`
אובייקט סוג נתונים	`TYPE_BASAL_METABOLIC_RATE`
שדות (פורמט – יחידות)	FIELD_CALORIES (`float` – קלוריות ליום) מספר הקלוריות שמשתמש ישרף אם הוא היה במנוחה כל היום, על סמך הגיל, המשקל והגובה שלו.

קלוריות שנשרפו

סוג הנתונים הזה מתעד את סך הקלוריות (בקלוריות) שנשרף על ידי המשתמש, כולל הקלוריות שנשרפו במנוחה (BMR). כל נקודה על הגרף מייצגת את סך הקלוריות שנשרפו בפרק זמן מסוים, כך שיש להגדיר גם את שעת ההתחלה וגם את שעת הסיום.

REST

שם	`com.google.calories.expended`
היקפי ההרשאות של OAuth	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
שדות (פורמט – יחידות)	קלוריות (`float` - קלוריות) מספר הקלוריות שנשרפו.

Android

שם	`com.google.calories.expended`
אובייקט סוג נתונים	`TYPE_CALORIES_EXPENDED`
הרשאה ב-Android	`ACTIVITY_RECOGNITION`
שדות (פורמט – יחידות)	FIELD_CALORIES (`float` – קלוריות) מספר הקלוריות שנשרפו.

קצב הדיווש ברכיבה

אם משתמש רוכב על אופניים, אפשר להשתמש בסוג הנתונים הזה כדי לתעד את קצב הדיווש, בסיבובי הדרגה לדקה (RPM). כל נקודה על הגרף מייצגת מדידה מיידית של קצב הדיווש, ולכן צריך להגדיר רק את שעת הסיום. זו תשמש כחותמת הזמן של המדידה.

REST

שם	`com.google.cycling.pedaling.cadence`
היקפי ההרשאות של OAuth	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
שדות (פורמט – יחידות)	rpm (`float`—rpm) מספר סיבובי ידית האופניים לדקה.

Android

שם	`com.google.cycling.pedaling.cadence`
אובייקט סוג נתונים	`TYPE_CYCLING_PEDALING_CADENCE`
שדות (פורמט – יחידות)	FIELD_RPM (`float` - סל"ד) מספר סיבובי ידית האופניים לדקה.

רכיבה על אופניים מצטבר

אם משתמש רוכב על אופניים, אפשר להשתמש בסוג הנתונים הזה כדי לתעד את מספר סיבובי המכונות בפרק זמן מסוים. כל נקודה על הגרף מייצגת את מספר הסיבובים מאז הספירה בנקודת ההתחלה.

REST

שם	`com.google.cycling.pedaling.cumulative`
היקפי ההרשאות של OAuth	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
שדות (פורמט – יחידות)	revolutions (`int`—count) מספר סיבובי ידית האופניים במהלך תקופה מסוימת.

Android

שם	`com.google.cycling.pedaling.cumulative`
אובייקט סוג נתונים	`TYPE_CYCLING_PEDALING_CUMULATIVE`
שדות (פורמט – יחידות)	FIELD_REVOLUTIONS (`int` – ספירה) מספר סיבובי ידית האופניים במהלך תקופה מסוימת.

דק' אימון קרדיו

בסוג הנתונים הזה מוצג מספר דק' אימון קרדיו שמשתמש צבר, מכל הפעילות שלו. כל נקודה על הגרף מייצגת את המספר של דק' אימון קרדיו שמחושבות עבור פרק זמן מסוים.

משתמשים יכולים להגדיר יעד יומי של דק' אימון קרדיו ולעקוב אחר ההתקדמות שלהם. אפשר לחשב דק' אימון קרדיו לפי הפרטים הבאים:

מספר דק' אימון הקרדיו שנצברו תלוי באינטנסיביות של הפעילות. השתמשו במדריך הזה כדי לחשב ולכתוב דק' אימון קרדיו:

נתונים	1 HP (פעילות בעצימות נמוכה)	2 יחסי HP (פעילות בעצימות גבוהה)
דופק	דקת פעילות אחת בקצב לב של יותר מ-50%	דקת פעילות אחת בדופק מקסימלי של יותר מ-70%
ערך MET	3-6 MET. לדוגמה, חתירה או טיפוס צוקים,	>6 MET. לדוגמה: היט (HIIT), סקי, כדורעף או כדורגל.
מהירות ההליכה	100-130 צעדים בדקה	יותר מ-130 צעדים בדקה

REST

שם	`com.google.heart_minutes`
היקפי ההרשאות של OAuth	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
שדות (פורמט – יחידות)	intensity (`float` – נקודות לב) דק' אימון קרדיו שנצברו על סמך אינטנסיביות הפעילות הגופנית או הפעילות הגופנית שהמשתמש מבצע.

Android

שם	`com.google.heart_minutes`
אובייקט סוג נתונים	`TYPE_HEART_MINUTES`
שדות (פורמט – יחידות)	FIELD_INTENSITY (`float` – נקודות לב) אינטנסיביות הפעילות או הפעילות הגופנית שהמשתמש מבצע. דקה אחת של פעילות גופנית קלה עד בינונית (כמו הליכה מהירה יותר מ-4.5 קמ"ש, או רכיבה על אופניים מהר יותר מ-10 מייל לשעה) תרוויח דקה אחת של אימון קרדיו. דקה אחת של פעילות אינטנסיבית יותר מזכה אותך ב-2 נקודות על פעילות לב.

דק' פעילות

בסוג הנתונים הזה, המערכת מחשבת את מספר דקות הפעילות שמשתמש צבר מכל הפעילות שלו. כל נקודה על הגרף מייצגת את המספר הנגזר של דקות פעילות עבור פרק זמן מסוים. צריך להגדיר גם שעת התחלה וגם שעת סיום.

משתמשים יכולים לצבור דקות פעילות מכל פעילות כמו יוגה, ריקוד או גינון, ומשימות בית אחרות. אם הם יוצאים להליכה, Google Fit מעניקה 'דקת פעילות אחת' בכל פעם שהם הולכים 30 צעדים לפחות בתוך 60 שניות.

REST

שם	`com.google.active_minutes`
היקפי ההרשאות של OAuth	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
שדות (פורמט – יחידות)	duration (`int` - אלפיות שנייה) משך הזמן של 'דקות פעילות', באלפיות השנייה. טווח חוקי: >=0

Android

שם	`com.google.active_minutes`
אובייקט סוג נתונים	`TYPE_MOVE_MINUTES`
שדות (פורמט – יחידות)	FIELD_DURATION (`int` - אלפיות שנייה) משך הזמן של 'דקות פעילות', באלפיות השנייה. טווח חוקי: 0 — ארוך.MAX_VALUE

עוצמה

סוג הנתונים הזה מתעד את ההספק שנוצר על ידי המשתמש בזמן ביצוע פעילות, שנמדדת בוואט. לדוגמה, שימוש במד מתח בזמן פעילות גופנית על אופניים נייחים. כל נקודה על הגרף מייצגת מדידה מיידית של כוח שנוצר.

כל נקודה על הגרף מייצגת מדד מיידי של אנרגיה המיוצרת, לכן יש להגדיר רק את שעת הסיום. זו תשמש כחותמת הזמן של המדידה.

REST

שם	`com.google.power.sample`
היקפי ההרשאות של OAuth	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
שדות (פורמט – יחידות)	watts (`float` – ואט) הספק נוצר בוואט.

Android

שם	`com.google.power.sample`
אובייקט סוג נתונים	`TYPE_POWER_SAMPLE`
שדות (פורמט – יחידות)	FIELD_WATTS (`float` – ואט) הספק נוצר בוואט.

קצב ספירת הצעדים

סוג הנתונים הזה לוכד את קצב ההליכה, שנמדד לפי מספר הצעדים לדקה. כל נקודה על הגרף מייצגת מדידה מיידית של קצב הצעדים לדקה.

REST

שם	`com.google.step_count.cadence`
היקפי ההרשאות של OAuth	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
שדות (פורמט – יחידות)	rpm (`float` – צעדים/דקה) הקצב נמדד לפי מספר הצעדים בדקה.

Android

שם	`com.google.step_count.cadence`
אובייקט סוג נתונים	`TYPE_STEP_COUNT_CADENCE`
שדות (פורמט – יחידות)	FIELD_RPM (`float` – צעדים לדקה) הקצב נמדד לפי מספר הצעדים בדקה.

דלתא של ספירת צעדים

סוג הנתונים הזה מתעד את מספר השלבים שבוצעו מאז הקריאה האחרונה. כל שלב מדווח רק פעם אחת, כך שלנקודות על הגרף לא אמור להיות זמן חופף. שעת ההתחלה של כל נקודה על הגרף צריכה לייצג את תחילת מרווח הזמן שבו בוצעו הפעולות.

שעת ההתחלה צריכה להיות זהה לשעת הסיום של הנקודה הקודמת על הגרף או מאוחרת ממנה. חיבור כל הערכים יחד למשך תקופת זמן מסוימת מחשב את מספר השלבים הכולל במהלך אותה תקופה.

REST

שם com.google.step_count.delta

היקפי ההרשאות של OAuth

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

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

שדות (פורמט – יחידות)

שלבים (int - ספירה)

מספר הצעדים שבוצעו במהלך תקופת זמן.

טווח חוקי: 0 עד 10 צעדים לשנייה

Android

שם com.google.step_count.delta

אובייקט סוג נתונים TYPE_STEP_COUNT_DELTA

הרשאה ב-Android ACTIVITY_RECOGNITION

שדות (פורמט – יחידות)

TYPE_STEP_COUNT_DELTA (int – ספירה)

מספר הצעדים שבוצעו במהלך תקופת זמן.

טווח חוקי: 0 עד 10 צעדים לשנייה

מוזיקה לאימון

כל נקודה על הגרף מייצגת קבוצה מתמשכת של תרגיל אימון שביצע המשתמש. הנקודה על הגרף מכילה שדות לסוג התרגול (למשל תרגילי התנגדות או אימון משקולות), מספר החזרות על התרגיל, משך התרגיל וההתנגדות.

REST

שם 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 - ק"ג)

ההתנגדות של התרגיל (או המשקל), בקילוגרמים.

duration (int - אלפיות שנייה)

משך התרגיל שיש לו חשיבות למשך הזמן.

Android

שם 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 – ספירה)

מספר החזרות של התרגיל.

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 - אלפיות שנייה)

משך התרגיל שיש לו חשיבות למשך הזמן.