انواع داده‌های API سلامت گوگل

جدول زیر شامل لیست کامل انواع داده‌ها است، به همراه چندین ستون که به شما در درک نحوه نمایش هر نوع در API گوگل هلث و همچنین دامنه دسترسی هر کدام کمک می‌کند.

نکته مهم: قالب شناسه‌های نوع داده زمانی که نوع داده بیش از یک کلمه دارد، متفاوت است. در یک نقطه پایانی، نام نوع داده باید به صورت kebab باشد، مانند body-fat . با این حال، در یک پارامتر فیلتر، نام نوع داده باید به صورت snake باشد، مانند body_fat .

جدول: انواع داده‌های API سلامت گوگل

نوع داده شناسه نقطه پایانی پارامتر فیلتر	رکورد نوع	موجود است عملیات	محدوده	وب‌هوک پشتیبانی
دقایق فعال active-minutes active_minutes	فاصله	آشتی دادن، جمع کردن، روزانه جمع کردن	فعالیت_و_تناسب_اندام
صورتجلسات منطقه فعال active-zone-minutes active_zone_minutes	فاصله	فهرست کردن، تطبیق دادن، جمع کردن، جمع کردن روزانه	فعالیت_و_تناسب_اندام
سطح فعالیت activity-level activity_level	فاصله	فهرست کردن، تطبیق دادن	فعالیت_و_تناسب_اندام
ارتفاع altitude altitude	فاصله	فهرست کردن، تطبیق دادن، جمع کردن، جمع کردن روزانه	فعالیت_و_تناسب_اندام
چربی بدن body-fat body_fat	نمونه	فهرست کردن، دریافت کردن، تطبیق دادن، جمع کردن، جمع کردن روزانه، ایجاد کردن، به‌روزرسانی کردن، حذف دسته‌ای	معیارهای_و_اندازه_گیری_سلامت
کالری در منطقه ضربان قلب calories-in-heart-rate-zone calories_in_heart_rate_zone	فاصله	رول‌آپ، رول‌آپ روزانه	فعالیت_و_تناسب_اندام
تغییرپذیری روزانه ضربان قلب daily-heart-rate-variability daily_heart_rate_variability	روزانه	فهرست کردن، تطبیق دادن	معیارهای_و_اندازه_گیری_سلامت
محدوده‌های ضربان قلب روزانه daily-heart-rate-zones daily_heart_rate_zones	روزانه	آشتی دادن	معیارهای_و_اندازه_گیری_سلامت
اشباع اکسیژن روزانه daily-oxygen-saturation daily_oxygen_saturation	روزانه	فهرست کردن، تطبیق دادن	معیارهای_و_اندازه_گیری_سلامت
میزان تنفس روزانه daily-respiratory-rate daily_respiratory_rate	روزانه	فهرست کردن، تطبیق دادن	معیارهای_و_اندازه_گیری_سلامت
ضربان قلب در حالت استراحت روزانه daily-resting-heart-rate daily_resting_heart_rate	روزانه	فهرست کردن، تطبیق دادن	معیارهای_و_اندازه_گیری_سلامت
مشتقات دمای خواب روزانه daily-sleep-temperature-derivations daily_sleep_temperature_derivations	روزانه	فهرست کردن، تطبیق دادن	معیارهای_و_اندازه_گیری_سلامت
حداکثر اکسیژن مصرفی روزانه (VO2 Max) daily-vo2-max daily_vo2_max	روزانه	فهرست کردن، تطبیق دادن	فعالیت_و_تناسب_اندام
فاصله distance distance	فاصله	فهرست کردن، تطبیق دادن، جمع کردن، جمع کردن روزانه	فعالیت_و_تناسب_اندام
ورزش exercise exercise	جلسه	لیست کردن، دریافت کردن، تطبیق دادن، ایجاد کردن، به‌روزرسانی کردن، حذف دسته‌ای	فعالیت_و_تناسب_اندام
طبقات floors floors	فاصله	آشتی دادن، جمع کردن، روزانه جمع کردن	فعالیت_و_تناسب_اندام
ضربان قلب heart-rate heart_rate	نمونه	فهرست کردن، تطبیق دادن، جمع کردن، جمع کردن روزانه	معیارهای_و_اندازه_گیری_سلامت
تغییرپذیری ضربان قلب heart-rate-variability heart_rate_variability	نمونه	فهرست کردن، تطبیق دادن	معیارهای_و_اندازه_گیری_سلامت
گزارش هیدراتاسیون hydration-log hydration_log	جلسه	فهرست کردن، دریافت کردن، تطبیق دادن، جمع کردن، جمع کردن روزانه، ایجاد کردن، به‌روزرسانی کردن، حذف دسته‌ای	تغذیه
اشباع اکسیژن oxygen-saturation oxygen_saturation	نمونه	فهرست کردن، تطبیق دادن	معیارهای_و_اندازه_گیری_سلامت
خلاصه خواب با نرخ تنفس respiratory-rate-sleep-summary respiratory_rate_sleep_summary	نمونه	فهرست کردن، تطبیق دادن	معیارهای_و_اندازه_گیری_سلامت
حداکثر اکسیژن مصرفی (VO2 Max) را بدوید run-vo2-max run_vo2_max	نمونه	فهرست کردن، تطبیق دادن، جمع کردن، جمع کردن روزانه	فعالیت_و_تناسب_اندام
دوره کم تحرکی sedentary-period sedentary_period	فاصله	فهرست کردن، تطبیق دادن، جمع کردن، جمع کردن روزانه	فعالیت_و_تناسب_اندام
خواب sleep sleep	جلسه	لیست کردن، دریافت کردن، تطبیق دادن، ایجاد کردن، به‌روزرسانی کردن، حذف دسته‌ای	خواب
مراحل steps steps	فاصله	فهرست کردن، تطبیق دادن، جمع کردن، جمع کردن روزانه	فعالیت_و_تناسب_اندام
زمان در منطقه ضربان قلب time-in-heart-rate-zone time_in_heart_rate_zone	فاصله	آشتی دادن، جمع کردن، روزانه جمع کردن	فعالیت_و_تناسب_اندام
کل کالری total-calories total_calories	فاصله	رول‌آپ، رول‌آپ روزانه	فعالیت_و_تناسب_اندام
حداکثر اکسیژن مصرفی (VO2 Max) vo2-max vo2_max	نمونه	فهرست کردن، تطبیق دادن	فعالیت_و_تناسب_اندام
وزن weight weight	نمونه	فهرست کردن، دریافت کردن، تطبیق دادن، جمع کردن، جمع کردن روزانه، ایجاد کردن، به‌روزرسانی کردن، حذف دسته‌ای	معیارهای_و_اندازه_گیری_سلامت

در دسترس بودن داده‌ها

به‌روزرسانی داده‌های کاربر تنها پس از همگام‌سازی ردیاب فعالیت یا وارد کردن دستی داده‌های جدید در برنامه موبایل یا وب Fitbit امکان‌پذیر است. دستگاه Fitbit و برنامه موبایل Fitbit می‌توانند به طور خودکار هر ۱۵ دقیقه، زمانی که برنامه Fitbit روی دستگاه تلفن همراه باز است و هر دو دارای اتصال داده فعال و در محدوده بلوتوث هستند، همگام‌سازی شوند. اگر کاربر فعالیت را با استفاده از MobileTrack ردیابی می‌کند، MobileTrack تا زمانی که برنامه باز باشد، هر ساعت همگام‌سازی می‌شود.

استانداردهای فاصله

فواصل تمرینی، مانند elevationGainMillimeters ، به دلایل زیر به عنوان واحد استاندارد بر حسب میلی‌متر اندازه‌گیری می‌شوند:

1. حفظ دقت داده‌ها : مهم‌ترین دلیل استفاده از میلی‌متر، اطمینان از این است که هیچ دقتی در داده‌هایی که می‌خوانیم و ارائه می‌دهیم از دست ندهیم. استفاده از یک واحد دقیق مانند میلی‌متر به ما این امکان را می‌دهد که اندازه‌گیری‌ها را با دقت بالا نمایش دهیم.
2. استانداردسازی : میلی‌متر واحد استاندارد طراحی‌شده در سراسر سرویس‌های ما است. این سازگاری به تضمین یک تجربه یکسان برای توسعه‌دهندگان در تعامل با بخش‌های مختلف API کمک می‌کند.
3. پشتیبانی گسترده از سیستم‌های اندازه‌گیری : استفاده از یک واحد پایه مانند میلی‌متر، تبدیل به هر واحد انتخابی دیگری را برای توسعه‌دهندگان، صرف نظر از اینکه با سیستم‌های اندازه‌گیری متریک، امپریال یا سایر سیستم‌ها کار می‌کنند، ساده می‌کند.