أنواع بيانات Google Health API

يحتوي الجدول التالي على القائمة الكاملة لأنواع البيانات، مع عدة أعمدة لمساعدتك في فهم طريقة عرض كل نوع في Google Health API، بالإضافة إلى النطاق الذي يتوفّر فيه كل نوع.

ملاحظة مهمة: يختلف تنسيق معرّفات أنواع البيانات عندما يتضمّن نوع البيانات أكثر من كلمة واحدة. في نقطة نهاية، يجب أن يكون اسم نوع البيانات بتنسيق كلمات تفصل بينها شرطة، مثل body-fat. في مَعلمة فلتر، يجب أن يكون اسم نوع البيانات بتنسيق snake case، مثل body_fat.

جدول: أنواع بيانات Google Health API

نوع البيانات   dataType   filter المَعلمة	نوع السجلّ	العمليات المتاحة	النطاق	إتاحة استخدام ويب هوك
دقائق النشاط   active-minutes   active_minutes	الفاصل الزمني	reconcile, rollup, dailyRollup	activity_and_fitness
دقائق قسم النشاط   active-zone-minutes   active_zone_minutes	الفاصل الزمني	list, reconcile, rollup, dailyRollup	activity_and_fitness
مستوى النشاط   activity-level   activity_level	الفاصل الزمني	قائمة، تسوية	activity_and_fitness
الارتفاع   altitude   altitude	الفاصل الزمني	list, reconcile, rollup, dailyRollup	activity_and_fitness
دهون الجسم   body-fat   body_fat	عيّنة	list, get, reconcile, rollup, dailyRollup, create, update, batchDelete	health_metrics_and_measurements
السعرات الحرارية المحروقة في منطقة معدل ضربات القلب   calories-in-heart-rate-zone   calories_in_heart_rate_zone	الفاصل الزمني	rollup, dailyRollup	activity_and_fitness
تغيُّر معدّل نبضات القلب اليومي   daily-heart-rate-variability   daily_heart_rate_variability	يوميًا	قائمة، تسوية	health_metrics_and_measurements
مناطق معدّل نبضات القلب اليومية   daily-heart-rate-zones   daily_heart_rate_zones	يوميًا	تسوية	health_metrics_and_measurements
تشبّع الأكسجين في الدم يوميًا   daily-oxygen-saturation   daily_oxygen_saturation	يوميًا	قائمة، تسوية	health_metrics_and_measurements
معدّل التنفس اليومي   daily-respiratory-rate   daily_respiratory_rate	يوميًا	قائمة، تسوية	health_metrics_and_measurements
معدّل النبض أثناء الراحة يوميًا   daily-resting-heart-rate   daily_resting_heart_rate	يوميًا	قائمة، تسوية	health_metrics_and_measurements
القيم المشتقة لدرجة حرارة الجسم أثناء النوم   daily-sleep-temperature-derivations   daily_sleep_temperature_derivations	يوميًا	قائمة، تسوية	health_metrics_and_measurements
الحد الأقصى اليومي لاستهلاك الأكسجين   daily-vo2-max   daily_vo2_max	يوميًا	قائمة، تسوية	activity_and_fitness
المسافة   distance   distance	الفاصل الزمني	list, reconcile, rollup, dailyRollup	activity_and_fitness
ممارسة التمارين الرياضية   exercise   exercise	الجلسة	list, get, reconcile, create, update, batchDelete	activity_and_fitness
الطوابق   floors   floors	الفاصل الزمني	reconcile, rollup, dailyRollup	activity_and_fitness
معدّل نبضات القلب   heart-rate   heart_rate	عيّنة	list, reconcile, rollup, dailyRollup	health_metrics_and_measurements
تغيُّر معدّل نبضات القلب   heart-rate-variability   heart_rate_variability	عيّنة	قائمة، تسوية	health_metrics_and_measurements
الارتفاع   height   height	عيّنة	list, get, reconcile, create, update, batchDelete	health_metrics_and_measurements
سجلّ الترطيب   hydration-log   hydration_log	الجلسة	list, get, reconcile, rollup, dailyRollup, create, update, batchDelete	المعلومات الغذائية
تشبّع الأكسجين   oxygen-saturation   oxygen_saturation	عيّنة	قائمة، تسوية	health_metrics_and_measurements
ملخّص معدّل التنفس أثناء النوم   respiratory-rate-sleep-summary   respiratory_rate_sleep_summary	عيّنة	قائمة، تسوية	health_metrics_and_measurements
الحد الأقصى لاستهلاك الأكسجين أثناء الجري   run-vo2-max   run_vo2_max	عيّنة	list, reconcile, rollup, dailyRollup	activity_and_fitness
فترة الخمول   sedentary-period   sedentary_period	الفاصل الزمني	list, reconcile, rollup, dailyRollup	activity_and_fitness
النوم   sleep   sleep	الجلسة	list, get, reconcile, create, update, batchDelete	النوم
الخطوات   steps   steps	الفاصل الزمني	list, reconcile, rollup, dailyRollup	activity_and_fitness
بيانات عدد لفات السباحة   swim-lengths-data   swim_lengths_data	الفاصل الزمني	list, reconcile, rollup, dailyRollup	activity_and_fitness
الوقت الذي تم قضاؤه في منطقة معدل ضربات القلب   time-in-heart-rate-zone   time_in_heart_rate_zone	الفاصل الزمني	reconcile, rollup, dailyRollup	activity_and_fitness
إجمالي السعرات الحرارية   total-calories   total_calories	الفاصل الزمني	rollup, dailyRollup	activity_and_fitness
السعة القصوى للأكسجين   vo2-max   vo2_max	عيّنة	قائمة، تسوية	activity_and_fitness
الوزن   weight   weight	عيّنة	list, get, reconcile, rollup, dailyRollup, create, update, batchDelete	health_metrics_and_measurements

مدى توفّر البيانات

لا تتوفّر تعديلات على بيانات المستخدم إلا بعد مزامنة جهاز تتبُّع النشاط أو إدخال بيانات جديدة يدويًا في تطبيق Fitbit للأجهزة الجوّالة أو تطبيق الويب. ويمكن لجهاز Fitbit وتطبيق Fitbit للأجهزة الجوّالة إجراء المزامنة تلقائيًا كل 15 دقيقة عندما يكون تطبيق Fitbit مفتوحًا على الجهاز الجوّال ويكون الجهازان متصلَين بشبكة بيانات نشطة وضمن نطاق Bluetooth. إذا كان المستخدم يتتبّع النشاط باستخدام MobileTrack، تتم مزامنة البيانات كل ساعة طالما أنّ التطبيق مفتوح.

إمكانية وصول الجهات الخارجية

لا يمكن لأجهزة Fitbit التواصل مباشرةً مع التطبيقات أو الخدمات التابعة لجهات خارجية. تم تصميم هذه الأجهزة للتواصل والمزامنة حصريًا مع تطبيق Fitbit للأجهزة الجوّالة.

يزامن الجهاز البيانات تلقائيًا على مدار اليوم، عندما يكون تطبيق Fitbit مفتوحًا، أو كل 15 دقيقة إذا كان البلوتوث نشطًا وكان التطبيق يعمل في الخلفية. بعد اكتمال عملية المزامنة هذه، تصبح البيانات متاحة للخدمات التابعة لجهات خارجية من خلال Google Health API.

معايير المسافة

يتم قياس مسافات التمارين، مثل elevationGainMillimeters، بالملليمترات كوحدة قياس معيارية للأسباب التالية:

1. الحفاظ على دقة البيانات: السبب الأكثر أهمية لاستخدام الملليمترات هو ضمان عدم فقدان أي دقة في البيانات التي نقرأها ونقدّمها. يتيح لنا استخدام وحدة دقيقة مثل المليمترات تمثيل القياسات بدقة عالية.
2. توحيد المقاييس: المليمتر هو وحدة القياس الموحّدة المصمَّمة في جميع خدماتنا. ويساعد هذا الاتساق في ضمان تجربة موحّدة للمطوّرين الذين يتفاعلون مع أجزاء مختلفة من واجهة برمجة التطبيقات.
3. توافق نظام القياس الواسع النطاق: يسهّل استخدام وحدة أساسية مثل المليمترات على المطوّرين التحويل إلى أي وحدة أخرى يختارونها، بغض النظر عمّا إذا كانوا يعملون بالنظام المتري أو الإمبراطوري أو غيرهما من أنظمة القياس.