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

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

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

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

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

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

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

راحة

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

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

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

راحة

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

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

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

راحة

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

Android

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

نقاط القلب

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

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

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

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

البيانات	حصان واحد (نشاط منخفض إلى متوسط الكثافة)	2 حصان (نشاط شديد شديد)
معدّل نبضات القلب	دقيقة واحدة من النشاط عند الوصول إلى أكثر من% 50 من معدّل نبضات القلب كحد أقصى	دقيقة واحدة من النشاط بمعدل أكبر من% 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` - نقاط القلب) نقاط القلب التي يتم كسبها استنادًا إلى شدة التمارين الرياضية أو النشاط الذي يمارسه المستخدم

Android

الاسم	`com.google.heart_minutes`
كائن نوع البيانات	`TYPE_HEART_MINUTES`
الحقول (التنسيق - الوحدات)	‫FIELD_INTENSITY (`float`—نقاط القلب) شدة التمارين أو النشاط الذي يمارسه المستخدم يمكنك الحصول على "نقطة قلب" واحدة مقابل كل دقيقة من النشاط البدني الخفيف إلى المتوسط (مثل المشي بسرعة تزيد عن 4 كيلومتر في الساعة أو ركوب الدراجة بسرعة تزيد عن 16 كيلومتر في الساعة). يمكنك الحصول على نقطتَي قلب مقابل دقيقة واحدة من النشاط المكثّف.

دقائق الحركة

يسجِّل نوع البيانات هذا عدد دقائق النشاط التي يحتسبها تطبيق 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 — طويل.MAX_VALUE

الطاقة

يسجِّل هذا النوع من البيانات الطاقة التي يولدها المستخدم عند ممارسة نشاط معيّن، ويُقاس ذلك بالواط. على سبيل المثال، يمكن استخدام عداد الطاقة عند ممارسة التمارين على دراجة ثابتة. تمثّل كل نقطة بيانات قياسًا فوريًا لشدّة الطاقة التي يتم توليدها.

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

راحة

الاسم	`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` — واط) الطاقة المُولدة، بالواط

وتيرة عدد الخطوات

يرصد نوع البيانات هذا إيقاع المشي، ويتم قياسه بعدد الخطوات في الدقيقة. على كل تمثل نقطة البيانات قياسًا فوريًا لوتيرة الخطوات في دقيقة.

راحة

الاسم	`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`—خطوة في الدقيقة) يتم قياس الإيقاع بعدد الخطوات في الدقيقة.

فرق عدد الخطوات

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

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

راحة

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

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

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

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

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

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

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

تمثّل هذه السمة مقاومة التمرين (أو الوزن) بالكيلوغرام.

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

مدّة التمرين التي تُعدّ مُهمّة.