إنّ واجهات برمجة تطبيقات 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)

يسجّل هذا النوع من البيانات معدل نبضات القلب 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`—rpm) عدد دورات تدوير الدراجة في الدقيقة.

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

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

راحة

الاسم	`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)
سرعة المشي

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

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

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

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

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

resistance 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 — كيلوغرام)

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

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

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