إنّ واجهات برمجة تطبيقات Google Fit، بما في ذلك Google Fit REST API، لن تعود متاحة بعد 30 حزيران (يونيو) 2025. اعتبارًا من 1 أيار (مايو) 2024، لن يتمكّن المطوّرون من الاشتراك لاستخدام واجهات برمجة التطبيقات هذه.
للحصول على تعليمات حول واجهة برمجة التطبيقات أو المنصة المطلوب نقل البيانات إليها، انتقِل إلى دليل نقل البيانات إلى Health Connect. للمقارنة بين Health Connect وواجهات برمجة تطبيقات Google Fit وواجهات برمجة تطبيقات الويب Fitbit، يُرجى الانتقال إلى دليل المقارنة في Health Connect.
بالنسبة إلى البيانات التي يمكن تسجيلها بشكلٍ مستمر (باستخدام نقاط بيانات متعددة على مدار فترة زمنية معيّنة
)، فإن نظام Google Fit يمكنه تجميع هذه البيانات وعرض
النتائج المحسوبة. يمكن أن يكون متوسط قياس أو ملخص/إجمالي. إِنْتَ
توفير الوقت في هذه العمليات الحسابية وإظهار ملخصات مفيدة لمستخدمي التطبيق أو
المتوسطات بسهولة من خلال قراءة البيانات المجمعة.
لقراءة البيانات المجمّعة، تحتاج إلى اختيار نوع البيانات ونطاق زمني وشيء ما
إلى 'bucket' (حزمة) (أو تجميع) البيانات حسبها. يمكنك تجميع البيانات بعدة طرق مختلفة:
الفترة الزمنية
تجميع البيانات حسب الساعة أو اليوم. على سبيل المثال، يمكنك الاطّلاع على الخطوات أو السعرات الحرارية التي تم حرقها يوميًا.
نوع النشاط
مجموعة البيانات المجمّعة حسب نوع النشاط على سبيل المثال، بالنسبة إلى بيانات النوم التي تزيد عن أسبوع، ستكون هناك مجموعة بيانات لكل نوع من أنواع نشاط النوم (الخفيف والعميق وحركة العين السريعة).
قسم النشاط
تجميع البيانات المجمّعة حسب شرائح النشاط على مدار فترة زمنية معيّنة على سبيل المثال، إذا جري المستخدم في الفترة بين 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)
تمثّل كل نقطة بيانات متوسط معدّل الأيض الأساسي والأقصى والحد الأدنى له للمستخدم.
على مدار النطاق الزمني، بوحدات كيلو حرارية في اليوم. يكون هذا مفيدًا إذا كان لدى المستخدم
زيادة أو فقدان الوزن، وبالتالي تغير معدل نبضات قلبه.
هو عدد "نقاط القلب" التي حصلت عليها خلال الفترة الزمنية المحدّدة
بما في ذلك النقاط التي تم الحصول عليها بالمضاعفات (المزيد من النقاط التي يتم الحصول عليها
نشاطًا مجهدًا أكثر).
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 — نسبة مئوية)
متوسّط النسبة المئوية لإجمالي كتلة جسم المستخدم التي تشكّل دهون الجسم خلال فترة زمنية معيّنة
الحد الأقصى (float — نسبة مئوية)
الحدّ الأقصى للنسبة المئوية لإجمالي كتلة جسم المستخدم التي تمثّل دهون الجسم خلال فترة زمنية معيّنة.
دقيقة (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 — نبضة في الدقيقة)
متوسط معدّل نبضات قلب المستخدم بالنبضات في الدقيقة خلال فترة زمنية
الحدّ الأقصى (float — نبضة في الدقيقة)
الحد الأقصى لمعدّل نبضات القلب للمستخدم هو عدد النبضات في الدقيقة خلال فترة زمنية معيّنة.
دقيقة (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—كلغ)
الحد الأقصى لوزن جسم المستخدم خلال فترة زمنية بالكيلوغرام.
min (float—كلغ)
الحد الأدنى لوزن جسم المستخدم خلال فترة زمنية بالكيلوغرام.
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 — متر في الثانية)
الحد الأدنى للسرعة للمستخدم خلال فترة زمنية بالمتر في الثانية
تغذية
يمكنك استخدام أنواع البيانات هذه لقراءة بيانات التغذية المجمَّعة.
ملخّص معدّل الترطيب
تمثل كل نقطة بيانات الحجم الإجمالي للمياه التي يستهلكها المستخدم على مدار
الفترة الزمنية باللتر. نوع البيانات هذا وحقوله مماثلان لنوع البيانات
لنوع البيانات اللحظية.
ملخّص التغذية
تمثل كل نقطة بيانات مجموع إدخالات التغذية خلال فترة زمنية.
وفي مجال العناصر الغذائية، تمثل كل قيمة مجموع المغذيات على جميع
الإدخالات في الفترة الزمنية.
إذا لم يكن العنصر الغذائي في أي من الإدخالات، فلن يكون في الخريطة الإجمالية
أيضًا. إذا كانت جميع الإدخالات خلال الفترة الزمنية تشير إلى الوجبة نفسها، يتم تحديد نوع الوجبة.
سيتم تعيينه أيضًا.
إجمالي العناصر الغذائية في الطعام الذي تم تناوله خلال فترة زمنية.
القيم المقبولة
"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 — تعداد)
نوع الوجبة التي تناولها المستخدم (موجودة إذا كانت جميع الإدخالات في الفترة الزمنية لنفس الوجبة)
إجمالي العناصر الغذائية في الطعام الذي تم تناوله خلال فترة زمنية.
القيم المقبولة
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 ملي مول/لتر
ملغ/لتر
إذا كانت القيم الخاصة بكل حقل من هذه الحقول متطابقة لجميع القياسات التي تم أخذها
خلال النطاق الزمني، سترى قيمة الحقل في البيانات المعروضة:
العلاقة الزمنية بالوجبة
العلاقة الزمنية بالنوم
مصدر العينة
إذا كانت القيم مختلفة على مستوى القياسات، سيتم استبعاد الحقل.
متوسط مستوى الغلوكوز في الدم أو التركيز لدى المستخدم خلال فترة زمنية معيّنة
max (float—ملم مول/لتر)
الحد الأقصى لمستوى الغلوكوز في الدم أو تركيز المستخدم خلال فترة زمنية معيّنة
دقيقة (float—ملم مول/لتر)
الحد الأدنى لمستوى الغلوكوز في الدم أو تركيز المستخدم خلال فترة زمنية معيّنة
العلاقة الزمنية بالوجبة (int — تعداد) (حقل اختياري)
وقت إجراء القياس مقارنةً بوقت تناول المستخدم لتناول الطعام.
القيم المقبولة
"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) (حقل اختياري)
نوع الوجبة التي تناولها المستخدم عند إجراء القياس.
وقت إجراء القياس مقارنةً بوقت تناول المستخدم لتناول الطعام.
القيم المقبولة
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 — تعداد) (حقل اختياري)
موضع جسم المستخدم عند إجراء القياس
القيم المقبولة
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
ملخّص درجة حرارة الجسم
تمثّل كل نقطة بيانات متوسط درجة حرارة الجسم والحد الأدنى والأقصى لها
المستخدم عبر نطاق زمني.
وسيتضمّن أيضًا الموقع الجغرافي الذي تم فيه القياس على الجسم، إذا
موقع القياس هو نفسه لجميع نقاط البيانات في الفاصل الزمني.
تاريخ التعديل الأخير: 2024-08-22 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-08-22 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Google Fit uses aggregate data types to provide summaries of health and wellness metrics, like steps, calories, and heart rate, over specific time periods."],["Developers can retrieve aggregated data by specifying the data type, time range, and how the data should be grouped (e.g., by time period, activity type, or session)."],["Data is categorized into activity, body, and location, each with specific data types and fields providing aggregated values like totals, averages, minimums, and maximums."],["Aggregate data types are read-only, meaning you can only retrieve data, not write or modify it."],["Accessing aggregate data types requires appropriate OAuth permissions, and Google Fit offers both REST and Android APIs for retrieval."]]],[]]
