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

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

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

تمت ترجمة هذه الصفحة بواسطة 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`—التعداد) نوع النشاط الذي كان ينفّذه المستخدم. يمكنك الاطّلاع على قائمة أنواع الأنشطة هنا.

Android

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

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

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

راحة

الاسم	`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). تمثل كل نقطة بيانات إجمالي السعرات الحرارية المحروقة خلال فاصل زمني، لذلك يجب تعيين وقتي البدء والانتهاء.

راحة

الاسم	`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). تمثل كل نقطة بيانات مقياسًا فوريًا لمعدل الدوران، لذلك يجب تعيين وقت الانتهاء فقط. سيتم استخدامه كطابع زمني للقراءة.

راحة

الاسم	`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`) عدد دورات ذراع الدراجة في الدقيقة.

ركوب الدرّاجة التراكمية

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

راحة

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

راحة

الاسم	`com.google.heart_minutes`
نطاقات أذونات OAuth	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
الحقول (التنسيق—الوحدات)	intenity (الكثافة) (`float`: نقطة لنشاط القلب) "نقاط القلب" التي يتم الحصول عليها استنادًا إلى شدة التمرين أو النشاط الذي يمارسه المستخدم.

Android

الاسم	`com.google.heart_minutes`
كائن نوع البيانات	`TYPE_HEART_MINUTES`
الحقول (التنسيق—الوحدات)	FIELD_INTENSITY (`float`: نقاط القلب) شدة التمرين أو النشاط الذي يمارسه المستخدم. يتم الحصول على نقطة قلب واحدة عند ممارسة نشاط بدني خفيف إلى متوسط (مثل المشي بسرعة أكبر من 2.5 ميل في الساعة أو ركوب الدراجة بسرعة أكبر من 10 ميل في الساعة). تؤدي دقيقة واحدة من النشاط المكثف إلى الحصول على نقطتين للقلب.

دقائق الحركة

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

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

Android

الاسم	`com.google.active_minutes`
كائن نوع البيانات	`TYPE_MOVE_MINUTES`
الحقول (التنسيق—الوحدات)	FIELD_DURATION (`int`—ملي ثانية) مدة "دقائق الحركة" المكتسَبة بالمللي ثانية النطاق الصالح: 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
الحقول (التنسيق—الوحدات)	watts (`float`—واط) الطاقة الناتجة بالواط

Android

الاسم	`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
الحقول (التنسيق—الوحدات)	rpm (`float`: خطوة/دقيقة) معدّل خطوات السير مُقاسًا بعدد الخطوات في الدقيقة.

Android

الاسم	`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

الحقول (التنسيق—الوحدات)

steps (عدد الخطوات: int)

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

النطاق الصالح: من 0 إلى 10 خطوات في الثانية

Android

الاسم com.google.step_count.delta

كائن نوع البيانات TYPE_STEP_COUNT_DELTA

إذن Android 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

الحقول (التنسيق—الوحدات)

exercise (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)

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

resstance type (نوع المقاومة) (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— kg)

مقاومة التمرين (أو الوزن)، بالكيلوغرام.

duration (int—مللي ثانية)

تمثّل هذه السمة مدة التمرين التي تكون مدّتها مهمة.

Android

الاسم com.google.activity.exercise

الحقول (التنسيق—الوحدات)

FIELD_EXERCISE (int—تعداد)

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

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

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)

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

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

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

تمثّل هذه السمة مدة التمرين التي تكون مدّتها مهمة.