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

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

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

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

نوع البيانات   dataType   filter المَعلمة	نوع السجلّ	العمليات المتاحة	النطاق	إتاحة استخدام ويب هوك	التوافق مع القيم الصفرية
السعرات الحرارية المحروقة   active-energy-burned   active_energy_burned	الفاصل الزمني	list, reconcile, rollup, dailyRollup	activity_and_fitness
دقائق النشاط   active-minutes   active_minutes	الفاصل الزمني	list, 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
الغلوكوز في الدم   blood-glucose   blood_glucose	عيّنة	list, get, reconcile, rollup, dailyRollup	health_metrics_and_measurements
دهون الجسم   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
درجة حرارة الجسم الأساسية   core-body-temperature   core_body_temperature	عيّنة	list, get, reconcile, rollup, dailyRollup	health_metrics_and_measurements
تغيُّر معدّل نبضات القلب اليومي   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
تخطيط القلب الكهربائي (ECG)   electrocardiogram   electrocardiogram	الجلسة	قائمة	ecg
ممارسة التمارين الرياضية   exercise   exercise	الجلسة	list, get, reconcile, create, update, batchDelete	activity_and_fitness
الطوابق   floors   floors	الفاصل الزمني	reconcile, rollup, dailyRollup	activity_and_fitness
الطعام   food   food	طعام	قائمة، الحصول على	المعلومات الغذائية
وحدة قياس الطعام   food-measurement-unit   food_measurement_unit	طعام	قائمة، الحصول على	المعلومات الغذائية
معدّل نبضات القلب   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	المعلومات الغذائية
إشعار اضطراب نظم القلب   irregular-rhythm-notification   irregular_rhythm_notification	الجلسة	قائمة	irn
سجلّ التغذية   nutrition-log   nutrition_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	الفاصل الزمني	list, 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. توافق نظام القياس الواسع النطاق: يسهّل استخدام وحدة أساسية مثل المليمترات على المطوّرين التحويل إلى أي وحدة أخرى يختارونها، بغض النظر عمّا إذا كانوا يستخدمون النظام المتري أو الإمبراطوري أو غيرهما من أنظمة القياس.