ממשקי ה-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` – enum) סוג הפעילות שהמשתמש ביצע. כאן מפורטת רשימה של סוגי הפעילות.

קצב מטבולי בסיסי (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`—rpm) מספר סיבובי ידית האופניים בדקה.

דוושות ברכיבה על אופניים

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

REST

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

Android

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

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

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

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

דופק
ערכי Metabolic Equivalent of Task (MET)
מהירות הליכה

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

נתונים	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
שדות (פורמט, יחידות)	עוצמה (`float` – נקודות לב) דק' אימון קרדיו שנצברו על סמך העוצמה של התרגיל או הפעילות שהמשתמש מבצע.

Android

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

דקות פעילות

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

המשתמשים יכולים לצבור דקות פעילות מכל פעילות כמו יוגה, ריקוד או גינון ומטלות ביתיות אחרות. אם הם יוצאים להליכה, אפליקציית 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
שדות (פורמט, יחידות)	וואטים (`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 – אלפיות שנייה)

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