إنّ واجهات برمجة تطبيقات Google Fit، بما في ذلك Google Fit REST API، لن تعود متاحة بعد 30 حزيران (يونيو) 2025. اعتبارًا من 1 أيار (مايو) 2024، لن يتمكّن المطوّرون من الاشتراك لاستخدام واجهات برمجة التطبيقات هذه.
للحصول على تعليمات حول واجهة برمجة التطبيقات أو المنصة المطلوب نقل البيانات إليها، انتقِل إلى دليل نقل البيانات إلى Health Connect. للمقارنة بين Health Connect وواجهات برمجة تطبيقات Google Fit وواجهات برمجة تطبيقات الويب Fitbit، يُرجى الانتقال إلى دليل المقارنة في Health Connect.
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
بالنسبة إلى البيانات التي يمكن تسجيلها باستمرار (مع وجود نقاط بيانات متعددة خلال فترة زمنية)، يمكن لنظام Google Fit تجميع هذه البيانات وعرض النتائج المحسوبة. يمكن أن تكون القيمة عبارة عن متوسط قياس أو ملخص/إجمالي. يمكنك توفير الوقت في هذه العمليات الحسابية وعرض ملخصات أو متوسطات مفيدة لمستخدمي التطبيق بسهولة من خلال قراءة البيانات المجمّعة.
لقراءة البيانات المجمعة، تحتاج إلى اختيار نوع البيانات والنطاق الزمني وشيء
"لتجميع" (أو تجميع) البيانات وفقًا لها. يمكنك تجميع البيانات بعدة طرق مختلفة:
الفترة الزمنية
مجموعة البيانات المجمّعة حسب كل ساعة أو في اليوم على سبيل المثال، يمكنك الاطّلاع على عدد الخطوات أو السعرات الحرارية التي تم حرقها في اليوم.
نوع النشاط
مجموعة البيانات المجمّعة حسب نوع النشاط على سبيل المثال، بالنسبة إلى بيانات النوم لأكثر من أسبوع، ستكون هناك مجموعة بيانات لكل نوع من أنواع أنشطة النوم (الخفيف والعميق وحركة العين السريعة).
نوع النشاط
مجموعة البيانات المجمّعة حسب شرائح النشاط خلال فترة زمنية معيّنة على سبيل المثال، إذا مارس المستخدم الجري بين الساعة 9 صباحًا و10 صباحًا، لكنّه ركض خلال أول 20 دقيقة، وجلس لمدة 10 دقائق ومشي لمدة 15 دقيقة وركض لمدة 15 دقيقة، سيتم اعتبار هذه الشرائح 4 شرائح نشاط وستظهر 4 مجموعات.
الجلسة
استخدِم الحدود الزمنية للجلسات معًا لتجميع البيانات. على سبيل المثال، إذا ذهب المستخدم في جريتين تم تسجيلهما كجلستين (جري في الصباح وركض بعد الظهر)، يمكنك تجميع البيانات حسب الجلسة لمعرفة متوسط الخطوات أو متوسط السرعة لكل جري.
النشاط
استخدم أنواع البيانات هذه لقراءة بيانات الصحة والعافية المجمعة.
ملخص النشاط
إجمالي الوقت وعدد الشرائح لنشاط معين خلال فترة زمنية.
وتمثل كل نقطة بيانات ملخصًا لجميع شرائح النشاط لنوع نشاط معين خلال فترة زمنية.
نوع النشاط الذي كان ينفّذه المستخدم. يمكنك الاطّلاع على قائمة أنواع الأنشطة هنا.
duration (int—مللي ثانية)
إجمالي الوقت المستغرق في نشاط في جميع الشرائح في النطاق الزمني.
عدد الشرائح (int - العدد)
عدد شرائح النشاط المختلفة خلال الفترة الزمنية لنقطة البيانات هذه.
Android
الاسم
com.google.activity.summary
كائن نوع البيانات
AGGREGATE_ACTIVITY_SUMMARY
الحقول (التنسيق—الوحدات)
FIELD_ACTIVITY (int—تعداد)
نوع النشاط الذي كان ينفّذه المستخدم. يمكنك الاطّلاع على قائمة أنواع الأنشطة هنا.
FIELD_DURATION (int—ملي ثانية)
إجمالي الوقت المستغرق في نشاط في جميع الشرائح في النطاق الزمني.
FIELD_NUM_SEGMENTS (عدد مرات الظهور: int)
عدد شرائح النشاط المختلفة خلال الفترة الزمنية لنقطة البيانات هذه.
ملخّص معدّل الأيض الأساسي (BMR)
تمثل كل نقطة بيانات متوسط الحد الأقصى والحدّ الأدنى لمعدل الأيض الأساسي للمستخدم خلال النطاق الزمني، بالكيلو سعرات الحرارية في اليوم. يكون هذا مفيدًا إذا اكتسب المستخدم وزنه
أو فقده وبالتالي تغير معدل BMR لديه.
تشير إلى عدد "نقاط القلب" التي تم الحصول عليها خلال الفترة الزمنية،
بما في ذلك النقاط التي تم الحصول عليها من خلال المُضاعِفات (عدد النقاط المكتسَبة مقابل
نشاط أكثر جهدًا).
duration (float—دقيقة)
الوقت الذي تم فيه تحقيق "نقاط القلب"، ويتم قياسه بالدقائق.
Android
الاسم
com.google.heart_minutes.summary
كائن نوع البيانات
AGGREGATE_HEART_POINTS
الحقول (التنسيق—الوحدات)
FIELD_INTENSITY (float: نقاط القلب)
تشير إلى عدد "نقاط القلب" التي تم الحصول عليها خلال الفترة الزمنية،
بما في ذلك النقاط التي تم الحصول عليها من خلال المُضاعِفات (عدد النقاط المكتسَبة مقابل
نشاط أكثر جهدًا).
FIELD_DURATION (float — دقيقة)
الوقت الذي تم فيه تحقيق "نقاط القلب"، ويتم قياسه بالدقائق.
ملخّص "دقائق الحركة"
إجمالي عدد دقائق الحركة خلال الفترة الزمنية نوع البيانات والحقول هذا مماثل
لـ نوع البيانات الفورية.
ملخّص الطاقة
تمثل كل نقطة بيانات متوسط الحد الأقصى والحد الأدنى من الطاقة الناتجة عن المستخدم بالواط، خلال فترة زمنية.
متوسط الطاقة الناتجة عن المستخدم خلال الفترة الزمنية بالواط
max (float—واط)
الحد الأقصى للطاقة الناتجة عن المستخدِم خلال الفترة الزمنية بالواط
min (float—واط)
الحدّ الأدنى لطاقة المستخدِم المُنشأة خلال الفترة الزمنية بالواط
Android
الاسم
com.google.power.summary
كائن نوع البيانات
AGGREGATE_POWER_SUMMARY
الحقول (التنسيق—الوحدات)
FIELD_AVERAGE (float—واط)
متوسط الطاقة الناتجة عن المستخدم خلال الفترة الزمنية بالواط
FIELD_MAX (float—واط)
الحد الأقصى للطاقة الناتجة عن المستخدِم خلال الفترة الزمنية بالواط
FIELD_MIN (float—واط)
الحدّ الأدنى لطاقة المستخدِم المُنشأة خلال الفترة الزمنية بالواط
ملخص دلتا لعدد الخطوات
وتمثل كل نقطة بيانات العدد الإجمالي للخطوات خلال الفترة الزمنية.
نوع البيانات هذا وحقوله يماثل نوع البيانات الفورية.
النص الأساسي
استخدِم أنواع البيانات هذه لقراءة بيانات قياس الجسم المجمَّعة.
ملخص نسبة الدهون في الجسم
تمثل كل نقطة بيانات متوسط نسبة الدهون في الجسم والحد الأقصى والحد الأدنى للمستخدم
خلال فترة زمنية.
راحة
الاسم
com.google.body.fat.percentage.summary
نطاقات أذونات OAuth
https://www.googleapis.com/auth/fitness.body.read
الحقول (التنسيق—الوحدات)
المتوسط (float—نسبة مئوية)
يشير ذلك إلى متوسط النسبة المئوية لإجمالي كتلة الجسم التي تشكّل دهون الجسم خلال فترة زمنية معيّنة.
max (float—percent)
الحد الأقصى للنسبة المئوية لإجمالي كتلة الجسم التي تشكّل دهون الجسم خلال فترة زمنية معيّنة
min (float—%)
يشير ذلك المصطلح إلى الحد الأدنى للنسبة المئوية لإجمالي كتلة الجسم التي تمثّل دهون الجسم خلال فترة زمنية معيّنة.
Android
الاسم
com.google.body.fat.percentage.summary
كائن نوع البيانات
AGGREGATE_BODY_FAT_PERCENTAGE_SUMMARY
الحقول (التنسيق—الوحدات)
FIELD_AVERAGE (float: النسبة المئوية)
يشير ذلك إلى متوسط النسبة المئوية لإجمالي كتلة الجسم التي تشكّل دهون الجسم خلال فترة زمنية معيّنة.
FIELD_MAX (float—نسبة مئوية)
الحد الأقصى للنسبة المئوية لإجمالي كتلة الجسم التي تشكّل دهون الجسم خلال فترة زمنية معيّنة
FIELD_MIN (float—نسبة مئوية)
يشير ذلك المصطلح إلى الحد الأدنى للنسبة المئوية لإجمالي كتلة الجسم التي تمثّل دهون الجسم خلال فترة زمنية معيّنة.
ملخّص معدّل نبضات القلب
تمثّل كل نقطة بيانات متوسط معدّل نبضات قلب المستخدم والحد الأقصى له والحدّ الأدنى له خلال الفترة الزمنية
بالنبضات في الدقيقة.
راحة
الاسم
com.google.heart_rate.summary
نطاقات أذونات OAuth
https://www.googleapis.com/auth/fitness.body.read
الحقول (التنسيق—الوحدات)
المتوسط (float — نبضة في الدقيقة)
متوسط معدّل نبضات القلب للمستخدم بالنبضات في الدقيقة خلال فترة زمنية.
max (float—bpm)
تشير هذه السمة إلى أعلى معدّل لنبضات القلب للمستخدم في الدقيقة خلال فترة زمنية معيّنة.
دقيقة (float — نبضة في الدقيقة)
تشير هذه السمة إلى الحد الأدنى لمعدّل نبضات قلب المستخدم بالنبضات في الدقيقة خلال فترة زمنية معيّنة.
Android
الاسم
com.google.heart_rate.summary
كائن نوع البيانات
AGGREGATE_HEART_RATE_SUMMARY
الحقول (التنسيق—الوحدات)
FIELD_AVERAGE (float — نبضة في الدقيقة)
متوسط معدّل نبضات القلب للمستخدم بالنبضات في الدقيقة خلال فترة زمنية.
FIELD_MAX (float — نبضة في الدقيقة)
تشير هذه السمة إلى أعلى معدّل لنبضات القلب للمستخدم في الدقيقة خلال فترة زمنية معيّنة.
FIELD_MIN (float — نبضة في الدقيقة)
تشير هذه السمة إلى الحد الأدنى لمعدّل نبضات قلب المستخدم بالنبضات في الدقيقة خلال فترة زمنية معيّنة.
ملخّص الارتفاع
تمثّل كل نقطة بيانات متوسط الطول والحد الأقصى والأدنى للمستخدم خلال فترة زمنية بالمتر.
راحة
الاسم
com.google.height.summary
نطاقات أذونات OAuth
https://www.googleapis.com/auth/fitness.body.read
الحقول (التنسيق—الوحدات)
المتوسط (float — متر)
متوسط طول المستخدم خلال فترة زمنية بالمتر.
max (float: متر)
الحد الأقصى لطول المستخدم خلال فترة زمنية بالمتر.
min (float—متر)
تشير هذه السمة إلى الحد الأدنى لطول المستخدم خلال فترة زمنية بالمتر.
Android
الاسم
com.google.height.summary
كائن نوع البيانات
AGGREGATE_HEIGHT_SUMMARY
الحقول (التنسيق—الوحدات)
FIELD_AVERAGE (float — متر)
متوسط طول المستخدم خلال فترة زمنية بالمتر.
FIELD_MAX (float — أمتار)
الحد الأقصى لطول المستخدم خلال فترة زمنية بالمتر.
FIELD_MIN (float — متر)
تشير هذه السمة إلى الحد الأدنى لطول المستخدم خلال فترة زمنية بالمتر.
ملخّص الوزن
تمثل كل نقطة بيانات متوسط وزن المستخدم والحد الأقصى له والحد الأدنى لوزنه خلال
فترة زمنية بالكيلوغرام.
راحة
الاسم
com.google.weight.summary
نطاقات أذونات OAuth
https://www.googleapis.com/auth/fitness.body.read
الحقول (التنسيق—الوحدات)
المتوسط (float—كجم)
متوسط وزن جسم المستخدم خلال فترة زمنية بالكيلوغرام.
max (float—kg)
الحد الأقصى لوزن الجسم للمستخدم خلال فترة زمنية معيّنة بالكيلوغرام.
min (float—kg)
الحد الأدنى لوزن جسم المستخدم خلال فترة زمنية بالكيلوغرام.
Android
الاسم
com.google.weight.summary
كائن نوع البيانات
AGGREGATE_WEIGHT_SUMMARY
الحقول (التنسيق—الوحدات)
FIELD_AVERAGE (float—كلغ)
متوسط وزن جسم المستخدم خلال فترة زمنية بالكيلوغرام.
FIELD_MAX (float—كيلوغرام)
الحد الأقصى لوزن الجسم للمستخدم خلال فترة زمنية معيّنة بالكيلوغرام.
FIELD_MIN (float—كجم)
الحد الأدنى لوزن جسم المستخدم خلال فترة زمنية بالكيلوغرام.
الموقع الجغرافي
استخدم أنواع البيانات هذه لقراءة بيانات الموقع المجمعة.
دلتا المسافة
تمثّل كل نقطة بيانات إجمالي المسافة التي يقطعها المستخدم خلال فترة زمنية بالمتر. نوع البيانات هذا وحقوله يماثل نوع البيانات الفورية.
مربّع حدود الموقع الجغرافي
تمثّل كل نقطة بيانات مربّع الحدود الذي تم احتسابه على نقاط الموقع الجغرافي للمستخدم خلال فترة زمنية. يحتوي كل مربع حدود على أربعة حقول
تمثل الزوايا الأربع لمربع الحدود.
متوسط سرعة المستخدم خلال فترة زمنية بالمتر في الثانية.
max (float: متر في الثانية)
الحد الأقصى لسرعة المستخدِم خلال فترة زمنية بالمتر في الثانية
دقيقة (float: متر في الثانية)
تشير هذه السمة إلى الحد الأدنى لسرعة المستخدِم خلال فترة زمنية بالمتر في الثانية.
Android
الاسم
com.google.speed.summary
كائن نوع البيانات
AGGREGATE_SPEED_SUMMARY
الحقول (التنسيق—الوحدات)
المتوسط (float: متر في الثانية)
متوسط سرعة المستخدم خلال فترة زمنية بالمتر في الثانية.
max (float: متر في الثانية)
الحد الأقصى لسرعة المستخدِم خلال فترة زمنية بالمتر في الثانية
دقيقة (float: متر في الثانية)
تشير هذه السمة إلى الحد الأدنى لسرعة المستخدِم خلال فترة زمنية بالمتر في الثانية.
التغذية
استخدِم أنواع البيانات هذه للاطّلاع على بيانات التغذية المجمّعة.
ملخّص عن مقدار شرب الماء
تمثل كل نقطة بيانات الحجم الإجمالي للمياه التي يستهلكها المستخدم خلال فترة زمنية، باللتر. نوع البيانات هذا وحقوله يماثل نوع البيانات الفورية.
ملخص التغذية
وتمثل كل نقطة بيانات مجموع جميع إدخالات التغذية خلال فترة زمنية.
في حقل المواد المغذية، تمثل كل قيمة مجموع المواد الغذائية عبر جميع الإدخالات خلال الفترة الزمنية.
وإذا لم يكن المغذّي مدرَجًا في أي من الإدخالات، لن يظهر أيضًا في الخريطة المجمّعة. إذا كانت جميع الإدخالات في الفترة الزمنية تخصّ الوجبة نفسها، سيتمّ أيضًا تحديد نوع الوجبة.
العناصر الغذائية (Map<String>: السعرات الحرارية/الجرام)
إجمالي العناصر الغذائية في الطعام الذي تم تناوله خلال فترة زمنية.
القيم المقبولة
"key": "calories" // Calories in kcal
"key": "fat.total" // Total fat in grams
"key": "fat.saturated" // Saturated fat in grams
"key": "fat.unsaturated" // Unsaturated fat in grams
"key": "fat.polyunsaturated" // Polyunsaturated fat in grams
"key": "fat.monounsaturated" // Monounsaturated fat in grams
"key": "fat.trans" // Trans fat in grams
"key": "cholesterol" // Cholesterol in milligrams
"key": "sodium" // Sodium in milligrams
"key": "potassium" // Potassium in milligrams
"key": "carbs.total" // Total carbohydrates in grams
"key": "dietary_fiber" // Dietary fiber in grams
"key": "sugar" // Amount of sugar in grams
"key": "protein" // Protein amount in grams
Android
الاسم
com.google.nutrition.summary
كائن نوع البيانات
AGGREGATE_NUTRITION_SUMMARY
الحقول (التنسيق—الوحدات)
FIELD_MEAL_TYPE (التعداد int)
نوع الوجبة التي تناولها المستخدم (متوفر إذا كانت جميع الإدخالات في الفترة الزمنية لتناول الوجبة نفسها)
FIELD_NUTRIENTS (Map<String>: كيلو سعر حراري/جرام/ملليغرام)
إجمالي العناصر الغذائية في الطعام الذي تم تناوله خلال فترة زمنية.
القيم المقبولة
NUTRIENT_CALORIES // Calories in kcal
NUTRIENT_TOTAL_FAT // Total fat in grams
NUTRIENT_SATURATED_FAT // Saturated fat in grams
NUTRIENT_UNSATURATED_FAT // Unsaturated fat in grams
NUTRIENT_POLYUNSATURATED_FAT // Polyunsaturated fat in grams
NUTRIENT_MONOUNSATURATED_FAT // Monounsaturated fat in grams
NUTRIENT_TRANS_FAT // Trans fat in grams
NUTRIENT_CHOLESTEROL // Cholesterol in milligrams
NUTRIENT_SODIUM // Sodium in milligrams
NUTRIENT_POTASSIUM // Potassium in milligrams
NUTRIENT_TOTAL_CARBS // Total carbohydrates in grams
NUTRIENT_DIETARY_FIBER // Dietary fiber in grams
NUTRIENT_SUGAR // Amount of sugar in grams
NUTRIENT_PROTEIN // Protein amount in grams
صحة
استخدِم أنواع البيانات هذه لقراءة البيانات الطبية والصحية المجمّعة.
ملخّص مستوى الغلوكوز في الدم
تمثّل كل نقطة بيانات متوسط أو الحد الأدنى والأقصى لمستوى الغلوكوز في الدم أو التركيز عليه على مدار النطاق الزمني، حيث يتم قياسه بالملي مول/لتر حيث يساوي 1 ميلي مول/لتر 18 ملي مول/لتر.
إذا كانت قيم كل حقل من هذه الحقول هي نفسها لجميع القياسات التي تم إجراؤها
خلال النطاق الزمني، ستظهر لك قيمة الحقل في البيانات التي يتم عرضها:
العلاقة الزمنية بالوجبة
العلاقة الزمنية بالنوم
مصدر العينة
إذا كانت القيم مختلفة على مستوى القياسات، سيتم استبعاد الحقل.
متوسط مستوى الغلوكوز في الدم أو التركيز لدى المستخدم خلال فترة زمنية
max (float—mmol/L)
الحد الأقصى لمستوى الغلوكوز في الدم أو لتركيز الدم لدى المستخدم خلال فترة زمنية
دقيقة (float — mmol/L)
الحد الأدنى لمستوى الغلوكوز في الدم أو التركيز خلال فترة زمنية
العلاقة الزمنية بالوجبة (int—enum) (حقل اختياري)
الوقت الذي تم فيه أخذ القراءة مقارنةً بالوقت الذي تناول فيه المستخدم.
القيم المقبولة
"intVal": 1 // Reading wasn't taken before or after a meal
"intVal": 2 // Reading was taken during a fasting period
"intVal": 3 // Reading was taken before a meal
"intVal": 4 // Reading was taken after a meal
meal type (int—enum) (حقل اختياري)
نوع الوجبة التي تناولها المستخدم عند إجراء القراءة.
الوقت الذي تم فيه إجراء القياس مقارنةً بوقت نوم المستخدم
القيم المقبولة
"intVal": 1 // User was fully awake
"intVal": 2 // Before the user fell asleep
"intVal": 3 // After the user woke up
"intVal": 4 // While the user was still sleeping
الوقت الذي تم فيه أخذ القراءة مقارنةً بالوقت الذي تناول فيه المستخدم.
القيم المقبولة
FIELD_TEMPORAL_RELATION_TO_MEAL_GENERAL // Reading wasn't taken before or after a meal
FIELD_TEMPORAL_RELATION_TO_MEAL_FASTING // Reading was taken during a fasting period
FIELD_TEMPORAL_RELATION_TO_MEAL_BEFORE_MEAL // Reading was taken before a meal
FIELD_TEMPORAL_RELATION_TO_MEAL_AFTER_MEAL // Reading was taken after a meal
FIELD_MEAL_TYPE (int—التعداد) (حقل اختياري)
نوع الوجبة التي تناولها المستخدم عند إجراء القراءة.
الوقت الذي تم فيه إجراء القياس مقارنةً بوقت نوم المستخدم
القيم المقبولة
TEMPORAL_RELATION_TO_SLEEP_FULLY_AWAKE // User was fully awake.
TEMPORAL_RELATION_TO_SLEEP_BEFORE_SLEEP // Before the user fell asleep.
TEMPORAL_RELATION_TO_SLEEP_ON_WAKING // After the user woke up.
TEMPORAL_RELATION_TO_SLEEP_DURING_SLEEP // While the user was still sleeping.
الحد الأدنى لضغط الدم الانبساطي لدى المستخدم خلال فترة زمنية
FIELD_BODY_POSITION (int—enum) (حقل اختياري)
وضعية جسم المستخدم عند إجراء القياس
القيم المقبولة
BODY_POSITION_STANDING // Standing up
BODY_POSITION_SITTING // Sitting down
BODY_POSITION_LYING_DOWN // Lying down
BODY_POSITION_SEMI_RECUMBENT // Reclining
BLOOD_PRESSURE_MEASUREMENT_LOCATION_LEFT_WRIST // Left wrist
BLOOD_PRESSURE_MEASUREMENT_LOCATION_RIGHT_WRIST // Right wrist
BLOOD_PRESSURE_MEASUREMENT_LOCATION_LEFT_UPPER_ARM // Left upper arm
BLOOD_PRESSURE_MEASUREMENT_LOCATION_RIGHT_UPPER_ARM // Right upper arm
ملخّص درجة حرارة الجسم
تمثل كل نقطة بيانات متوسط الحد الأدنى والحد الأقصى لدرجة حرارة الجسم
للمستخدم خلال نطاق زمني.
وستتضمّن أيضًا الموقع الجغرافي الذي تم إجراء القياس فيه على الجسم، إذا كان موقع القياس هو نفسه لجميع نقاط البيانات خلال الفترة الزمنية.