ประเภทข้อมูลแคลอรีและพลังงาน

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

ทำความเข้าใจความแตกต่างระหว่างประเภทข้อมูลเหล่านี้เพื่อกำหนดว่าเมตริกใดเหมาะกับแอปพลิเคชันของคุณ

ประเภทข้อมูลที่รองรับ

API รองรับประเภทข้อมูลต่อไปนี้สำหรับการวัดแคลอรีและการใช้พลังงาน

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

ประเภทข้อมูล   dataType   filter พารามิเตอร์	ประเภทบันทึก	การดำเนินการที่ใช้ได้	ขอบเขต	การรองรับWebhook	การรองรับค่าศูนย์จริง
พลังงานที่ใช้ไปขณะเคลื่อนไหวร่างกาย   active-energy-burned   active_energy_burned	ช่วงการฝึก	list, reconcile, rollup, dailyRollup	activity_and_fitness
พลังงานพื้นฐานที่ใช้ไป   basal-energy-burned   basal_energy_burned	ช่วงการฝึก	list, reconcile	activity_and_fitness
อัตราการเผาผลาญขณะพัก   basal-metabolic-rate   basal_metabolic_rate	ตัวอย่าง	list, reconcile	nutrition

ส่วนต่อไปนี้จะให้รายละเอียดทางเทคนิคสำหรับข้อมูลแต่ละประเภท รวมถึงตัวอย่างการแสดง REST และข้อจำกัดในการผสานรวมที่เฉพาะเจาะจง

แคลอรีทั้งหมด

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

หมายเหตุ: การค้นหาประเภทข้อมูล total-calories ต้องมีตัวกรองช่วงเวลา (เช่น total_calories.interval.start_time หรือ total_calories.interval.civil_start_time) ช่วงสูงสุดสำหรับการค้นหาเหล่านี้คือ 14 วัน

ตัวอย่างการค้นหา

หากต้องการค้นหาประเภทข้อมูล total-calories ให้ส่งคำขอไปยังปลายทาง list พร้อมตัวกรองช่วงเวลา

ส่งคำขอ

GET https://health.googleapis.com/v4/users/me/dataTypes/total-calories/dataPoints?filter=total_calories.interval.start_time >= "2026-04-20T00:00:00Z" AND total_calories.interval.start_time < "2026-04-21T00:00:00Z"
Authorization: Bearer access-token
Accept: application/json

พลังงานที่ใช้ไปขณะเคลื่อนไหวร่างกาย

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

ตัวอย่างการแสดง REST

{
  "startTime": "2026-04-20T08:00:00Z",
  "startUtcOffset": "0s",
  "endTime": "2026-04-20T08:30:00Z",
  "endUtcOffset": "0s",
  "dataSource": { ... },
  "kcal": 150.0
}

พลังงานพื้นฐานที่ใช้ไป

พลังงานพื้นฐานที่ใช้ไปแสดงถึงแคลอรีที่ใช้ไปเนื่องจากการเผาผลาญขณะพักของผู้ใช้ในช่วงเวลาต่างๆ ซึ่งวัดเป็นกิโลแคลอรี (kcal)

หมายเหตุ: การดำเนินการ Rollup และ Daily Rollup ไม่พร้อมใช้งานสำหรับข้อมูลประเภทนี้ หากต้องการรับค่าพลังงานพื้นฐานรายวัน ให้ใช้ประเภทข้อมูลอัตราการเผาผลาญขณะพัก

อัตราการเผาผลาญขณะพัก

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

นักพัฒนาแอปสามารถถือว่าฟิลด์ rateKcalPerDay ในตัวอย่าง basal-metabolic-rate เป็นค่าที่เทียบเท่ารายวันของพลังงานที่ใช้ไปแบบรายวัน

ตัวอย่างการแสดง REST

{
  "date": {
    "year": 2026,
    "month": 4,
    "day": 20
  },
  "dataSource": { ... },
  "rateKcalPerDay": 1650.0
}

หลักเกณฑ์

เมื่อผสานรวมเมตริกแคลอรีและพลังงานในแอป ให้ใช้หลักเกณฑ์ต่อไปนี้

• ภาพรวมรายวัน: หากต้องการแสดงการใช้แคลอรีทั้งหมดในแต่ละวัน ให้ขอ Daily Rollup ของประเภทข้อมูล total-calories
• การใช้พลังงานเฉพาะกิจกรรม: หากต้องการติดตามแคลอรีที่ใช้ไประหว่างการออกกำลังกายที่เฉพาะเจาะจงหรือตลอดทั้งวัน โดยไม่รวมอัตราการเผาผลาญขณะพัก ให้ค้นหา active-energy-burned
• เมตริกพื้นฐาน: หากต้องการติดตามอัตราการเผาผลาญขณะพักหรือแนวโน้มการเผาผลาญพื้นฐาน ให้ค้นหา basal-metabolic-rate เพื่อดูค่า BMR ถือว่าตัวอย่าง BMR เป็นเกณฑ์พื้นฐานรายวันสำหรับการใช้พลังงานขณะพักของผู้ใช้