سيتم إيقاف واجهات برمجة تطبيقات Google Fit نهائيًا في عام 2026، بما في ذلك واجهة برمجة التطبيقات Google Fit REST API. اعتبارًا من 1 أيار (مايو) 2024، لن يتمكّن المطوّرون من الاشتراك لاستخدام واجهات برمجة التطبيقات هذه.

للحصول على تعليمات حول واجهة برمجة التطبيقات أو المنصة التي تريد نقل البيانات إليها، يُرجى الانتقال إلى دليل نقل البيانات في Health Connect. للاطّلاع على مقارنة بين Health Connect وGoogle Fit API وFitbit Web API، يُرجى الانتقال إلى دليل مقارنة Health Connect.

مزيد من المعلومات حول Health Connect وكيفية الدمج مع واجهة برمجة التطبيقات

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

أنواع بيانات النشاط

يمكن استخدام أنواع البيانات هذه لتسجيل الأنشطة والتمارين الرياضية والمقاييس المتعلقة بالتمارين.

النشاط

يمكن استخدام نوع البيانات هذا لتسجيل أي نشاط يجريه المستخدم. ويمكن أن يشمل ذلك أنشطة اللياقة البدنية الشائعة، مثل الجري أو الرياضات المختلفة، بالإضافة إلى أنشطة مثل التأمّل والبستنة والنوم.

إذا كان المستخدِم ينفّذ أكثر من نشاط واحد خلال تلك الفترة الزمنية، أنشئ جلسة لنوع النشاط الرئيسي، وعدّة شرائح لأنواع الأنشطة المختلفة. على سبيل المثال، إذا مارسوا بعض تمارين الملاكمة والركل خلال حصة فنون قتالية مختلطة، أنشئ جلسة فنون قتالية مختلطة. يمكنك بعد ذلك تقسيم أنواع الأنشطة المختلفة إلى شرائح.

يجب أن تتضمّن كل نقطة بيانات وقت بدء ووقت انتهاء. لا يلزم أن تكون نقاط البيانات متتالية أو مباشرة بعد بعضها البعض، بل يمكن أن تكون هناك فجوات بينها.

REST

الاسم	`com.google.activity.segment`
نطاقات أذونات OAuth	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
الحقول (التنسيق—الوحدات)	نوع النشاط (`int`—تعداد) نوع النشاط الذي كان يمارسه المستخدم. يمكنك الاطّلاع على قائمة أنواع الأنشطة هنا.

Android

الاسم	`com.google.activity.segment`
عنصر نوع البيانات	`TYPE_ACTIVITY_SEGMENT`
إذن Android	`ACTIVITY_RECOGNITION`
الحقول (التنسيق—الوحدة)	FIELD_ACTIVITY (`int`—تعداد) نوع النشاط الذي كان يمارسه المستخدم. يمكنك الاطّلاع على قائمة أنواع الأنشطة هنا.

معدل الأيض الأساسي (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`—كيلو كالوري في اليوم) تمثّل هذه السمة عدد الكيلو سعرات الحرارية التي يحرقها المستخدم أثناء الراحة طوال اليوم، وذلك استنادًا إلى عمره ووزنه وطوله.

السعرات الحرارية المحروقة

يلتقط نوع البيانات هذا إجمالي السعرات الحرارية (بالكيلو كالوري) التي حرقها المستخدم، بما في ذلك السعرات الحرارية المحروقة أثناء الراحة (معدل الأيض الأساسي). تمثّل كل نقطة بيانات إجمالي السعرات الحرارية المحروقة خلال فاصل زمني، لذا يجب ضبط وقتَي البدء والانتهاء.

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`—كيلو كالوري) عدد الكيلو سعرات الحرارية المحروقة

إيقاع ركوب الدرّاجة

إذا كان المستخدم يمارس رياضة ركوب الدراجات، يمكن استخدام نوع البيانات هذا لتسجيل معدّل تحريك دوّاسة القدم، وذلك بعدد دورات ذراع التدوير في الدقيقة. تمثّل كل نقطة بيانات مقياسًا فوريًا لمعدّل الدواسة، لذا يجب ضبط وقت الانتهاء فقط. سيتم استخدام هذا الطابع الزمني للقراءة.

REST

الاسم	`com.google.cycling.pedaling.cadence`
نطاقات أذونات OAuth	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
الحقول (التنسيق—الوحدات)	عدد الدورات في الدقيقة (`float` دورة في الدقيقة) عدد دورات ذراع تدوير الدرّاجة في الدقيقة

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
الحقول (التنسيق—الوحدات)	الثورات (`int`—العدد) عدد دورات ذراع تدوير الدراجة خلال فترة زمنية معيّنة

Android

الاسم	`com.google.cycling.pedaling.cumulative`
عنصر نوع البيانات	`TYPE_CYCLING_PEDALING_CUMULATIVE`
الحقول (التنسيق—الوحدات)	‫FIELD_REVOLUTIONS (`int`—عدد) عدد دورات ذراع تدوير الدراجة خلال فترة زمنية معيّنة

نقاط القلب

يلتقط نوع البيانات هذا عدد "نقاط القلب" التي حصل عليها المستخدم من جميع أنشطته. تمثّل كل نقطة بيانات عدد نقاط القلب المحسوبة لفترة زمنية.

يمكن للمستخدمين تحديد هدف يومي لمعدل "نقاط القلب" وتتبُّع مستوى تقدّمهم. يمكن احتساب "نقاط القلب" باستخدام:

معدّل نبضات القلب
قيم المكافئ الأيضي (MET)
سرعة المشي

يعتمد عدد "نقاط القلب" التي يتم الحصول عليها على شدة النشاط. استخدِم هذا الدليل لاحتساب "نقاط القلب" وكتابتها:

البيانات	‫1 حصان (نشاط منخفض إلى متوسط الشدة)	‫2 HP (نشاط عالي الكثافة)
معدّل نبضات القلب	دقيقة واحدة من النشاط بمعدّل نبضات أعلى من ‎50% من الحدّ الأقصى	دقيقة واحدة من النشاط بمعدّل نبضات القلب أعلى من ‎70% من الحدّ الأقصى
قيمة MET	‫3-6 MET. على سبيل المثال، التجديف أو تسلّق الصخور،	>6 MET. على سبيل المثال، التمارين العالية الشدة أو التزلّج أو كرة الطائرة أو كرة القدم
سرعة المشي	من 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 كيلومترات في الساعة أو ركوب الدراجة بسرعة تزيد عن 16 كيلومترًا في الساعة)، ستحصل على نقطة قلب واحدة. مقابل كل دقيقة من أي نشاط بدني أشد تمارسه، ستحصل على نقطتين من "نقاط القلب".

دقائق الحركة

يلتقط نوع البيانات هذا عدد "دقائق الحركة" التي يحتسبها 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
الحقول (التنسيق—الوحدات)	المدة (`int`—بالمللي ثانية) مدة "دقائق الحركة" التي تمّ إحرازها، بالمللي ثانية النطاق الصحيح: >=0

Android

الاسم	`com.google.active_minutes`
عنصر نوع البيانات	`TYPE_MOVE_MINUTES`
الحقول (التنسيق—الوحدات)	‫FIELD_DURATION (`int`—بالمللي ثانية) مدة "دقائق الحركة" التي تمّ إحرازها، بالمللي ثانية النطاق الصالح: 0—Long.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
الحقول (التنسيق—الوحدات)	عدد الدورات في الدقيقة (`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—count)

عدد الخطوات التي تم اتّخاذها خلال فترة زمنية معيّنة

النطاق الصالح: من 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—تعداد)

قيم تمثّل تمارين مختلفة، مثل تمارين رفع الأثقال وتمارين تقوية العضلات وتمارين القلب والأوعية الدموية

القيم المقبولة

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—تعداد)

عدد مرّات تكرار التمرين

نوع المقاومة (int—تعداد)

نوع المقاومة المُستخدَمة أثناء التمرين

القيم المقبولة

"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—بالمللي ثانية)

مدة التمرين الذي تكون المدة فيه مهمة.

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—بالمللي ثانية)

مدة التمرين الذي تكون المدة فيه مهمة.

أنواع بيانات النشاط تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

النشاط

REST

Android

معدل الأيض الأساسي (BMR)

REST

Android

السعرات الحرارية المحروقة

REST

Android

إيقاع ركوب الدرّاجة

REST

Android

إجمالي إيقاع ركوب الدرّاجة

REST

Android

نقاط القلب

REST

Android

دقائق الحركة

REST

Android

الطاقة

REST

Android

إيقاع عدد الخطوات

REST

Android

تغيُّر عدد الخطوات

REST

Android

تمرين

REST

Android

أنواع بيانات النشاط