ประเภทข้อมูล Google Health API

ตารางต่อไปนี้มีรายการประเภทข้อมูลทั้งหมด โดยมีหลายคอลัมน์ ที่จะช่วยให้คุณเข้าใจการแสดงข้อมูลแต่ละประเภทใน Google Health API รวมถึงขอบเขตที่ข้อมูลแต่ละประเภทพร้อมใช้งาน

หมายเหตุ: Health API ไม่รองรับอุปกรณ์ Fitbit Ace ดูข้อมูลเพิ่มเติมได้ที่นโยบายความเป็นส่วนตัวของ Fitbit สำหรับบัญชีของเด็ก

สำคัญ: รูปแบบ ของตัวระบุประเภทข้อมูลจะแตกต่างกันเมื่อประเภทข้อมูลมีมากกว่า 1 คำ ในปลายทาง ชื่อประเภทข้อมูลต้องอยู่ในรูปแบบ Kebab Case เช่น body-fat อย่างไรก็ตาม ในพารามิเตอร์ตัวกรอง ชื่อประเภทข้อมูลต้องอยู่ในรูปแบบ Snake Case เช่น body_fat.

ตาราง: ประเภทข้อมูลของ Google Health API

ประเภทข้อมูล   dataType พารามิเตอร์   filter	การดำเนินการ ที่ใช้ได้	ขอบเขต
พลังงานที่ใช้ไป active-energy-burned active_energy_burned ประเภทระเบียน: ช่วงเวลา คำแนะนำเกี่ยวกับแคลอรี่และพลังงาน	list, reconcile, rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly
นาทีที่ใช้งาน active-minutes active_minutes ประเภทระเบียน: ช่วงเวลา อุปกรณ์ที่เข้ากันได้ Fitbit Air Fitbit Alta Fitbit Alta HR Fitbit Blaze Fitbit Charge 2 Fitbit Charge 3 Fitbit Flex 2 Fitbit Inspire Fitbit Inspire HR Pixel Watch 4	list, reconcile, rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly
นาทีในโซนแอ็กทีฟ active-zone-minutes active_zone_minutes ประเภทระเบียน: ช่วงเวลา การรองรับเว็บฮุค อุปกรณ์ที่เข้ากันได้ Fitbit Air Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Inspire 2 Fitbit Inspire 3 Fitbit Ionic Fitbit Luxe Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4 Fitbit Versa Lite	list, reconcile, rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly
ระดับกิจกรรม activity-level activity_level ประเภทระเบียน: ช่วงเวลา การรองรับเว็บฮุค	รายการ, ปรับยอด	.activity_and_fitness.readonly .activity_and_fitness.writeonly
ระดับความสูง altitude altitude ประเภทระเบียน: ช่วงเวลา การรองรับเว็บฮุค การรองรับค่าศูนย์ที่แท้จริง	list, reconcile, rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly
น้ำตาลกลูโคสในเลือด blood-glucose blood_glucose ประเภทระเบียน: ตัวอย่าง การรองรับเว็บฮุค คู่มือ Vitals	list, get, reconcile, rollup, dailyRollup	.health_metrics_and_measurements.readonly .health_metrics_and_measurements.writeonly
ไขมันในร่างกาย body-fat body_fat ประเภทระเบียน: ตัวอย่าง การรองรับเว็บฮุค อุปกรณ์ที่เข้ากันได้ Fitbit Aria Fitbit Aria 2 Fitbit Aria Air	list, get, reconcile, rollup, dailyRollup, create, update, batchDelete	.health_metrics_and_measurements.readonly .health_metrics_and_measurements.writeonly
แคลอรี่ในโซนอัตราการเต้นของหัวใจ calories-in-heart-rate-zone calories_in_heart_rate_zone ประเภทระเบียน: ช่วงเวลา การรองรับเว็บฮุค	rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly
อุณหภูมิแกนกลางของร่างกาย core-body-temperature core_body_temperature ประเภทระเบียน: ตัวอย่าง คู่มือค่าสัญญาณชีพ	list, get, reconcile, rollup, dailyRollup	.health_metrics_and_measurements.readonly .health_metrics_and_measurements.writeonly
ความผันแปรของอัตราการเต้นของหัวใจรายวัน daily-heart-rate-variability daily_heart_rate_variability ประเภทบันทึก: รายวัน การรองรับเว็บฮุค คู่มือ Vitals คู่มือการนอนหลับ อุปกรณ์ที่เข้ากันได้ Fitbit Air Fitbit Alta HR Fitbit Blaze Fitbit Charge 2 Fitbit Charge 3 Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Inspire 2 Fitbit Inspire 3 Fitbit Inspire HR Fitbit Ionic Fitbit Luxe Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4	รายการ, ปรับยอด	.health_metrics_and_measurements.readonly .health_metrics_and_measurements.writeonly
โซนอัตราการเต้นของหัวใจรายวัน daily-heart-rate-zones daily_heart_rate_zones ประเภทบันทึก: รายวัน การรองรับเว็บฮุค คู่มือ Vitals	รายการ, ปรับยอด	.health_metrics_and_measurements.readonly .health_metrics_and_measurements.writeonly
ค่าความอิ่มตัวของออกซิเจนในเลือดรายวัน daily-oxygen-saturation daily_oxygen_saturation ประเภทบันทึก: รายวัน การรองรับเว็บฮุค คู่มือ Vitals คู่มือการนอนหลับ อุปกรณ์ที่เข้ากันได้ Fitbit Air Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Inspire 3 Fitbit Ionic Fitbit Luxe Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4	รายการ, ปรับยอด	.health_metrics_and_measurements.readonly .health_metrics_and_measurements.writeonly
อัตราการหายใจรายวัน daily-respiratory-rate daily_respiratory_rate ประเภทบันทึก: รายวัน การรองรับเว็บฮุค คู่มือ Vitals คู่มือการนอนหลับ อุปกรณ์ที่เข้ากันได้ Fitbit Air Fitbit Alta HR Fitbit Blaze Fitbit Charge 2 Fitbit Charge 3 Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Inspire 2 Fitbit Inspire 3 Fitbit Inspire HR Fitbit Ionic Fitbit Luxe Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4	รายการ, ปรับยอด	.health_metrics_and_measurements.readonly .health_metrics_and_measurements.writeonly
อัตราการเต้นของหัวใจขณะพักประจำวัน daily-resting-heart-rate daily_resting_heart_rate ประเภทบันทึก: รายวัน การรองรับเว็บฮุค คู่มือ Vitals อุปกรณ์ที่เข้ากันได้ Fitbit Air Fitbit Alta HR Fitbit Blaze Fitbit Charge 2 Fitbit Charge 3 Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Inspire 2 Fitbit Inspire 3 Fitbit Inspire HR Fitbit Ionic Fitbit Luxe Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4 Fitbit Versa Lite	รายการ, ปรับยอด	.health_metrics_and_measurements.readonly .health_metrics_and_measurements.writeonly
การหาค่าอุณหภูมิขณะนอนหลับในแต่ละวัน daily-sleep-temperature-derivations daily_sleep_temperature_derivations ประเภทบันทึก: รายวัน การรองรับเว็บฮุค คู่มือ Vitals คู่มือการนอนหลับ อุปกรณ์ที่เข้ากันได้ Fitbit Air Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Inspire 2 Fitbit Inspire 3 Fitbit Inspire HR Fitbit Ionic Fitbit Luxe Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4	รายการ, ปรับยอด	.health_metrics_and_measurements.readonly .health_metrics_and_measurements.writeonly
ปริมาณการใช้ออกซิเจนสูงสุดรายวัน daily-vo2-max daily_vo2_max ประเภทบันทึก: รายวัน อุปกรณ์ที่เข้ากันได้ Fitbit Air Fitbit Alta HR Fitbit Blaze Fitbit Charge 2 Fitbit Charge 3 Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Inspire 2 Fitbit Inspire 3 Fitbit Ionic Fitbit Luxe Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4 Fitbit Versa Lite	รายการ, ปรับยอด	.activity_and_fitness.readonly .activity_and_fitness.writeonly
ระยะทาง distance distance ประเภทระเบียน: ช่วงเวลา การรองรับเว็บฮุค การรองรับค่าศูนย์ที่แท้จริง อุปกรณ์ที่เข้ากันได้ Fitbit Air Fitbit Alta Fitbit Alta HR Fitbit Blaze Fitbit Charge 2 Fitbit Charge 3 Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Flex 2 Fitbit Inspire Fitbit Inspire 2 Fitbit Inspire 3 Fitbit Inspire HR Fitbit Ionic Fitbit Luxe Fitbit MobileTrack Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4 Fitbit Versa Lite	list, reconcile, rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly
คลื่นไฟฟ้าหัวใจ (ECG) electrocardiogram electrocardiogram ประเภทระเบียน: เซสชัน คู่มือค่าสัญญาณชีพ อุปกรณ์ที่เข้ากันได้ Fitbit Charge 5 Fitbit Charge 6 Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2	list	.ecg.readonly
การออกกำลังกาย exercise exercise ประเภทระเบียน: เซสชัน การรองรับเว็บฮุค คู่มือการออกกำลังกาย อุปกรณ์ที่เข้ากันได้ Fitbit Air Fitbit Alta Fitbit Alta HR Fitbit Blaze Fitbit Charge 2 Fitbit Charge 3 Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Flex 2 Fitbit Inspire Fitbit Inspire 2 Fitbit Inspire 3 Fitbit Inspire HR Fitbit Ionic Fitbit Luxe Fitbit MobileTrack Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4 Fitbit Versa Lite	list, get, reconcile, create, update, batchDelete	.activity_and_fitness.readonly .activity_and_fitness.writeonly
พื้น floors floors ประเภทระเบียน: ช่วงเวลา การรองรับเว็บฮุค การรองรับค่าศูนย์ที่แท้จริง	reconcile, rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly
อาหาร food food ประเภทบันทึก: อาหาร คำแนะนำด้านโภชนาการ	list, get	.nutrition.readonly .nutrition.writeonly
หน่วยวัดอาหาร food-measurement-unit food_measurement_unit ประเภทบันทึก: อาหาร คำแนะนำด้านโภชนาการ อุปกรณ์ที่เข้ากันได้ Fitbit Air Fitbit Blaze Fitbit Charge 2 Fitbit Charge 3 Fitbit Charge 4 Fitbit Ionic Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4	list, get	.nutrition.readonly .nutrition.writeonly
อัตราการเต้นของหัวใจ heart-rate heart_rate ประเภทระเบียน: ตัวอย่าง การรองรับเว็บฮุค คู่มือ Vitals อุปกรณ์ที่เข้ากันได้ Fitbit Air Fitbit Alta HR Fitbit Blaze Fitbit Charge 2 Fitbit Charge 3 Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Inspire 2 Fitbit Inspire 3 Fitbit Inspire HR Fitbit Ionic Fitbit Luxe Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4 Fitbit Versa Lite	list, reconcile, rollup, dailyRollup	.health_metrics_and_measurements.readonly .health_metrics_and_measurements.writeonly
ความผันแปรของอัตราการเต้นของหัวใจ heart-rate-variability heart_rate_variability ประเภทระเบียน: ตัวอย่าง การรองรับเว็บฮุค คู่มือ Vitals คู่มือการนอนหลับ อุปกรณ์ที่เข้ากันได้ Fitbit Air Fitbit Alta Fitbit Alta HR Fitbit Blaze Fitbit Charge 2 Fitbit Charge 3 Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Flex 2 Fitbit Inspire Fitbit Inspire 2 Fitbit Inspire 3 Fitbit Inspire HR Fitbit Ionic Fitbit Luxe Fitbit MobileTrack Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4 Fitbit Versa Lite	รายการ, ปรับยอด	.health_metrics_and_measurements.readonly .health_metrics_and_measurements.writeonly
ส่วนสูง height height ประเภทระเบียน: ตัวอย่าง การรองรับเว็บฮุค	list, get, reconcile, create, update, batchDelete	.health_metrics_and_measurements.readonly .health_metrics_and_measurements.writeonly
บันทึกการดื่มน้ำ hydration-log hydration_log ประเภทระเบียน: เซสชัน การรองรับเว็บฮุค	list, get, reconcile, rollup, dailyRollup, create, update, batchDelete	.nutrition.readonly .nutrition.writeonly
การแจ้งเตือนเมื่อจังหวะการเต้นของหัวใจผิดปกติ irregular-rhythm-notification irregular_rhythm_notification ประเภทระเบียน: เซสชัน คู่มือค่าสัญญาณชีพ	list	.irn.readonly
ระยะประจำเดือน menstrual-period menstrual_period ประเภทระเบียน: ช่วงเวลา	create, update, batchDelete	.reproductive_health.writeonly
อารมณ์ moods moods ประเภทระเบียน: ตัวอย่าง	create, update, batchDelete	.mindfulness.writeonly
บันทึกโภชนาการ nutrition-log nutrition_log ประเภทระเบียน: ตัวอย่าง การสนับสนุนเว็บฮุค คำแนะนำด้านโภชนาการ อุปกรณ์ที่เข้ากันได้ Fitbit Air Fitbit Charge 3 Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Inspire 2 Fitbit Inspire 3 Fitbit Luxe Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4 Fitbit Versa Lite	list, get, reconcile, rollup, dailyRollup, create, update, batchDelete	.nutrition.readonly .nutrition.writeonly
การทดสอบการตกไข่ ovulation-test ovulation_test ประเภทระเบียน: ตัวอย่าง	create, update, batchDelete	.reproductive_health.writeonly
ความอิ่มตัวของออกซิเจน oxygen-saturation oxygen_saturation ประเภทระเบียน: ตัวอย่าง คู่มือค่าสัญญาณชีพ คู่มือการนอนหลับ อุปกรณ์ที่เข้ากันได้ Fitbit Air Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Inspire 3 Fitbit Ionic Fitbit Luxe Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4	รายการ, ปรับยอด	.health_metrics_and_measurements.readonly .health_metrics_and_measurements.writeonly
สรุปการนอนหลับเกี่ยวกับอัตราการหายใจ respiratory-rate-sleep-summary respiratory_rate_sleep_summary ประเภทระเบียน: ตัวอย่าง การรองรับเว็บฮุค คู่มือ Vitals คู่มือการนอนหลับ อุปกรณ์ที่เข้ากันได้ Fitbit Air Fitbit Alta HR Fitbit Blaze Fitbit Charge 2 Fitbit Charge 3 Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Inspire 2 Fitbit Inspire 3 Fitbit Inspire HR Fitbit Ionic Fitbit Luxe Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4	รายการ, ปรับยอด	.health_metrics_and_measurements.readonly .health_metrics_and_measurements.writeonly
วิ่ง VO2 Max run-vo2-max run_vo2_max ประเภทระเบียน: ตัวอย่าง การรองรับเว็บฮุค อุปกรณ์ที่เข้ากันได้ Fitbit Air Fitbit Alta HR Fitbit Blaze Fitbit Charge 2 Fitbit Charge 3 Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Inspire 2 Fitbit Inspire 3 Fitbit Ionic Fitbit Luxe Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4 Fitbit Versa Lite	list, reconcile, rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly
ระยะเวลาอยู่กับที่ไม่เคลื่อนไหว sedentary-period sedentary_period ประเภทระเบียน: ช่วงเวลา การรองรับเว็บฮุค อุปกรณ์ที่เข้ากันได้ Fitbit Air Fitbit Alta Fitbit Alta HR Fitbit Blaze Fitbit Charge 2 Fitbit Charge 3 Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Flex 2 Fitbit Inspire Fitbit Inspire 2 Fitbit Inspire 3 Fitbit Inspire HR Fitbit Ionic Fitbit Luxe Fitbit MobileTrack Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4 Fitbit Versa Lite	list, reconcile, rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly
การนอนหลับ sleep sleep ประเภทระเบียน: เซสชัน การรองรับเว็บฮุค คำแนะนำเกี่ยวกับการนอนหลับ อุปกรณ์ที่เข้ากันได้ Fitbit Air Fitbit Alta Fitbit Alta HR Fitbit Blaze Fitbit Charge 2 Fitbit Charge 3 Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Flex 2 Fitbit Inspire Fitbit Inspire 2 Fitbit Inspire 3 Fitbit Inspire HR Fitbit Ionic Fitbit Luxe Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4 Fitbit Versa Lite	list, get, reconcile, create, update, batchDelete	.sleep.readonly .sleep.writeonly
ขั้นตอน steps steps ประเภทระเบียน: ช่วงเวลา การรองรับเว็บฮุค การรองรับค่า 0 จริง คู่มือขั้นตอน อุปกรณ์ที่เข้ากันได้ Fitbit Air Fitbit Alta Fitbit Alta HR Fitbit Blaze Fitbit Charge 2 Fitbit Charge 3 Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Flex 2 Fitbit Inspire Fitbit Inspire 2 Fitbit Inspire 3 Fitbit Inspire HR Fitbit Ionic Fitbit Luxe Fitbit MobileTrack Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4 Fitbit Versa Lite	list, reconcile, rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly
ข้อมูลระยะทางว่ายน้ำ swim-lengths-data swim_lengths_data ประเภทระเบียน: ช่วงเวลา อุปกรณ์ที่เข้ากันได้ Fitbit Air Fitbit Charge 3 Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Flex 2 Fitbit Inspire Fitbit Inspire 2 Fitbit Inspire 3 Fitbit Inspire HR Fitbit Ionic Fitbit Luxe Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4 Fitbit Versa Lite	list, reconcile, rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly
อาการ symptoms symptoms ประเภทระเบียน: ตัวอย่าง	create, update, batchDelete	.logged_symptoms.writeonly
เวลาในโซนอัตราการเต้นของหัวใจ time-in-heart-rate-zone time_in_heart_rate_zone ประเภทระเบียน: ช่วงเวลา การรองรับเว็บฮุค	list, reconcile, rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly
แคลอรี่ทั้งหมด total-calories total_calories ประเภทระเบียน: ช่วงเวลา รองรับค่าศูนย์ที่แท้จริง คู่มือแคลอรี่และพลังงาน อุปกรณ์ที่เข้ากันได้ Fitbit Air Fitbit Alta Fitbit Alta HR Fitbit Blaze Fitbit Charge 2 Fitbit Charge 3 Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Flex 2 Fitbit Inspire Fitbit Inspire 2 Fitbit Inspire 3 Fitbit Inspire HR Fitbit Ionic Fitbit Luxe Fitbit MobileTrack Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4 Fitbit Versa Lite	rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly
VO2 Max vo2-max vo2_max ประเภทระเบียน: ตัวอย่าง อุปกรณ์ที่เข้ากันได้ Fitbit Air Fitbit Alta HR Fitbit Blaze Fitbit Charge 2 Fitbit Charge 3 Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Inspire 2 Fitbit Inspire 3 Fitbit Ionic Fitbit Luxe Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4 Fitbit Versa Lite	รายการ, ปรับยอด	.activity_and_fitness.readonly .activity_and_fitness.writeonly
น้ำหนัก weight weight ประเภทระเบียน: ตัวอย่าง การรองรับเว็บฮุค อุปกรณ์ที่เข้ากันได้ Fitbit Aria Fitbit Aria 2 Fitbit Aria Air	list, get, reconcile, rollup, dailyRollup, create, update, batchDelete	.health_metrics_and_measurements.readonly .health_metrics_and_measurements.writeonly

ข้อจำกัดของคำค้นหา

เมื่อค้นหาจุดข้อมูล การสรุป หรือการสรุปรายวันจาก API โปรดคำนึงถึงข้อจำกัดต่อไปนี้

• ข้อกำหนดของตัวกรอง: ข้อมูลที่ได้บางประเภทแบบอ่านอย่างเดียว เช่น total-calories ต้องมีตัวกรองที่ระบุเวลาเริ่มต้นของช่วง (ใช้เวลาจริงหรือเวลาพลเรือน)
• ขีดจํากัดช่วงการค้นหา: จุดปลายทางการรวบรวมข้อมูลแบบสรุปและแบบสรุปรายวัน จะบังคับใช้ขีดจํากัดช่วงการค้นหาสูงสุดตามประเภทข้อมูล ดังนี้
  • ช่วงการค้นหาสูงสุด 14 วันสำหรับ calories-in-heart-rate-zone, heart-rate, active-minutes และ total-calories
  • ช่วงการค้นหาสูงสุด 90 วันสำหรับข้อมูลประเภทอื่นๆ ทั้งหมด

ความพร้อมใช้งานของข้อมูล

การอัปเดตข้อมูลของผู้ใช้จะพร้อมใช้งานหลังจากที่ผู้ใช้ซิงค์เครื่องมือติดตามกิจกรรมหรือป้อนข้อมูลใหม่ลงในแอป Fitbit บนมือถือหรือเว็บแอปด้วยตนเองเท่านั้น อุปกรณ์ Fitbit และแอป Fitbit บนมือถือจะซิงค์โดยอัตโนมัติทุกๆ 15 นาทีเมื่อแอป Fitbit เปิดอยู่บนอุปกรณ์เคลื่อนที่และทั้ง 2 อย่างมีการเชื่อมต่อข้อมูลที่ใช้งานอยู่และอยู่ในระยะ Bluetooth หากผู้ใช้ติดตามกิจกรรมโดยใช้ MobileTrack ระบบจะซิงค์ MobileTrack ทุกชั่วโมงตราบใดที่แอปเปิดอยู่

การค้นหาข้อมูลย้อนหลัง

ข้อดีหลักอย่างหนึ่งของ Google Health API คือความสามารถในการติดตามประสิทธิภาพของผู้ใช้และตรวจสอบค่าสุขภาพที่สำคัญเป็นระยะเวลานาน คุณสามารถค้นหาข้อมูลของผู้ใช้ได้ย้อนหลังเท่าที่ระบบบันทึกไว้ โดย API จะไม่จำกัดจำนวนข้อมูลย้อนหลังที่แอปพลิเคชันของคุณใช้ได้

อย่างไรก็ตาม การค้นหาข้อมูลย้อนหลังยังคงอยู่ภายใต้ขีดจำกัดของอัตรามาตรฐาน Google Health API ใช้การแบ่งหน้าอัตโนมัติที่มีขนาดหน้าเฉพาะปลายทางเพื่อจัดการความเสถียรของระบบและ ป้องกันไม่ให้มีเพย์โหลดมากเกินไป โปรดทราบขอบเขตและลักษณะการทำงานต่อไปนี้

• การแบ่งหน้าอัตโนมัติ: หากคุณค้นหาข้อมูลเป็นระยะเวลานาน API จะแสดงผลลัพธ์หน้าแรกเท่านั้น โดยมีจำนวนไม่เกินขีดจำกัดขนาดหน้าสำหรับปลายทางนั้น พร้อมกับ nextPageToken คุณต้องใช้ nextPageToken เพื่อขอหน้าถัดไป
• ขนาดหน้าเว็บที่เปลี่ยนแปลงได้: ขีดจํากัดการจํากัดความถี่จะขึ้นอยู่กับปลายทาง และประเภทข้อมูล สำหรับข้อมูลส่วนใหญ่ ขนาดหน้าเว็บจะจำกัดไว้ที่สูงสุด 10,000 อย่างไรก็ตาม สำหรับข้อมูลบางประเภท เช่น exercise และ sleep ขนาดหน้าเว็บเริ่มต้นและสูงสุดจะจำกัดไว้ที่ 25 ตัวอย่างเช่น หากไคลเอ็นต์ขอข้อมูลการนอนหลับทั้งหมดในช่วง 10 ปีที่ผ่านมา API จะยังคงแสดงเซสชันการนอนหลับเพียง 25 รายการในหน้าแรก
• ข้อจำกัดของช่วงวันที่สะสม: สำหรับปลายทางการสะสมและการรวบรวมข้อมูล (เช่น rollUp และ dailyRollUp) ระบบจะจำกัดช่วงวันที่ของการค้นหา ตามประเภทข้อมูล ดังนี้
  • ช่วงสูงสุด 14 วันสำหรับ calories-in-heart-rate-zone heart-rate, active-minutes และ total-calories
  • ช่วงสูงสุด 90 วันสําหรับประเภทข้อมูลการรวมอื่นๆ ทั้งหมด

การดึงข้อมูลทั้งชุดข้อมูลจะต้องมีการแบ่งหน้าตามลำดับหน้า ทั้งนี้ขึ้นอยู่กับปริมาณข้อมูลย้อนหลังที่แอปพลิเคชันของคุณต้องการ โปรดคำนึงถึงเรื่องนี้เมื่อออกแบบกระบวนการซิงโครไนซ์ข้อมูลของแอปพลิเคชัน

ทำตามหลักเกณฑ์ต่อไปนี้เมื่อค้นหาข้อมูลย้อนหลังเพื่อให้มั่นใจว่าได้ประสิทธิภาพสูงสุดและหลีกเลี่ยงข้อผิดพลาดของ API

การซิงค์ข้อมูลแบบเป็นระยะ (โหลดแบบร้อนเทียบกับแบบเย็น)

• การโหลด "ด่วน" ครั้งแรก: ดึงและแสดงเฉพาะข้อมูลในช่วง 7-14 วันล่าสุด ในลําดับการโหลดหลัก ซึ่งจะช่วยให้ผู้ใช้เห็นข้อมูลได้ทันทีโดยไม่ต้องรอการค้นหาที่ใช้เวลานาน
• การโหลด "เย็น" ในเบื้องหลัง: มอบหมายการดึงข้อมูลย้อนหลังที่เก่ากว่า ไปยังคิวแบบไม่พร้อมกันที่มีลำดับความสำคัญต่ำกว่าหรือกระบวนการในเบื้องหลัง หลังจากที่แสดงผล UI หลักแล้ว

การแบ่งคำค้นหาเพื่อการรวม

• เนื่องจากปลายทางของการสรุปและสรุปรายวันบังคับใช้ขีดจำกัดช่วงวันที่สูงสุด (14 หรือ 90 วัน ขึ้นอยู่กับประเภทข้อมูล) คุณจึงต้องแบ่งคำค้นหาการรวบรวมข้อมูลย้อนหลังขนาดใหญ่ออกเป็นช่วงเวลาที่เล็กลงและต่อเนื่องกันภายในขีดจำกัดเหล่านี้
• จัดกลุ่มหรือจัดลำดับคำค้นหาย่อยเหล่านี้อย่างปลอดภัยเพื่อไม่ให้เกินขีดจำกัดการทำงานพร้อมกัน และรักษาตัวบ่งชี้ความคืบหน้าของ UI ให้คงที่

ใช้การสรุปข้อมูลที่รวมไว้ล่วงหน้า

ปรับโครงสร้างแดชบอร์ดภาพรวมและแผนภูมิแนวโน้มเพื่อใช้ปลายทางสรุปที่รวบรวมไว้ล่วงหน้า (เช่น DailyRollUpDataPoints) ซึ่งจะช่วยลดค่าใช้จ่ายในการคำนวณที่แบ็กเอนด์และเวลาในการโอนข้อมูลผ่านเครือข่ายไปยังไคลเอ็นต์ได้อย่างมาก

การจัดการข้อผิดพลาดที่ยืดหยุ่น (การลองใหม่ที่ชาญฉลาด)

• ใช้การจัดการ Exponential Backoff ที่เข้มงวดเมื่อพบขีดจำกัดอัตรา (429 Too Many Requests) และระยะหมดเวลาของเกตเวย์เซิร์ฟเวอร์ (504 Gateway Timeout) อย่าลองส่งเพย์โหลดขนาดใหญ่ที่ล้มเหลวซ้ำทันที การลองใหม่ทันทีจะเพิ่มความหนาแน่นของแบ็กเอนด์และทำให้ระบบเสื่อมประสิทธิภาพมากขึ้น

คำเตือน: การไม่ปฏิบัติตามหลักเกณฑ์เหล่านี้อาจทำให้เกิด พฤติกรรมและข้อผิดพลาดที่ไม่คาดคิด

สิทธิ์เข้าถึงของบุคคลที่สาม

อุปกรณ์ Fitbit สื่อสารกับแอปพลิเคชันหรือบริการของบุคคลที่สามโดยตรงไม่ได้ อุปกรณ์เหล่านี้ออกแบบมาเพื่อสื่อสารและซิงค์กับแอป Fitbit บนมือถือโดยเฉพาะ

อุปกรณ์จะซิงค์ข้อมูลโดยอัตโนมัติตลอดทั้งวันเมื่อใดก็ตามที่แอป Fitbit เปิดอยู่ หรือทุกๆ 15 นาทีหากบลูทูธเปิดอยู่และแอปทำงานใน พื้นหลัง เมื่อกระบวนการซิงค์นี้เสร็จสมบูรณ์แล้ว ข้อมูลจะพร้อมใช้งานสำหรับบริการของบุคคลที่สามผ่าน Google Health API

มาตรฐานระยะทาง

ระยะทางของการออกกำลังกาย เช่น elevationGainMillimeters จะวัดเป็นมิลลิเมตรซึ่งเป็นหน่วยมาตรฐานด้วยเหตุผลต่อไปนี้

1. รักษาความแม่นยำของข้อมูล: เหตุผลที่สำคัญที่สุดในการใช้มิลลิเมตรคือเพื่อให้มั่นใจว่าเราจะไม่สูญเสียความแม่นยำในข้อมูลที่เราอ่านและให้ การใช้หน่วยที่ละเอียด เช่น มิลลิเมตร ช่วยให้เรา แสดงการวัดได้อย่างแม่นยำ
2. การกำหนดให้เป็นมาตรฐาน: มิลลิเมตรเป็นหน่วยมาตรฐานที่ออกแบบมา ในบริการของเรา ความสอดคล้องนี้ช่วยให้มั่นใจได้ว่านักพัฒนาแอปจะได้รับประสบการณ์การใช้งานที่สม่ำเสมอ เมื่อโต้ตอบกับ API ส่วนต่างๆ
3. การรองรับระบบการวัดที่หลากหลาย: การใช้หน่วยฐาน เช่น มิลลิเมตร ช่วยให้ผู้พัฒนาแปลงเป็นหน่วยอื่นๆ ที่เลือกได้โดยตรง ไม่ว่าจะเป็นระบบเมตริก อิมพิเรียล หรือระบบการวัดอื่นๆ

ความยาวของวันไม่เท่ากัน

การจัดการเวลาโดย Health API จะจัดลำดับความสำคัญของเวลาของผู้ใช้เพื่อพิจารณา ความยาวของวันที่ที่เปลี่ยนแปลงได้ซึ่งเกิดจากเวลาออมแสงหรือการเดินทาง ระบบจะจัดเก็บจุดข้อมูลทุกจุดพร้อมทั้งการประทับเวลา UTC จริงและการชดเชย UTC ที่ใช้งานอยู่ ณ เวลาที่เกิดเหตุการณ์ ซึ่งจะช่วยให้ระบบทำสิ่งต่อไปนี้ได้

• แมปเหตุการณ์กับช่วงเวลาที่แน่นอนในโลกจริง
• แก้ไขเวลาให้ตรงกับบริบทท้องถิ่นของผู้ใช้สำหรับการรวบรวม

เวลาออมแสง

เมื่อถึงช่วงเวลาออมแสง การ "ย้อนกลับ" จะส่งผลให้วันตามปฏิทินมี 25 ชั่วโมง และข้อมูลรวมของวันที่ดังกล่าวจะมีข้อมูล 25 ชั่วโมง "การเปลี่ยนเวลา ฤดูร้อน" จะส่งผลให้วันตามกฎหมายมี 23 ชั่วโมง โดยเวลาจะเปลี่ยนกลับเป็นเวลา มาตรฐาน

ท่องเที่ยว

การเดินทางข้ามเขตเวลาอาจทำให้ระยะเวลาจริงของวันหนึ่งๆ แตกต่างกันมากยิ่งขึ้น

ใช้ปลายทาง dailyRollUp เพื่อปรับความแตกต่างของเขตเวลา ระบบจะระบุแหล่งที่มาของข้อมูลโดยอัตโนมัติเป็นวันในปฏิทินที่มีการบันทึกข้อมูล ตามเวลาท้องถิ่นของผู้ใช้ ซึ่งเป็นการ "เชื่อม" วันเข้าด้วยกัน แม้ว่าจะมีการเปลี่ยนเขตเวลาก็ตาม